react-iiif-vault 0.9.15 → 0.9.16

package/dist/canvas-panel/esm/canvas-panel.mjs

@@ -31,11 +31,12 @@ var __objRest = (source, exclude) => {
 };
 import * as React from "react";
 import React__default, { useContext, useMemo, useState, useEffect, createContext, useRef, useLayoutEffect, useCallback, Fragment, useReducer } from "react";
-import { AtlasAuto, mergeStyles, RegionHighlight, TileSet } from "@atlas-viewer/atlas";
+import { AtlasAuto, mergeStyles, RegionHighlight, TileSet, HTMLPortal } from "@atlas-viewer/atlas";
 import { jsx, jsxs, Fragment as Fragment$1 } from "react/jsx-runtime";
 import { globalVault, Vault } from "@iiif/vault";
 import { createAction } from "typesafe-actions";
-import require$$0 from "react-dom";
+import { createRoot } from "react-dom/client";
+import { expandTarget as expandTarget$1 } from "@iiif/vault-helpers";
 import { ImageServiceLoader, getImageServices, getFixedSizeFromImage } from "@atlas-viewer/iiif-image-api";
 function _setPrototypeOf(o, p) {
   _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf2(o2, p2) {
@@ -220,6 +221,22 @@ function useVisibleCanvases() {
     return ids.map((id) => state.iiif.entities.Canvas[id]).filter(Boolean);
   }, [ids]);
 }
+function useManifest(options = {}, deps = []) {
+  const { id, selector } = options;
+  const ctx = useResourceContext();
+  useVault();
+  const manifestId = id ? id : ctx.manifest;
+  const manifest = useVaultSelector((s) => manifestId ? s.iiif.entities.Manifest[manifestId] : void 0, [manifestId]);
+  return useMemo(() => {
+    if (!manifest) {
+      return void 0;
+    }
+    if (selector) {
+      return selector(manifest);
+    }
+    return manifest;
+  }, [manifest, selector, ...deps]);
+}
 const noop = () => {
 };
 const SimpleViewerReactContext = createContext({
@@ -227,9 +244,10 @@ const SimpleViewerReactContext = createContext({
   setCurrentCanvasIndex: noop,
   nextCanvas: noop,
   previousCanvas: noop,
-  currentCanvasIndex: -1,
-  totalCanvases: 0,
-  pagingView: true
+  items: [],
+  sequence: [],
+  setSequenceIndex: noop,
+  currentSequenceIndex: 0
 });
 function useContextBridge() {
   return {
@@ -435,11 +453,6 @@ function DefaultCanvasFallback({
     children: "Unknown error"
   });
 }
-var createRoot;
-var m = require$$0;
-{
-  createRoot = m.createRoot;
-}
 const ViewerPresetContext = createContext(null);
 function useViewerPreset() {
   return useContext(ViewerPresetContext);
@@ -451,26 +464,16 @@ function CanvasPortal({
   overlay
 }) {
   const htmlElement = useContext(overlay ? OverlayPortalContext : PortalContext);
-  const rootRef = useRef(null);
   const preset = useViewerPreset();
   useLayoutEffect(() => {
-    if (!rootRef.current) {
-      rootRef.current = htmlElement ? createRoot(htmlElement) : null;
-    }
-  }, []);
-  useLayoutEffect(() => {
-    return () => {
-      var _a;
-      (_a = rootRef.current) == null ? void 0 : _a.unmount();
-      rootRef.current = null;
-    };
-  }, []);
-  useLayoutEffect(() => {
-    if (rootRef.current) {
-      rootRef.current.render(/* @__PURE__ */ jsx(ViewerPresetContext.Provider, {
-        value: preset,
-        children
-      }));
+    if (htmlElement) {
+      try {
+        htmlElement.render(/* @__PURE__ */ jsx(ViewerPresetContext.Provider, {
+          value: preset,
+          children
+        }));
+      } catch (e) {
+      }
     }
   }, [children, preset]);
   return null;
@@ -493,8 +496,31 @@ function Viewer(_a) {
   const bridge = useContextBridge();
   const ErrorFallback = errorFallback || DefaultCanvasFallback;
   useLayoutEffect(() => {
-    setPortalElement(portal.current);
-    setOverlayPortalElement(overlayPortal.current);
+    const roots = {};
+    if (portal.current) {
+      const $el = document.createElement("div");
+      portal.current.appendChild($el);
+      roots.portal = createRoot($el);
+      setPortalElement(roots.portal);
+    }
+    if (overlayPortal.current) {
+      const $el = document.createElement("div");
+      overlayPortal.current.appendChild($el);
+      roots.overlayPortal = createRoot($el);
+      setOverlayPortalElement(roots.overlayPortal);
+    }
+    return () => {
+      setPortalElement(null);
+      setOverlayPortalElement(null);
+      setTimeout(() => {
+        if (roots.portal) {
+          roots.portal.unmount();
+        }
+        if (roots.overlayPortal) {
+          roots.overlayPortal.unmount();
+        }
+      }, 0);
+    };
   }, []);
   return /* @__PURE__ */ jsxs(ErrorBoundary, {
     fallbackRender: () => /* @__PURE__ */ jsx(ErrorFallback, __spreadValues({}, props)),
@@ -617,25 +643,25 @@ function useStyles(resource, scope) {
     return styles ? scope ? styles[scope] : styles : void 0;
   }, [resource, scope]);
 }
-var __defProp2 = Object.defineProperty;
-var __defProps2 = Object.defineProperties;
-var __getOwnPropDescs2 = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols2 = Object.getOwnPropertySymbols;
-var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-var __propIsEnum2 = Object.prototype.propertyIsEnumerable;
-var __defNormalProp2 = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues2 = (a, b) => {
+var __defProp$1 = Object.defineProperty;
+var __defProps$1 = Object.defineProperties;
+var __getOwnPropDescs$1 = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols$1 = Object.getOwnPropertySymbols;
+var __hasOwnProp$1 = Object.prototype.hasOwnProperty;
+var __propIsEnum$1 = Object.prototype.propertyIsEnumerable;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues$1 = (a, b) => {
   for (var prop in b || (b = {}))
-    if (__hasOwnProp2.call(b, prop))
-      __defNormalProp2(a, prop, b[prop]);
-  if (__getOwnPropSymbols2)
-    for (var prop of __getOwnPropSymbols2(b)) {
-      if (__propIsEnum2.call(b, prop))
-        __defNormalProp2(a, prop, b[prop]);
+    if (__hasOwnProp$1.call(b, prop))
+      __defNormalProp$1(a, prop, b[prop]);
+  if (__getOwnPropSymbols$1)
+    for (var prop of __getOwnPropSymbols$1(b)) {
+      if (__propIsEnum$1.call(b, prop))
+        __defNormalProp$1(a, prop, b[prop]);
     }
   return a;
 };
-var __spreadProps2 = (a, b) => __defProps2(a, __getOwnPropDescs2(b));
+var __spreadProps$1 = (a, b) => __defProps$1(a, __getOwnPropDescs$1(b));
 const BOX_SELECTOR = /&?(xywh=)?(pixel:|percent:|pct:)?([0-9]+(?:\.[0-9]+)?),([0-9]+(?:\.[0-9]+)?),([0-9]+(?:\.[0-9]+)?),([0-9]+(?:\.[0-9]+)?)/;
 const TEMPORAL_SELECTOR = /&?(t=)(npt:)?([0-9]+(.[0-9]+)?)?(,([0-9]+(.[0-9]+)?))?/;
 function parseSelector(source) {
@@ -780,7 +806,7 @@ function expandTarget(target, options = {}) {
     if (!fragment) {
       return {
         type: "SpecificResource",
-        source: __spreadProps2(__spreadValues2({}, target), {
+        source: __spreadProps$1(__spreadValues$1({}, target), {
           id
         }),
         selector: null,
@@ -789,7 +815,7 @@ function expandTarget(target, options = {}) {
     }
     return expandTarget({
       type: "SpecificResource",
-      source: __spreadProps2(__spreadValues2({}, target), {
+      source: __spreadProps$1(__spreadValues$1({}, target), {
         id
       }),
       selector: {
@@ -898,20 +924,21 @@ function RenderImage({
   isStatic,
   x = 0,
   y = 0,
-  annotations,
-  children
+  children,
+  onClick
 }) {
   var _a, _b, _c, _d;
   return /* @__PURE__ */ jsx(Fragment, {
     children: !image.service ? /* @__PURE__ */ jsxs(Fragment, {
       children: [/* @__PURE__ */ jsx("world-image", {
+        onClick,
         uri: image.id,
         target: image.target.spatial,
         display: image.width && image.height ? {
           width: image.width,
           height: image.height
         } : void 0
-      }), annotations, children]
+      }), children]
     }, "no-service") : /* @__PURE__ */ jsxs(Fragment, {
       children: [/* @__PURE__ */ jsx(TileSet, {
         tiles: {
@@ -924,8 +951,9 @@ function RenderImage({
         x: ((_a = image.target) == null ? void 0 : _a.spatial.x) + x,
         y: ((_b = image.target) == null ? void 0 : _b.spatial.y) + y,
         width: (_c = image.target) == null ? void 0 : _c.spatial.width,
-        height: (_d = image.target) == null ? void 0 : _d.spatial.height
-      }), annotations, children]
+        height: (_d = image.target) == null ? void 0 : _d.spatial.height,
+        onClick
+      }), children]
     }, "service")
   }, id);
 }
@@ -966,6 +994,7 @@ function getPaintables(vault, paintingAnnotations, enabledChoices) {
         types.push(type);
       }
       items.push({
+        annotationId: annotation.id,
         type,
         resource: body,
         target: annotation.target,
@@ -979,6 +1008,29 @@ function getPaintables(vault, paintingAnnotations, enabledChoices) {
     choice
   };
 }
+function getParsedTargetSelector(canvas, target) {
+  const { selector: imageTarget, source } = expandTarget$1(target);
+  if (source.id !== canvas.id) {
+    return [null, source];
+  }
+  const defaultTarget = {
+    type: "BoxSelector",
+    spatial: {
+      x: 0,
+      y: 0,
+      width: canvas.width,
+      height: canvas.height
+    }
+  };
+  return [
+    imageTarget ? imageTarget.type === "TemporalSelector" ? {
+      type: "TemporalBoxSelector",
+      temporal: imageTarget.temporal,
+      spatial: defaultTarget.spatial
+    } : imageTarget : null,
+    source
+  ];
+}
 const emptyActions = {
   makeChoice: () => {
   }
@@ -987,22 +1039,9 @@ const unknownResponse = { type: "unknown" };
 const unsupportedStrategy = (reason) => {
   return { type: "unknown", reason, annotations: { pages: [] } };
 };
-function useManifest(options = {}, deps = []) {
-  const { id, selector } = options;
-  const ctx = useResourceContext();
-  useVault();
-  const manifestId = id ? id : ctx.manifest;
-  const manifest = useVaultSelector((s) => manifestId ? s.iiif.entities.Manifest[manifestId] : void 0, [manifestId]);
-  return useMemo(() => {
-    if (!manifest) {
-      return void 0;
-    }
-    if (selector) {
-      return selector(manifest);
-    }
-    return manifest;
-  }, [manifest, selector, ...deps]);
-}
+const emptyStrategy = (width, height) => {
+  return { type: "empty", width, height, annotations: { pages: [] }, image: null, images: [] };
+};
 function getMeta$1(state, resourceId) {
   var _a;
   const resourceMeta = (_a = state == null ? void 0 : state.iiif) == null ? void 0 : _a.meta[resourceId];
@@ -1256,10 +1295,6 @@ function getImageStrategy(canvas, paintables, loadImageService) {
         imageService = loadImageService(imageServices[0], canvas);
       }
     }
-    const { selector: imageTarget, source } = expandTarget(singleImage.target);
-    if (source.id !== canvas.id) {
-      continue;
-    }
     const defaultTarget = {
       type: "BoxSelector",
       spatial: {
@@ -1269,11 +1304,10 @@ function getImageStrategy(canvas, paintables, loadImageService) {
         height: canvas.height
       }
     };
-    const target = imageTarget ? imageTarget.type === "TemporalSelector" ? {
-      type: "TemporalBoxSelector",
-      temporal: imageTarget.temporal,
-      spatial: defaultTarget.spatial
-    } : imageTarget : null;
+    const [target, source] = getParsedTargetSelector(canvas, singleImage.target);
+    if (source.id !== canvas.id) {
+      continue;
+    }
     const defaultImageSelector = {
       type: "BoxSelector",
       spatial: {
@@ -1299,6 +1333,7 @@ function getImageStrategy(canvas, paintables, loadImageService) {
     const imageType = {
       id: resource.id,
       type: "Image",
+      annotationId: singleImage.annotationId,
       width: target ? resource.width : canvas.width,
       height: target ? resource.height : canvas.height,
       service: imageService,
@@ -1348,6 +1383,7 @@ function getAudioStrategy(canvas, paintables) {
   return {
     type: "media",
     media: {
+      annotationId: paintables.items[0].annotationId,
       duration: canvas.duration,
       url: audioResource.id,
       type: "Sound",
@@ -1391,6 +1427,7 @@ function getVideoStrategy(canvas, paintables) {
   return {
     type: "media",
     media: {
+      annotationId: paintables.items[0].annotationId,
       duration: canvas.duration,
       url: audioResource.id,
       type: "Video",
@@ -1416,6 +1453,38 @@ function getVideoStrategy(canvas, paintables) {
     }
   };
 }
+function parseType(item, languageMap = {}, lang) {
+  const language = item.language || lang || "none";
+  switch (item.type) {
+    case "TextualBody": {
+      if (typeof item.value !== "undefined") {
+        languageMap[language] = item.value;
+      }
+      break;
+    }
+    case "List":
+    case "Composite":
+    case "Choice": {
+      if (item.items) {
+        item.items.forEach((inner) => parseType(inner, languageMap, language));
+      }
+    }
+  }
+  return languageMap;
+}
+function getTextualContentStrategy(canvas, paintables) {
+  const items = [];
+  paintables.items.forEach((item) => {
+    if (item.resource) {
+      const [target] = getParsedTargetSelector(canvas, item.target);
+      items.push({ annotationId: item.annotationId, text: parseType(item.resource), target });
+    }
+  });
+  return {
+    type: "textual-content",
+    items
+  };
+}
 function useRenderingStrategy(options) {
   const manifest = useManifest();
   const canvas = useCanvas();
@@ -1425,10 +1494,22 @@ function useRenderingStrategy(options) {
     all: false
   });
   const enabledPages = useResources(enabledPageIds, "AnnotationPage");
-  const supports = (options == null ? void 0 : options.strategies) || ["images", "media", "complex-timeline"];
+  const supports = (options == null ? void 0 : options.strategies) || [
+    "empty",
+    "images",
+    "media",
+    "textual-content",
+    "complex-timeline"
+  ];
   const [paintables, actions] = usePaintables(options, [imageServiceStatus]);
   const strategy = useMemo(() => {
-    if (!canvas || paintables.types.length === 0) {
+    if (!canvas) {
+      return unknownResponse;
+    }
+    if (paintables.types.length === 0) {
+      if (supports.indexOf("empty") !== -1) {
+        return emptyStrategy(canvas.width, canvas.height);
+      }
       return unknownResponse;
     }
     if (paintables.types.length !== 1) {
@@ -1454,6 +1535,12 @@ function useRenderingStrategy(options) {
       }
       return get3dStrategy(canvas, paintables);
     }
+    if (mainType === "textualbody") {
+      if (supports.indexOf("textual-content") === -1) {
+        return unsupportedStrategy("Textual content not supported");
+      }
+      return getTextualContentStrategy(canvas, paintables);
+    }
     if (mainType === "sound" || mainType === "audio") {
       if (supports.indexOf("media") === -1) {
         return unsupportedStrategy("Media not supported");
@@ -1573,6 +1660,7 @@ function useThumbnail(request, dereference, { canvasId, manifestId } = {}) {
   const subject = canvas ? canvas : manifest;
   const didUnmount = useRef(false);
   useEffect(() => {
+    didUnmount.current = false;
     return () => {
       didUnmount.current = true;
     };
@@ -1872,6 +1960,533 @@ function Model({
     })]
   });
 }
+function CanvasBackground({
+  style
+}) {
+  const canvas = useCanvas();
+  if (!canvas || !canvas.height || !canvas.width) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx("box", {
+    interactive: false,
+    target: {
+      x: 0,
+      y: 0,
+      width: canvas.width,
+      height: canvas.height
+    },
+    style
+  });
+}
+var __defProp2 = Object.defineProperty;
+var __defProps2 = Object.defineProperties;
+var __getOwnPropDescs2 = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols2 = Object.getOwnPropertySymbols;
+var __hasOwnProp2 = Object.prototype.hasOwnProperty;
+var __propIsEnum2 = Object.prototype.propertyIsEnumerable;
+var __defNormalProp2 = (obj, key, value) => key in obj ? __defProp2(obj, key, {
+  enumerable: true,
+  configurable: true,
+  writable: true,
+  value
+}) : obj[key] = value;
+var __spreadValues2 = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp2.call(b, prop))
+      __defNormalProp2(a, prop, b[prop]);
+  if (__getOwnPropSymbols2)
+    for (var prop of __getOwnPropSymbols2(b)) {
+      if (__propIsEnum2.call(b, prop))
+        __defNormalProp2(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps2 = (a, b) => __defProps2(a, __getOwnPropDescs2(b));
+var __objRest2 = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp2.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols2)
+    for (var prop of __getOwnPropSymbols2(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum2.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+function _defineProperty(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+function _classCallCheck(instance, Constructor) {
+  if (!(instance instanceof Constructor)) {
+    throw new TypeError("Cannot call a class as a function");
+  }
+}
+function _defineProperties(target, props) {
+  for (var i = 0; i < props.length; i++) {
+    var descriptor = props[i];
+    descriptor.enumerable = descriptor.enumerable || false;
+    descriptor.configurable = true;
+    if ("value" in descriptor)
+      descriptor.writable = true;
+    Object.defineProperty(target, descriptor.key, descriptor);
+  }
+}
+function _createClass(Constructor, protoProps, staticProps) {
+  if (protoProps)
+    _defineProperties(Constructor.prototype, protoProps);
+  if (staticProps)
+    _defineProperties(Constructor, staticProps);
+  Object.defineProperty(Constructor, "prototype", {
+    writable: false
+  });
+  return Constructor;
+}
+var defaultOptions = {
+  bindI18n: "languageChanged",
+  bindI18nStore: "",
+  transEmptyNodeValue: "",
+  transSupportBasicHtmlNodes: true,
+  transWrapTextNodes: "",
+  transKeepBasicHtmlNodesFor: ["br", "strong", "i", "p"],
+  useSuspense: true
+};
+var i18nInstance;
+var I18nContext = React__default.createContext();
+function getDefaults() {
+  return defaultOptions;
+}
+var ReportNamespaces = function() {
+  function ReportNamespaces2() {
+    _classCallCheck(this, ReportNamespaces2);
+    this.usedNamespaces = {};
+  }
+  _createClass(ReportNamespaces2, [{
+    key: "addUsedNamespaces",
+    value: function addUsedNamespaces(namespaces) {
+      var _this = this;
+      namespaces.forEach(function(ns) {
+        if (!_this.usedNamespaces[ns])
+          _this.usedNamespaces[ns] = true;
+      });
+    }
+  }, {
+    key: "getUsedNamespaces",
+    value: function getUsedNamespaces() {
+      return Object.keys(this.usedNamespaces);
+    }
+  }]);
+  return ReportNamespaces2;
+}();
+function getI18n() {
+  return i18nInstance;
+}
+function warn() {
+  if (console && console.warn) {
+    var _console;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    if (typeof args[0] === "string")
+      args[0] = "react-i18next:: ".concat(args[0]);
+    (_console = console).warn.apply(_console, args);
+  }
+}
+var alreadyWarned = {};
+function warnOnce() {
+  for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+    args[_key2] = arguments[_key2];
+  }
+  if (typeof args[0] === "string" && alreadyWarned[args[0]])
+    return;
+  if (typeof args[0] === "string")
+    alreadyWarned[args[0]] = new Date();
+  warn.apply(void 0, args);
+}
+function loadNamespaces(i18n, ns, cb) {
+  i18n.loadNamespaces(ns, function() {
+    if (i18n.isInitialized) {
+      cb();
+    } else {
+      var initialized = function initialized2() {
+        setTimeout(function() {
+          i18n.off("initialized", initialized2);
+        }, 0);
+        cb();
+      };
+      i18n.on("initialized", initialized);
+    }
+  });
+}
+function hasLoadedNamespace(ns, i18n) {
+  var options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+  if (!i18n.languages || !i18n.languages.length) {
+    warnOnce("i18n.languages were undefined or empty", i18n.languages);
+    return true;
+  }
+  var lng = i18n.languages[0];
+  var fallbackLng = i18n.options ? i18n.options.fallbackLng : false;
+  var lastLng = i18n.languages[i18n.languages.length - 1];
+  if (lng.toLowerCase() === "cimode")
+    return true;
+  var loadNotPending = function loadNotPending2(l, n) {
+    var loadState = i18n.services.backendConnector.state["".concat(l, "|").concat(n)];
+    return loadState === -1 || loadState === 2;
+  };
+  if (options.bindI18n && options.bindI18n.indexOf("languageChanging") > -1 && i18n.services.backendConnector.backend && i18n.isLanguageChangingTo && !loadNotPending(i18n.isLanguageChangingTo, ns))
+    return false;
+  if (i18n.hasResourceBundle(lng, ns))
+    return true;
+  if (!i18n.services.backendConnector.backend)
+    return true;
+  if (loadNotPending(lng, ns) && (!fallbackLng || loadNotPending(lastLng, ns)))
+    return true;
+  return false;
+}
+function _arrayWithHoles(arr) {
+  if (Array.isArray(arr))
+    return arr;
+}
+function _iterableToArrayLimit(arr, i) {
+  var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+  if (_i == null)
+    return;
+  var _arr = [];
+  var _n = true;
+  var _d = false;
+  var _s, _e;
+  try {
+    for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) {
+      _arr.push(_s.value);
+      if (i && _arr.length === i)
+        break;
+    }
+  } catch (err) {
+    _d = true;
+    _e = err;
+  } finally {
+    try {
+      if (!_n && _i["return"] != null)
+        _i["return"]();
+    } finally {
+      if (_d)
+        throw _e;
+    }
+  }
+  return _arr;
+}
+function _arrayLikeToArray(arr, len) {
+  if (len == null || len > arr.length)
+    len = arr.length;
+  for (var i = 0, arr2 = new Array(len); i < len; i++) {
+    arr2[i] = arr[i];
+  }
+  return arr2;
+}
+function _unsupportedIterableToArray(o, minLen) {
+  if (!o)
+    return;
+  if (typeof o === "string")
+    return _arrayLikeToArray(o, minLen);
+  var n = Object.prototype.toString.call(o).slice(8, -1);
+  if (n === "Object" && o.constructor)
+    n = o.constructor.name;
+  if (n === "Map" || n === "Set")
+    return Array.from(o);
+  if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))
+    return _arrayLikeToArray(o, minLen);
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _slicedToArray(arr, i) {
+  return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
+}
+function ownKeys(object, enumerableOnly) {
+  var keys = Object.keys(object);
+  if (Object.getOwnPropertySymbols) {
+    var symbols = Object.getOwnPropertySymbols(object);
+    if (enumerableOnly) {
+      symbols = symbols.filter(function(sym) {
+        return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+      });
+    }
+    keys.push.apply(keys, symbols);
+  }
+  return keys;
+}
+function _objectSpread(target) {
+  for (var i = 1; i < arguments.length; i++) {
+    var source = arguments[i] != null ? arguments[i] : {};
+    if (i % 2) {
+      ownKeys(Object(source), true).forEach(function(key) {
+        _defineProperty(target, key, source[key]);
+      });
+    } else if (Object.getOwnPropertyDescriptors) {
+      Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+      ownKeys(Object(source)).forEach(function(key) {
+        Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+      });
+    }
+  }
+  return target;
+}
+function useTranslation(ns) {
+  var props = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+  var i18nFromProps = props.i18n;
+  var _ref = useContext(I18nContext) || {}, i18nFromContext = _ref.i18n, defaultNSFromContext = _ref.defaultNS;
+  var i18n = i18nFromProps || i18nFromContext || getI18n();
+  if (i18n && !i18n.reportNamespaces)
+    i18n.reportNamespaces = new ReportNamespaces();
+  if (!i18n) {
+    warnOnce("You will need to pass in an i18next instance by using initReactI18next");
+    var notReadyT = function notReadyT2(k) {
+      return Array.isArray(k) ? k[k.length - 1] : k;
+    };
+    var retNotReady = [notReadyT, {}, false];
+    retNotReady.t = notReadyT;
+    retNotReady.i18n = {};
+    retNotReady.ready = false;
+    return retNotReady;
+  }
+  if (i18n.options.react && i18n.options.react.wait !== void 0)
+    warnOnce("It seems you are still using the old wait option, you may migrate to the new useSuspense behaviour.");
+  var i18nOptions = _objectSpread(_objectSpread(_objectSpread({}, getDefaults()), i18n.options.react), props);
+  var useSuspense = i18nOptions.useSuspense, keyPrefix = i18nOptions.keyPrefix;
+  var namespaces = ns || defaultNSFromContext || i18n.options && i18n.options.defaultNS;
+  namespaces = typeof namespaces === "string" ? [namespaces] : namespaces || ["translation"];
+  if (i18n.reportNamespaces.addUsedNamespaces)
+    i18n.reportNamespaces.addUsedNamespaces(namespaces);
+  var ready = (i18n.isInitialized || i18n.initializedStoreOnce) && namespaces.every(function(n) {
+    return hasLoadedNamespace(n, i18n, i18nOptions);
+  });
+  function getT() {
+    return i18n.getFixedT(null, i18nOptions.nsMode === "fallback" ? namespaces : namespaces[0], keyPrefix);
+  }
+  var _useState = useState(getT), _useState2 = _slicedToArray(_useState, 2), t = _useState2[0], setT = _useState2[1];
+  var isMounted = useRef(true);
+  useEffect(function() {
+    var bindI18n = i18nOptions.bindI18n, bindI18nStore = i18nOptions.bindI18nStore;
+    isMounted.current = true;
+    if (!ready && !useSuspense) {
+      loadNamespaces(i18n, namespaces, function() {
+        if (isMounted.current)
+          setT(getT);
+      });
+    }
+    function boundReset() {
+      if (isMounted.current)
+        setT(getT);
+    }
+    if (bindI18n && i18n)
+      i18n.on(bindI18n, boundReset);
+    if (bindI18nStore && i18n)
+      i18n.store.on(bindI18nStore, boundReset);
+    return function() {
+      isMounted.current = false;
+      if (bindI18n && i18n)
+        bindI18n.split(" ").forEach(function(e) {
+          return i18n.off(e, boundReset);
+        });
+      if (bindI18nStore && i18n)
+        bindI18nStore.split(" ").forEach(function(e) {
+          return i18n.store.off(e, boundReset);
+        });
+    };
+  }, [i18n, namespaces.join()]);
+  var isInitial = useRef(true);
+  useEffect(function() {
+    if (isMounted.current && !isInitial.current) {
+      setT(getT);
+    }
+    isInitial.current = false;
+  }, [i18n]);
+  var ret = [t, i18n, ready];
+  ret.t = t;
+  ret.i18n = i18n;
+  ret.ready = ready;
+  if (ready)
+    return ret;
+  if (!ready && !useSuspense)
+    return ret;
+  throw new Promise(function(resolve) {
+    loadNamespaces(i18n, namespaces, function() {
+      resolve();
+    });
+  });
+}
+function LanguageString(_a) {
+  var _b = _a, {
+    as: Component,
+    language,
+    children
+  } = _b, props = __objRest2(_b, ["as", "language", "children"]);
+  const {
+    i18n
+  } = useTranslation();
+  const viewingDirection = useMemo(() => i18n.dir ? i18n.dir(language) : "ltr", [language]);
+  const isSame = useMemo(() => {
+    if (!i18n.services) {
+      return false;
+    }
+    return i18n.services.languageUtils.getLanguagePartFromCode(i18n.language) === i18n.services.languageUtils.getLanguagePartFromCode(language);
+  }, [i18n.language, language]);
+  if (isSame) {
+    if (Component) {
+      return /* @__PURE__ */ jsx(Component, __spreadProps(__spreadValues({}, __spreadValues2({}, props)), {
+        children
+      }));
+    }
+    return /* @__PURE__ */ jsx("span", __spreadProps(__spreadValues({}, __spreadValues2({}, props)), {
+      children
+    }));
+  }
+  if (Component) {
+    return /* @__PURE__ */ jsx(Component, __spreadProps(__spreadValues({}, __spreadProps2(__spreadValues2({}, props), {
+      lang: language,
+      dir: viewingDirection
+    })), {
+      children
+    }));
+  }
+  return /* @__PURE__ */ jsx("span", __spreadProps(__spreadValues({}, __spreadProps2(__spreadValues2({}, props), {
+    lang: language,
+    dir: viewingDirection
+  })), {
+    children
+  }));
+}
+function getClosestLanguage(i18nLanguage, languages, i18nLanguages = [], strictFallback = false) {
+  if (!i18nLanguage || !languages || languages.length === 0) {
+    return void 0;
+  }
+  if (languages.length === 1) {
+    return languages[0];
+  }
+  if (languages.indexOf(i18nLanguage) !== -1) {
+    return i18nLanguage;
+  }
+  const root = i18nLanguage.indexOf("-") !== -1 ? i18nLanguage.slice(0, i18nLanguage.indexOf("-")) : null;
+  if (root && languages.indexOf(root) !== -1) {
+    return root;
+  }
+  for (const lang of i18nLanguages) {
+    if (languages.indexOf(lang) !== -1) {
+      return lang;
+    }
+  }
+  if (!strictFallback) {
+    const inverseRoot = languages.map((l) => l.indexOf("-") !== -1 ? l.slice(0, l.indexOf("-")) : null);
+    const inverseIdx = inverseRoot.indexOf(i18nLanguage);
+    if (inverseIdx !== -1) {
+      return languages[inverseIdx];
+    }
+    for (const lang of i18nLanguages) {
+      const root2 = lang.indexOf("-") !== -1 ? lang.slice(0, lang.indexOf("-")) : null;
+      const inverseIdx2 = root2 ? languages.indexOf(root2) : -1;
+      if (inverseIdx2 !== -1) {
+        return languages[inverseIdx2];
+      }
+    }
+  }
+  if (languages.indexOf("none") !== -1) {
+    return "none";
+  }
+  if (languages.indexOf("@none") !== -1) {
+    return "@none";
+  }
+  return languages[0];
+}
+function buildLocaleString(inputText, i18nLanguage, options = {}) {
+  const {
+    strictFallback = false,
+    defaultText = "",
+    separator = "\n",
+    fallbackLanguages = [],
+    closest
+  } = options;
+  const languages = Object.keys(inputText || {});
+  const language = closest ? i18nLanguage : getClosestLanguage(i18nLanguage, languages, fallbackLanguages, strictFallback);
+  if (!inputText) {
+    return defaultText;
+  }
+  if (typeof inputText === "string") {
+    return inputText;
+  }
+  const candidateText = language ? inputText[language] : void 0;
+  if (candidateText) {
+    if (typeof candidateText === "string") {
+      return candidateText;
+    }
+    return candidateText.join(separator);
+  }
+  return "";
+}
+function useClosestLanguage(getLanguages, deps = []) {
+  const {
+    i18n
+  } = useTranslation();
+  const i18nLanguages = i18n && i18n.languages ? i18n.languages : [];
+  const i18nLanguage = i18n && i18n.language ? i18n.language : "en";
+  return useMemo(() => {
+    const languages = getLanguages();
+    return getClosestLanguage(i18nLanguage, languages, i18nLanguages);
+  }, [i18nLanguages, i18nLanguage, ...deps]);
+}
+function useLocaleString(inputText, defaultText) {
+  const language = useClosestLanguage(() => Object.keys(inputText || {}), [inputText]);
+  return [useMemo(() => {
+    return buildLocaleString(inputText, language, {
+      defaultText,
+      closest: true
+    });
+  }, [language, defaultText, inputText]), language];
+}
+const LocaleString = (_c) => {
+  var _d = _c, {
+    as: Component,
+    defaultText,
+    enableDangerouslySetInnerHTML,
+    children
+  } = _d, props = __objRest2(_d, ["as", "defaultText", "enableDangerouslySetInnerHTML", "children"]);
+  const [text, language] = useLocaleString(children, defaultText);
+  if (language) {
+    return /* @__PURE__ */ jsx(LanguageString, __spreadProps(__spreadValues({}, __spreadProps2(__spreadValues2({}, props), {
+      as: Component,
+      language,
+      title: enableDangerouslySetInnerHTML ? void 0 : text,
+      dangerouslySetInnerHTML: enableDangerouslySetInnerHTML ? {
+        __html: text
+      } : void 0
+    })), {
+      children: enableDangerouslySetInnerHTML ? void 0 : text
+    }));
+  }
+  if (Component) {
+    return /* @__PURE__ */ jsx(Component, __spreadProps(__spreadValues({}, __spreadValues2({}, props)), {
+      children: text
+    }));
+  }
+  return /* @__PURE__ */ jsx("span", __spreadProps(__spreadValues({}, __spreadProps2(__spreadValues2({}, props), {
+    title: enableDangerouslySetInnerHTML ? void 0 : text,
+    dangerouslySetInnerHTML: enableDangerouslySetInnerHTML ? {
+      __html: text
+    } : void 0
+  })), {
+    children: enableDangerouslySetInnerHTML ? void 0 : text
+  }));
+};
 function RenderCanvas({
   x,
   y,
@@ -1882,6 +2497,9 @@ function RenderCanvas({
   renderViewerControls,
   renderMediaControls,
   strategies,
+  backgroundStyle,
+  alwaysShowBackground,
+  onClickPaintingAnnotation,
   children
 }) {
   const canvas = useCanvas();
@@ -1968,19 +2586,35 @@ function RenderCanvas({
       x,
       y
     }, elementProps), {
-      children: [strategy.type === "images" ? /* @__PURE__ */ jsxs(Fragment$1, {
-        children: [strategy.images.map((image, idx) => {
-          return /* @__PURE__ */ jsx(RenderImage, {
-            isStatic,
-            image,
-            id: image.id,
-            thumbnail: idx === 0 ? thumbnail : void 0,
-            annotations
-          }, image.id);
-        }), renderViewerControls ? /* @__PURE__ */ jsx(CanvasPortal, {
-          overlay: true,
-          children: renderViewerControls(strategy)
-        }) : null]
+      children: [strategy.type === "empty" || alwaysShowBackground ? /* @__PURE__ */ jsx(CanvasBackground, {
+        style: backgroundStyle
+      }) : null, strategy.type === "textual-content" ? strategy.items.map((item, n) => {
+        return /* @__PURE__ */ jsxs(Fragment$1, {
+          children: [/* @__PURE__ */ jsx(HTMLPortal, {
+            onClick: onClickPaintingAnnotation ? (e) => {
+              e.stopPropagation();
+              onClickPaintingAnnotation(item.annotationId, item, e);
+            } : void 0,
+            target: item.target.spatial || void 0,
+            children: /* @__PURE__ */ jsx(LocaleString, {
+              children: item.text
+            })
+          }, n), annotations]
+        });
+      }) : null, strategy.type === "images" ? /* @__PURE__ */ jsxs(Fragment$1, {
+        children: [strategy.images.map((image, idx) => /* @__PURE__ */ jsx(RenderImage, {
+          isStatic,
+          image,
+          id: image.id,
+          thumbnail: idx === 0 ? thumbnail : void 0,
+          onClick: onClickPaintingAnnotation ? (e) => {
+            e.stopPropagation();
+            onClickPaintingAnnotation(image.annotationId, image, e);
+          } : void 0
+        }, image.id)), annotations]
+      }) : null, (strategy.type === "images" || strategy.type === "empty" || strategy.type === "textual-content") && renderViewerControls ? /* @__PURE__ */ jsx(CanvasPortal, {
+        overlay: true,
+        children: renderViewerControls(strategy)
       }) : null, strategy.type === "3d-model" ? /* @__PURE__ */ jsx(Model, {
         model: strategy.model
       }) : null, strategy.type === "media" ? /* @__PURE__ */ jsx(Fragment$1, {
@@ -1992,7 +2626,7 @@ function RenderCanvas({
           children: [thumbnailFallbackImage, renderMediaControls ? renderMediaControls(strategy) : null]
         }) : null
       }) : null]
-    }), strategy.type), strategy.type === "media" && strategy.media.type === "Sound" && accompanyingCanvas ? /* @__PURE__ */ jsx(CanvasContext, {
+    }), `${canvas.id}/${strategy.type}`), strategy.type === "media" && strategy.media.type === "Sound" && accompanyingCanvas ? /* @__PURE__ */ jsx(CanvasContext, {
       canvas: accompanyingCanvas.id,
       children: /* @__PURE__ */ jsx(RenderCanvas, {
         renderViewerControls
@@ -2005,7 +2639,8 @@ const CanvasPanel = {
   RenderCanvas,
   RenderAnnotationPage,
   RenderAnnotation,
-  Viewer
+  Viewer,
+  CanvasBackground
 };
 export { CanvasPanel };
 //# sourceMappingURL=canvas-panel.mjs.map