@nulib/clover 4.4.1 → 4.5.0

package/dist/i18n/config.mjs

@@ -1,12 +1,14 @@
 "use client";
 import { loaders } from "./locales/index.mjs";
-import { sameLanguage, readerLanguages, baseLanguage } from "./languages.mjs";
+import { visitorLanguages, pageLanguage, scriptLanguage, baseLanguage, sameLanguage, readInterfaceLanguagesFrom } from "./languages.mjs";
 import en from "./locales/en.json.mjs";
 const CLOVER_I18N_NAMESPACE = "clover";
 const resources = {
   en: { [CLOVER_I18N_NAMESPACE]: { ...en } }
 };
-let language;
+let configured = [];
+let chosen;
+let picked = [];
 let fallbacks = [];
 let version = 0;
 const listeners = /* @__PURE__ */ new Set();
@@ -15,9 +17,12 @@ function notify() {
   listeners.forEach((listener) => listener());
 }
 function withBase(lng) {
-  const base = baseLanguage(lng);
-  return base && base !== lng ? [lng, base] : [lng];
+  return [lng, scriptLanguage(lng), baseLanguage(lng)].filter(
+    (tag) => !!tag
+  );
 }
+const has = (tag) => tag === "en" || ships(tag) || !!resources[tag];
+const speaks = (lng) => withBase(lng).find(has);
 const loading = /* @__PURE__ */ new Map();
 const ships = (lng) => Object.prototype.hasOwnProperty.call(loaders, lng);
 function load(lng) {
@@ -48,28 +53,87 @@ function loadFor(chain2) {
 }
 let chain = [];
 let madeFrom = "";
+let byDefault = "en";
+function offered() {
+  const page = pageLanguage();
+  return [.../* @__PURE__ */ new Set([...configured, ...page ? [page] : []])];
+}
 function lookupChain() {
-  const from = language ? `${version}` : `${version} ${typeof document < "u" ? document.documentElement.lang : ""} ${typeof navigator < "u" ? navigator.languages : ""}`;
+  const from = `${version} ${typeof document < "u" ? document.documentElement.lang : ""} ${typeof navigator < "u" ? navigator.languages : ""}`;
   if (from === madeFrom) return chain;
   madeFrom = from;
-  const requested = language ? [language] : readerLanguages();
+  const set = offered();
+  const visitor = visitorLanguages().map(speaks).find(Boolean);
+  byDefault = visitor ?? set.map(speaks).find(Boolean) ?? "en";
   chain = [
-    ...new Set([...requested, ...fallbacks].flatMap(withBase).concat("en"))
+    ...new Set(
+      [chosen ?? byDefault, ...fallbacks, ...set].filter((tag) => !!tag).flatMap(withBase).concat("en")
+    )
   ];
   void loadFor(chain);
   return chain;
 }
+function offeredLanguages() {
+  lookupChain();
+  return [
+    ...new Set(
+      [byDefault, ...offered().map(speaks), ...picked.map(speaks)].filter(
+        (tag) => !!tag
+      )
+    )
+  ];
+}
+readInterfaceLanguagesFrom(() => {
+  lookupChain();
+  return [chosen, byDefault, ...offered()];
+});
 function langWithin(lang, hostLanguage) {
   if (!lang) return void 0;
   return sameLanguage(lang, hostLanguage || cloverI18n.resolvedLanguage) ? void 0 : lang;
 }
 const cloverI18n = {
-  /** The language set, or else the first of the reader's that Clover has strings for. */
+  /**
+   * Clover's interface language: the one the visitor chose, else the first of the chain
+   * whose strings have loaded.
+   */
   get language() {
-    return language ?? lookupChain().find((lng) => resources[lng]) ?? "en";
+    return chosen ?? lookupChain().find((lng) => resources[lng]) ?? "en";
+  },
+  /** The interface language the visitor chose, if they chose one. */
+  get chosenLanguage() {
+    return chosen;
+  },
+  /**
+   * The tag Clover has strings for that speaks `lng` (`zh-Hans` for `zh-CN`, `en` for
+   * `en-US`), shipped or given by the page; none where it has no strings for it.
+   */
+  stringsFor(lng) {
+    return speaks(lng);
+  },
+  /**
+   * The interface languages to offer, and the one in use (`chosen`): the default (the
+   * visitor's, where Clover has strings for it), then the languages configured, each as
+   * the tag Clover has strings for. A choice is worth offering only where there are two
+   * or more.
+   */
+  interfaceLanguages() {
+    const languages = offeredLanguages();
+    return { languages, chosen: chosen && speaks(chosen) || byDefault };
   },
   /**
-   * The language Clover's strings are in: the first of the lookup chain that has any. A
+   * Speak `lng` whatever the visitor's languages, as their choice of interface language;
+   * none goes back to the default. Settles once its strings have loaded, or failed to.
+   *
+   *     await cloverI18n.chooseInterfaceLanguage("fr");
+   */
+  chooseInterfaceLanguage(lng) {
+    chosen = lng || void 0;
+    picked = chosen ? [.../* @__PURE__ */ new Set([...picked, chosen])] : [];
+    notify();
+    return loadFor(lookupChain());
+  },
+  /**
+   * The language Clover's interface strings are in: the first of the lookup chain that has any. A
    * language set with no strings of its own resolves to the next, English at the last.
    */
   get resolvedLanguage() {
@@ -80,9 +144,9 @@ const cloverI18n = {
       }
     ) ?? "en";
   },
+  /** As `chooseInterfaceLanguage` does: i18next's name for it. */
   changeLanguage(lng) {
-    language = lng;
-    notify();
+    return cloverI18n.chooseInterfaceLanguage(lng);
   },
   /** A string and the language it came from, which a missing key leaves in another. */
   resolve(key, values, namespace = CLOVER_I18N_NAMESPACE) {
@@ -123,7 +187,7 @@ const cloverI18n = {
    * Settles once the language Clover speaks has loaded, or failed to: for a server render,
    * or a test, that needs the strings in place before it draws.
    *
-   *     await initCloverI18n({ lng: "fr" }).ready();
+   *     await initCloverI18n({ languages: ["fr"] }).ready();
    */
   ready() {
     return loadFor(lookupChain());
@@ -153,7 +217,17 @@ function initCloverI18n(options = {}) {
   if (options.fallbackLng !== void 0) {
     fallbacks = options.fallbackLng === false ? [] : [options.fallbackLng].flat();
   }
-  if (options.lng) language = options.lng;
+  const before = configured.join();
+  if (options.languages !== void 0) {
+    configured = [options.languages].flat().filter(Boolean);
+  } else if (options.lng) {
+    configured = [options.lng];
+  }
+  if (configured.join() !== before) {
+    picked = [];
+    const kept = [...visitorLanguages(), ...offered()].map(speaks);
+    if (chosen && !kept.includes(speaks(chosen))) chosen = void 0;
+  }
   notify();
   return cloverI18n;
 }

package/dist/i18n/direction.mjs

@@ -1,10 +1,10 @@
 "use client";
-const RTL_LANGUAGE = /^(ar|arc|ckb|dv|fa|he|iw|ks|ps|sd|syr|ug|ur|yi)$/;
+const RTL_LANGUAGE = /^(ar|arc|ckb|dv|fa|he|iw|ks|ps|sd|syr|ug|ur|yi|ota|prs|azb|pnb|bal|glk|mzn|lrc|khw|nqo|rhg|jrb|jpr|sam|arz|ary|apc|acm|ajp|aeb|ars)$/;
 const RTL_SCRIPT = /^(adlm|arab|hebr|nkoo|rohg|syrc|thaa)$/;
 function directionOf(lang) {
   if (!lang) return void 0;
   const [primary, ...subtags] = lang.toLowerCase().split(/[-_]/);
-  const script = subtags.find((subtag) => subtag.length === 4);
+  const script = subtags.find((subtag) => /^[a-z]{4}$/.test(subtag));
   return (script ? RTL_SCRIPT.test(script) : RTL_LANGUAGE.test(primary)) ? "rtl" : void 0;
 }
 function languageProps(lang) {

package/dist/i18n/languages.mjs

@@ -1,17 +1,45 @@
 "use client";
+function visitorLanguages() {
+  if (typeof navigator === "undefined") return [];
+  return [...navigator.languages ?? [], navigator.language].filter(Boolean);
+}
+function pageLanguage() {
+  if (typeof document === "undefined") return void 0;
+  return document.documentElement.lang || void 0;
+}
+let interfaceLanguages = () => [];
+function readInterfaceLanguagesFrom(source) {
+  interfaceLanguages = source;
+}
 function readerLanguages() {
-  const found = [];
-  if (typeof document !== "undefined")
-    found.push(document.documentElement.lang);
-  if (typeof navigator !== "undefined") {
-    found.push(...navigator.languages ?? [], navigator.language);
-  }
-  return found.filter(Boolean);
+  const [chosen, ...rest] = interfaceLanguages();
+  return [
+    ...new Set(
+      [chosen, ...visitorLanguages(), ...rest, pageLanguage()].filter(
+        (tag) => !!tag
+      )
+    )
+  ];
 }
 const baseLanguage = (tag) => tag.split("-")[0];
 function sameLanguage(a, b) {
   return baseLanguage(a).toLowerCase() === baseLanguage(b).toLowerCase();
 }
+function scriptLanguage(tag) {
+  try {
+    const { language, script } = new Intl.Locale(tag).maximize();
+    return script && `${language}-${script}`;
+  } catch {
+    return void 0;
+  }
+}
+function sameScript(tag, tags) {
+  const script = scriptLanguage(tag);
+  if (!script) return void 0;
+  return tags.find(
+    (each) => each !== "none" && each !== "@none" && scriptLanguage(each) === script
+  );
+}
 const baseOf = (tag) => tag.includes("-") ? baseLanguage(tag) : null;
 function closestLanguage(language, tags, fallbacks = []) {
   if (!tags.length) return void 0;
@@ -21,6 +49,8 @@ function closestLanguage(language, tags, fallbacks = []) {
   if (tags.includes(language)) return language;
   const base = baseOf(language);
   if (base && tags.includes(base)) return base;
+  const script = sameScript(language, tags);
+  if (script) return script;
   const fallback = fallbacks.find((tag) => tags.includes(tag));
   if (fallback) return fallback;
   const regional = tags.findIndex((tag) => baseOf(tag) === language);
@@ -39,6 +69,10 @@ export {
   baseLanguage,
   closestLanguage,
   languageToRead,
+  pageLanguage,
+  readInterfaceLanguagesFrom,
   readerLanguages,
-  sameLanguage
+  sameLanguage,
+  scriptLanguage,
+  visitorLanguages
 };

package/dist/i18n/locales/index.mjs

@@ -3,10 +3,13 @@ const loaders = {
   es: () => import("./es.json.mjs"),
   fi: () => import("./fi.json.mjs"),
   fr: () => import("./fr.json.mjs"),
+  ja: () => import("./ja.json.mjs"),
   nb: () => import("./nb.json.mjs"),
   nn: () => import("./nn.json.mjs"),
   no: () => import("./no.json.mjs"),
-  pt: () => import("./pt.json.mjs")
+  pt: () => import("./pt.json.mjs"),
+  "zh-Hans": () => import("./zh-Hans.json.mjs"),
+  "zh-Hant": () => import("./zh-Hant.json.mjs")
 };
 export {
   loaders

package/dist/i18n/locales/ja.json.mjs

@@ -0,0 +1,5 @@
+"use client";
+const ja = JSON.parse('{"commonClose":"閉じる","commonNext":"次へ","commonPrevious":"前へ","commonSearch":"検索","commonViewAll":"すべて表示","controlShortcut":"{{label}}（{{shortcut}}）","contentSearchLoading":"読み込み中…","contentSearchPlaceholder":"検索","contentSearchResultsNone":"結果はありません","contentSearchResult":"1 件の結果","contentSearchResults":"{{count}} 件の結果","contentSearchError":"検索を完了できませんでした。","contentSearchPosition":"{{total}} 件中 {{index}} 件目の結果","contentSearchClear":"検索をクリア","canvasPosition":"{{total}} 件中 {{index}} 件目","canvasImage":"画像","bodyUnloadableImage":"この画像を読み込めませんでした。","bodyUnloadableVideo":"この動画を読み込めませんでした。","bodyUnloadableAudio":"この音声を読み込めませんでした。","bodyUnloadableModel":"このモデルを読み込めませんでした。","canvasRoleDescription":"ズームできる画像","canvasKeysImage":"矢印キーで移動（Shift で大きく移動）、プラスとマイナスでズーム、0 で表示をリセット、R または Shift+R で回転します。","canvasKeysMedia":"Space または K で再生・一時停止、J または L で 10 秒戻る・進む、M でミュート・ミュート解除します。","canvasKeysAnnotations":"Escape キーで選択した注釈を解除します。","sceneModel":"3D モデル","sceneRoleDescription":"回転できる 3D モデル","sceneKeys":"矢印キーでモデルを回転（Shift で大きく回転）、プラスとマイナスでズーム、0 で表示をリセット、R または Shift+R で右または左に回転します。","sceneRotateUp":"上に回転","sceneRotateDown":"下に回転","sceneRotate":"回転","sceneResetView":"表示をリセット","statusLoading":"読み込み中…","statusError":"読み込めませんでした。","itemsLabel":"アイテム","download":"ダウンロード","downloadPage":"このページ","downloadAll":"すべてのページ","templateSidebar":"アイテム","templateSidebarToggle":"アイテムを表示","templateBack":"戻る","templateBackTo":"{{label}} に戻る","collectionLabel":"コレクション","itemsScrollBack":"前のアイテムを表示","itemsScrollForward":"さらにアイテムを表示","aboutRights":"権利","aboutDate":"日付","aboutHomepage":"ホームページ","aboutSeeAlso":"関連情報","aboutProvider":"提供者","logo":"ロゴ","aboutManifest":"IIIF マニフェスト","aboutCanvas":"IIIF キャンバス","aboutPartOf":"所属先","aboutOpenManifest":"マニフェスト全体を開く","aboutCollection":"IIIF コレクション","readingLanguage":"言語","annotationsHide":"注釈を非表示","annotationsHideTip":"非表示","readMore":"続きを読む","readLess":"折りたたむ","annotationsShow":"画像上で探す","annotationsShowTime":"録音内で探す","annotationsImage":"画像","annotationsLanguage":"言語","annotationsOpenLink":"リンクを開く","transcriptLabel":"文字起こし","imageViewerOpen":"画像ビューアを開く","imageViewerClose":"画像ビューアを閉じる","canvasChoice":"選択肢","canvasViewerControls":"ビューアのコントロール","canvasExpandControls":"ビューアのコントロールを展開","canvasCollapseControls":"ビューアのコントロールを折りたたむ","canvasScrollBack":"前のコントロールを表示","canvasScrollForward":"さらにコントロールを表示","imageFullScreen":"全画面表示","imageExitFullScreen":"全画面表示を終了","imageResetZoom":"ズームをリセット","imageRotateLeft":"左に回転","imageRotateRight":"右に回転","imageZoomIn":"拡大","imageZoomOut":"縮小","informationPanelTabs":"情報パネル","sectionsScrollBack":"前のタブを表示","sectionsScrollForward":"さらにタブを表示","informationPanelClose":"情報パネルを閉じる","informationPanelTabsAbout":"概要","informationPanelTabsAnnotations":"注釈","informationPanelTabsSearch":"検索","informationPanelTabsContents":"目次","contentsSectionsIn":"下位セクション：","informationPanelTabsMap":"地図","informationPanelTabsCollection":"コレクション","informationPanelTabsTargets":"ビュー","mapUnavailable":"地図を表示できませんでした。","mapLabel":"地図","mapAttribution":"地図のクレジット","mapPlaceUntitled":"場所 {{number}}","mapOverlay":"ジオリファレンス画像","mapPlacesListed":"地図の後に一覧表示される場所：{{count}} 件","informationPanelToggle":"詳細情報","playerPlay":"再生","playerPause":"一時停止","playerMute":"ミュート","playerUnmute":"ミュート解除","playerVolume":"音量","playerSeek":"再生位置","playerCaptions":"字幕","playerCaptionsOff":"オフ","playerChapters":"チャプター","playerFill":"枠いっぱいに表示","playerFit":"枠に収める","frameRepeat":"繰り返し","playerCurrentTime":"経過時間","playerDuration":"再生時間","splitHandle":"パネルのサイズを変更"}');
+export {
+  ja as default
+};

package/dist/i18n/locales/zh-Hans.json.mjs

@@ -0,0 +1,5 @@
+"use client";
+const zhHans = JSON.parse('{"commonClose":"关闭","commonNext":"下一个","commonPrevious":"上一个","commonSearch":"搜索","commonViewAll":"查看全部","controlShortcut":"{{label}}（{{shortcut}}）","contentSearchLoading":"正在加载…","contentSearchPlaceholder":"搜索","contentSearchResultsNone":"无结果","contentSearchResult":"1 个结果","contentSearchResults":"{{count}} 个结果","contentSearchError":"无法完成搜索。","contentSearchPosition":"第 {{index}} 个结果，共 {{total}} 个","contentSearchClear":"清除搜索","canvasPosition":"第 {{index}} 项，共 {{total}} 项","canvasImage":"图像","bodyUnloadableImage":"无法加载此图像。","bodyUnloadableVideo":"无法加载此视频。","bodyUnloadableAudio":"无法加载此音频。","bodyUnloadableModel":"无法加载此模型。","canvasRoleDescription":"可缩放图像","canvasKeysImage":"使用方向键平移（按住 Shift 可大步移动），按加号和减号缩放，按 0 重置视图，按 R 或 Shift+R 旋转。","canvasKeysMedia":"按空格键或 K 播放或暂停，按 J 或 L 后退或前进十秒，按 M 静音或取消静音。","canvasKeysAnnotations":"按 Esc 键清除所选注释。","sceneModel":"3D 模型","sceneRoleDescription":"可旋转 3D 模型","sceneKeys":"使用方向键旋转模型（按住 Shift 可大步旋转），按加号和减号缩放，按 0 重置视图，按 R 或 Shift+R 向右或向左旋转。","sceneRotateUp":"向上旋转","sceneRotateDown":"向下旋转","sceneRotate":"旋转","sceneResetView":"重置视图","statusLoading":"正在加载…","statusError":"无法加载。","itemsLabel":"项目","download":"下载","downloadPage":"本页","downloadAll":"所有页面","templateSidebar":"项目","templateSidebarToggle":"显示项目","templateBack":"返回","templateBackTo":"返回{{label}}","collectionLabel":"集合","itemsScrollBack":"显示上一组项目","itemsScrollForward":"显示更多项目","aboutRights":"权利","aboutDate":"日期","aboutHomepage":"主页","aboutSeeAlso":"另见","aboutProvider":"提供者","logo":"标志","aboutManifest":"IIIF 清单","aboutCanvas":"IIIF 画布","aboutPartOf":"所属","aboutOpenManifest":"打开完整清单","aboutCollection":"IIIF 集合","readingLanguage":"语言","annotationsHide":"隐藏注释","annotationsHideTip":"隐藏","readMore":"展开","readLess":"收起","annotationsShow":"在图像上查找","annotationsShowTime":"在录音中查找","annotationsImage":"图像","annotationsLanguage":"语言","annotationsOpenLink":"打开链接","transcriptLabel":"文字记录","imageViewerOpen":"打开图像查看器","imageViewerClose":"关闭图像查看器","canvasChoice":"选项","canvasViewerControls":"查看器控件","canvasExpandControls":"展开查看器控件","canvasCollapseControls":"收起查看器控件","canvasScrollBack":"显示上一组控件","canvasScrollForward":"显示更多控件","imageFullScreen":"全屏","imageExitFullScreen":"退出全屏","imageResetZoom":"重置缩放","imageRotateLeft":"向左旋转","imageRotateRight":"向右旋转","imageZoomIn":"放大","imageZoomOut":"缩小","informationPanelTabs":"信息面板","sectionsScrollBack":"显示上一组标签页","sectionsScrollForward":"显示更多标签页","informationPanelClose":"关闭信息面板","informationPanelTabsAbout":"简介","informationPanelTabsAnnotations":"注释","informationPanelTabsSearch":"搜索","informationPanelTabsContents":"目录","contentsSectionsIn":"下级章节：","informationPanelTabsMap":"地图","informationPanelTabsCollection":"集合","informationPanelTabsTargets":"视图","mapUnavailable":"无法显示地图。","mapLabel":"地图","mapAttribution":"地图来源","mapPlaceUntitled":"地点 {{number}}","mapOverlay":"地理配准图像","mapPlacesListed":"地图后列出的地点：{{count}} 个","informationPanelToggle":"更多信息","playerPlay":"播放","playerPause":"暂停","playerMute":"静音","playerUnmute":"取消静音","playerVolume":"音量","playerSeek":"播放进度","playerCaptions":"字幕","playerCaptionsOff":"关闭","playerChapters":"章节","playerFill":"填满画面","playerFit":"适应画面","frameRepeat":"重复","playerCurrentTime":"当前时间","playerDuration":"时长","splitHandle":"调整面板大小"}');
+export {
+  zhHans as default
+};

package/dist/i18n/locales/zh-Hant.json.mjs

@@ -0,0 +1,5 @@
+"use client";
+const zhHant = JSON.parse('{"commonClose":"關閉","commonNext":"下一個","commonPrevious":"上一個","commonSearch":"搜尋","commonViewAll":"檢視全部","controlShortcut":"{{label}}（{{shortcut}}）","contentSearchLoading":"載入中…","contentSearchPlaceholder":"搜尋","contentSearchResultsNone":"沒有結果","contentSearchResult":"1 筆結果","contentSearchResults":"{{count}} 筆結果","contentSearchError":"無法完成搜尋。","contentSearchPosition":"第 {{index}} 筆結果，共 {{total}} 筆","contentSearchClear":"清除搜尋","canvasPosition":"第 {{index}} 項，共 {{total}} 項","canvasImage":"影像","bodyUnloadableImage":"無法載入此影像。","bodyUnloadableVideo":"無法載入此影片。","bodyUnloadableAudio":"無法載入此音訊。","bodyUnloadableModel":"無法載入此模型。","canvasRoleDescription":"可縮放影像","canvasKeysImage":"使用方向鍵平移（按住 Shift 可大幅移動），按加號和減號縮放，按 0 重設檢視，按 R 或 Shift+R 旋轉。","canvasKeysMedia":"按空白鍵或 K 播放或暫停，按 J 或 L 倒轉或快轉十秒，按 M 靜音或取消靜音。","canvasKeysAnnotations":"按 Esc 鍵清除所選註解。","sceneModel":"3D 模型","sceneRoleDescription":"可旋轉 3D 模型","sceneKeys":"使用方向鍵旋轉模型（按住 Shift 可大幅旋轉），按加號和減號縮放，按 0 重設檢視，按 R 或 Shift+R 向右或向左旋轉。","sceneRotateUp":"向上旋轉","sceneRotateDown":"向下旋轉","sceneRotate":"旋轉","sceneResetView":"重設檢視","statusLoading":"載入中…","statusError":"無法載入。","itemsLabel":"項目","download":"下載","downloadPage":"本頁","downloadAll":"所有頁面","templateSidebar":"項目","templateSidebarToggle":"顯示項目","templateBack":"返回","templateBackTo":"返回{{label}}","collectionLabel":"集合","itemsScrollBack":"顯示上一組項目","itemsScrollForward":"顯示更多項目","aboutRights":"權利","aboutDate":"日期","aboutHomepage":"首頁","aboutSeeAlso":"另見","aboutProvider":"提供者","logo":"標誌","aboutManifest":"IIIF 清單","aboutCanvas":"IIIF 畫布","aboutPartOf":"所屬","aboutOpenManifest":"開啟完整清單","aboutCollection":"IIIF 集合","readingLanguage":"語言","annotationsHide":"隱藏註解","annotationsHideTip":"隱藏","readMore":"展開","readLess":"收合","annotationsShow":"在影像上尋找","annotationsShowTime":"在錄音中尋找","annotationsImage":"影像","annotationsLanguage":"語言","annotationsOpenLink":"開啟連結","transcriptLabel":"逐字稿","imageViewerOpen":"開啟影像檢視器","imageViewerClose":"關閉影像檢視器","canvasChoice":"選項","canvasViewerControls":"檢視器控制項","canvasExpandControls":"展開檢視器控制項","canvasCollapseControls":"收合檢視器控制項","canvasScrollBack":"顯示上一組控制項","canvasScrollForward":"顯示更多控制項","imageFullScreen":"全螢幕","imageExitFullScreen":"結束全螢幕","imageResetZoom":"重設縮放","imageRotateLeft":"向左旋轉","imageRotateRight":"向右旋轉","imageZoomIn":"放大","imageZoomOut":"縮小","informationPanelTabs":"資訊面板","sectionsScrollBack":"顯示上一組分頁","sectionsScrollForward":"顯示更多分頁","informationPanelClose":"關閉資訊面板","informationPanelTabsAbout":"簡介","informationPanelTabsAnnotations":"註解","informationPanelTabsSearch":"搜尋","informationPanelTabsContents":"目錄","contentsSectionsIn":"下層章節：","informationPanelTabsMap":"地圖","informationPanelTabsCollection":"集合","informationPanelTabsTargets":"檢視","mapUnavailable":"無法顯示地圖。","mapLabel":"地圖","mapAttribution":"地圖來源","mapPlaceUntitled":"地點 {{number}}","mapOverlay":"地理對位影像","mapPlacesListed":"地圖後列出的地點：{{count}} 個","informationPanelToggle":"更多資訊","playerPlay":"播放","playerPause":"暫停","playerMute":"靜音","playerUnmute":"取消靜音","playerVolume":"音量","playerSeek":"播放進度","playerCaptions":"字幕","playerCaptionsOff":"關閉","playerChapters":"章節","playerFill":"填滿畫面","playerFit":"符合畫面","frameRepeat":"重複","playerCurrentTime":"目前時間","playerDuration":"長度","splitHandle":"調整面板大小"}');
+export {
+  zhHant as default
+};

package/dist/index.d.mts

@@ -307,8 +307,9 @@ export declare function buildContentState({ manifestId, canvasId, type, region,
  * state (JSON or base64url). The resource may be a Manifest, a Collection (its first
  * Manifest is shown), a lone Canvas (its `partOf` Manifest, or a Manifest made around
  * it), or annotations, an AnnotationPage or AnnotationCollection (the Manifest their first
- * annotation's Canvas is `partOf`, at that Canvas). Everything is fetched once, with the
- * request settings, and upgraded to Presentation 4.
+ * annotation's Canvas is `partOf`, at that Canvas). It may also be a IIIF Image service,
+ * its `info.json` or its base URI, shown as the one image it is (`imageServiceContent`).
+ * Everything is fetched once, with the request settings, and upgraded to Presentation 4.
  */
 export type IIIFContent = string | Record<string, unknown>;
 /**
@@ -934,7 +935,7 @@ export type ControlButtonProps = {
 		"aria-label": string;
 		/**
 		 * The language of the name, when it is not the page's: a Choice's own label, or one
-		 * of Clover's strings in another language. Spread it with the rest (WCAG 3.1.2).
+		 * of Clover's interface strings in another language. Spread it with the rest (WCAG 3.1.2).
 		 */
 		lang?: string;
 		/** The key the Canvas answers to for this control, when it has one. */
@@ -1012,6 +1013,11 @@ export interface CloverCanvasOptions {
 	maxZoomPixelRatio?: number;
 	/** Smallest zoom, as a fraction of the home zoom. Default 0.9. */
 	minZoomImageRatio?: number;
+	/**
+	 * Whether home may enlarge the image past `maxZoomPixelRatio` to fill the box. False,
+	 * home stops at that zoom and centers the image, smaller than the box. Default true.
+	 */
+	upscale?: boolean;
 	/** Seconds for an animation to close most of its distance. 0 disables easing. */
 	animationTime?: number;
 	/**
@@ -1429,6 +1435,12 @@ export interface ItemsProps extends Omit<React.HTMLAttributes<HTMLElement>, "onS
 	 * under the one above it, still in reading order, left to right.
 	 */
 	layout?: ItemsLayout;
+	/**
+	 * The slider's direction: a row (`horizontal`), or a column (`vertical`) that fills
+	 * the height of what holds it, as a filmstrip beside the Body, its pictures as wide as
+	 * the column. Default `"horizontal"`.
+	 */
+	orientation?: "horizontal" | "vertical";
 	/**
 	 * The line under an item's label, where it has one (a Collection's members do): its
 	 * `summary` (the default), its `navDate`, or `none`. Default `"summary"`.
@@ -1676,7 +1688,7 @@ export declare function usePanelSections(sections?: readonly PanelSection[]): Pa
 /** How the sections are laid out. */
 export type SectionsLayout = "tabs" | "accordion";
 /**
- * What a page calls a section, in place of Clover's own word for it: its words, taken to
+ * What a page calls a section, in place of its word in Clover's interface language: its words, taken to
  * be in the page's language, or its words by language tag, one of which the tab carries
  * as its `lang` where it is not the page's (WCAG 3.1.2).
  */
@@ -1747,6 +1759,13 @@ export interface PanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "def
 	 * leaves the choice out, and the Root reads in its `language`, else the reader's.
 	 */
 	languages?: boolean;
+	/**
+	 * Whether About's language toggle also offers Clover's interface languages (its
+	 * control labels, section titles and announcements) that the resource has none of: the
+	 * visitor's and the site's, where they differ, one choice for the page. Default
+	 * `true`; `false` leaves them out, and Clover speaks the visitor's.
+	 */
+	interfaceLanguages?: boolean;
 	/**
 	 * Which of the default sections the panel may have, in Clover's own order: with
 	 * `["contents", "search"]` it has those two and no About. Each still shows only where
@@ -1755,7 +1774,7 @@ export interface PanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "def
 	 */
 	sections?: readonly PanelSection[];
 	/**
-	 * What a default section's tab or heading says, in place of Clover's own word for it:
+	 * What a default section's tab or heading says, in place of its word in Clover's interface language:
 	 * `{ annotations: "Chapters" }`, or `{ annotations: { en: "Chapters", de: "Kapitel" } }`
 	 * to say it in several, read in the one Clover speaks and marked with its language
 	 * where that is not the page's (WCAG 3.1.2). A `Tab` of your own says it in `label`.
@@ -1825,6 +1844,13 @@ export interface AboutProps extends React.HTMLAttributes<HTMLElement> {
 	 * In a Panel, its heading offers them (the Panel's `languages`). Default `true`.
 	 */
 	languages?: boolean;
+	/**
+	 * Alone, outside a Panel: whether its language toggle also offers Clover's interface
+	 * languages (its control labels, section titles and announcements) that the resource
+	 * has none of, the visitor's and the site's, where they differ. In a Panel, the Panel's
+	 * `interfaceLanguages`. Default `true`.
+	 */
+	interfaceLanguages?: boolean;
 }
 /**
  * Everything the Manifest says about itself, in the order 3.x's About tab shows it:
@@ -1835,11 +1861,12 @@ export interface AboutProps extends React.HTMLAttributes<HTMLElement> {
  * it. The downloads are Download's: the `rendering` of the page in view ("This page")
  * and of the Manifest ("All pages").
  *
- * Where what it says comes in several languages, the languages to read the resource in
- * (`ReadingLanguages`): over what About says, or, in a Panel's `about` section, beside
- * its heading, where they show whichever section is open.
+ * Where what it says comes in several languages, or the visitor's language differs from
+ * the site's, the languages to read in, as one toggle (`LanguageToggle`): over what About
+ * says, or, in a Panel's `about` section, beside its heading, where it shows whichever
+ * section is open.
  */
-export declare function About({ languages, ...props }: AboutProps): React.JSX.Element;
+export declare function About({ languages, interfaceLanguages, ...props }: AboutProps): React.JSX.Element;
 export interface AnnotationsProps extends React.HTMLAttributes<HTMLElement> {
 	/**
 	 * Every annotation in the Manifest (default), as the Viewer's panel lists them: by
@@ -2433,7 +2460,7 @@ export declare function useLocalized(value: LanguageMapLike): LocalizedValue;
 /** Clover's interface strings in the current language: `t("commonClose")`. */
 export declare function useT(): (key: string, values?: Record<string, unknown>) => string;
 /**
- * The language of one of Clover's strings where it is not the page's (a French reader on
+ * The language of one of Clover's interface strings where it is not the page's (a French reader on
  * an English page, or a key that fell back to English), for the element that shows it, or
  * is named by it, to carry as `lang` (WCAG 3.1.2). Undefined otherwise: the string takes
  * the page's language. The page's is the nearest `lang` around the Root.
@@ -2578,6 +2605,13 @@ export interface CloverContextValue {
 	 * inside reads in it, until the Root is given another `language`.
 	 */
 	chooseLanguage?: (tag: string) => void;
+	/**
+	 * Whether a language toggle of the Root's is drawn (About's, `LanguageToggle`), so the
+	 * parts that would offer their own (an annotation set's languages, a Transcript's
+	 * caption files) follow it instead; `drawsToggle` says one is, until its cleanup runs.
+	 */
+	toggleDrawn?: boolean;
+	drawsToggle?: () => () => void;
 	/** Renderers of the host's own, for `Body` to draw some views with. */
 	renderers?: BodyRenderer[];
 }
@@ -2718,7 +2752,8 @@ export declare function regionSource(canvas: Json | undefined, rect: {
 	h: number;
 }, image?: string): ThumbnailSource | null;
 /**
- * Clover's translations, without a translation library.
+ * Clover's interface language: the language of its control labels ("Zoom in"), section
+ * titles ("About") and announcements ("Item 2 of 17"), without a translation library.
  *
  * Clover needs a key lookup with a fallback chain, `{{name}}` interpolation and language
  * detection. i18next did that at about 20 kB gzipped across three packages;
@@ -2726,44 +2761,84 @@ export declare function regionSource(canvas: Json | undefined, rect: {
  * them, so existing `initCloverI18n` calls keep working:
  *
  *     initCloverI18n({
- *       lng: "de",
+ *       languages: ["de"],
  *       fallbackLng: ["de", "en"],
  *       resources: { de: { clover: { informationPanelTabsAbout: "Über" } } },
  *     });
  *
+ * Which it speaks (Mat, 2026-11-05): the languages configured (`languages`, or `lng` for
+ * one), then the page's `<html lang>` (Mat, 2026-11-05: derived, as the visitor's is),
+ * else English; then the visitor's languages, from
+ * the browser. The visitor's first that Clover has strings for is the default, else the
+ * first configured; where the two differ, `interfaceLanguages()` offers both, and
+ * `chooseInterfaceLanguage` takes the visitor's choice.
+ *
  * English ships with Clover. Each other language it ships loads the first time Clover is
  * to speak it, so until it arrives a string shows in English, marked as English by
- * `langOf`, and the readers re-render when it does. `cloverI18n.ready()` waits for it.
+ * `langOf`, and the parts re-render when it does. `cloverI18n.ready()` waits for it.
  */
 export declare const CLOVER_I18N_NAMESPACE = "clover";
 /** `resources[language][namespace][key]` — i18next's resource shape. */
 export type CloverI18nResources = Record<string, Record<string, Record<string, string>>>;
 export interface CloverI18nOptions {
 	/**
-	 * The language to use. When not given: the page's `<html lang>`, then the browser's
-	 * languages, so Clover speaks the language of the page around it.
+	 * The languages your site offers Clover's interface in, most preferred first. A
+	 * visitor whose own language Clover has strings for sees theirs, with these offered
+	 * beside it, with the page's `<html lang>`; any other visitor sees the first of these.
+	 * When not given, the page's
+	 * `<html lang>`, else English.
 	 */
+	languages?: string | readonly string[];
+	/** One language to offer, as `languages: [lng]` does. */
 	lng?: string;
 	/** Languages to try, in order, when a key is missing. English is always last. */
 	fallbackLng?: string | readonly string[] | false;
 	/** Strings to add or override, merged into what Clover ships. */
 	resources?: CloverI18nResources;
 }
-/** One of Clover's strings, and the language it is written in. */
+/** One of Clover's interface strings, and the language it is written in. */
 export interface CloverString {
 	text: string;
 	/** The language the string came from; undefined when no language has the key. */
 	lang?: string;
 }
 declare const cloverI18n: {
-	/** The language set, or else the first of the reader's that Clover has strings for. */
+	/**
+	 * Clover's interface language: the one the visitor chose, else the first of the chain
+	 * whose strings have loaded.
+	 */
 	readonly language: string;
+	/** The interface language the visitor chose, if they chose one. */
+	readonly chosenLanguage: string | undefined;
+	/**
+	 * The tag Clover has strings for that speaks `lng` (`zh-Hans` for `zh-CN`, `en` for
+	 * `en-US`), shipped or given by the page; none where it has no strings for it.
+	 */
+	stringsFor(lng: string): string | undefined;
+	/**
+	 * The interface languages to offer, and the one in use (`chosen`): the default (the
+	 * visitor's, where Clover has strings for it), then the languages configured, each as
+	 * the tag Clover has strings for. A choice is worth offering only where there are two
+	 * or more.
+	 */
+	interfaceLanguages(): {
+		languages: string[];
+		chosen: string;
+	};
 	/**
-	 * The language Clover's strings are in: the first of the lookup chain that has any. A
+	 * Speak `lng` whatever the visitor's languages, as their choice of interface language;
+	 * none goes back to the default. Settles once its strings have loaded, or failed to.
+	 *
+	 *     await cloverI18n.chooseInterfaceLanguage("fr");
+	 */
+	chooseInterfaceLanguage(lng?: string): Promise<void>;
+	/**
+	 * The language Clover's interface strings are in: the first of the lookup chain that has any. A
 	 * language set with no strings of its own resolves to the next, English at the last.
 	 */
 	readonly resolvedLanguage: string;
-	changeLanguage(lng: string): void;
+	/** As `chooseInterfaceLanguage` does: i18next's name for it. */
+	changeLanguage(lng: string): Promise<void>;
 	/** A string and the language it came from, which a missing key leaves in another. */
 	resolve(key: string, values?: Record<string, unknown>, namespace?: string): CloverString;
 	t(key: string, values?: Record<string, unknown>, namespace?: string): string;
@@ -2778,7 +2853,7 @@ declare const cloverI18n: {
 	 * Settles once the language Clover speaks has loaded, or failed to: for a server render,
 	 * or a test, that needs the strings in place before it draws.
 	 *
-	 *     await initCloverI18n({ lng: "fr" }).ready();
+	 *     await initCloverI18n({ languages: ["fr"] }).ready();
 	 */
 	ready(): Promise<void>;
 	/** For `useSyncExternalStore`: re-render readers when the language or strings change. */
@@ -2787,8 +2862,11 @@ declare const cloverI18n: {
 };
 export type CloverI18n = typeof cloverI18n;
 /**
- * Set Clover's language and add or override strings. Safe to call more than once: each
- * call merges its `resources` and applies any `lng` or `fallbackLng` it is given.
+ * Configure Clover's interface language (`languages`, or `lng` for one) and add or
+ * override strings. Safe to call more than once: each call merges its `resources` and
+ * applies any `languages`, `lng` or `fallbackLng` it is given. A visitor whose language
+ * Clover has strings for still sees theirs first, with yours offered beside it; to speak
+ * one language whatever the visitor's, `chooseInterfaceLanguage`.
  */
 export declare function initCloverI18n(options?: CloverI18nOptions): CloverI18n;
 export type DefaultProps = Omit<RootProps, "children"> & {
@@ -2820,7 +2898,7 @@ export type DefaultProps = Omit<RootProps, "children"> & {
 	 */
 	panelSections?: readonly PanelSection[];
 	/**
-	 * What a panel section's tab or heading says, in place of Clover's own word for it:
+	 * What a panel section's tab or heading says, in place of its word in Clover's interface language:
 	 * `{ annotations: "Chapters" }`, or a word by language tag to say it in several (the
 	 * Panel's `labels`).
 	 */
@@ -2832,6 +2910,13 @@ export type DefaultProps = Omit<RootProps, "children"> & {
 	 * it says of itself comes in several (the Panel's `languages`). Default `true`.
 	 */
 	languages?: boolean;
+	/**
+	 * Default, Document and Gallery: whether the panel's language toggle, beside its About
+	 * heading, also offers Clover's interface languages (its control labels, section
+	 * titles and announcements) that the resource has none of, the visitor's and the
+	 * site's, where they differ (the Panel's `interfaceLanguages`). Default `true`.
+	 */
+	interfaceLanguages?: boolean;
 	/** The thumbnails under the Body: a layout, or `false` for none. Default `slider`. */
 	items?: Exclude<ItemsLayout, "pager"> | false;
 	/**
@@ -2860,7 +2945,7 @@ export type DefaultProps = Omit<RootProps, "children"> & {
 	/** The Body's Canvas `options`: its gestures, zoom limits and motion. */
 	canvasOptions?: CloverCanvasOptions;
 };
-declare function Default({ className, header, headingLevel, panel, defaultPanelOpen, panelLayout, panelSections, panelLabels, download, languages, items, singleItem, storageKey, fill, collapseControls, canvasOptions, ...root }: DefaultProps): React.JSX.Element;
+declare function Default({ className, header, headingLevel, panel, defaultPanelOpen, panelLayout, panelSections, panelLabels, download, languages, interfaceLanguages, items, singleItem, storageKey, fill, collapseControls, canvasOptions, ...root }: DefaultProps): React.JSX.Element;
 /**
  * A layout the Viewer draws: one from `@nulib/clover/templates`, or a component of your
  * own that takes the `Clover.Root` props.