@open-file-viewer/core 0.1.14 → 0.1.15

package/README.md

@@ -249,6 +249,23 @@ createViewer({
 
 Use `toolbar.render(ctx)` when you need to replace the toolbar completely. The context exposes file metadata, queue navigation, preview commands, download, fullscreen, print and search helpers.
 
+## Locale and Fallback Text
+
+Fallback text defaults to Simplified Chinese for compatibility. Set `locale: "en-US"` for English built-in loading and unsupported-file messages, or override individual strings with `messages`:
+
+```ts
+createViewer({
+  container: "#viewer",
+  file,
+  locale: "en-US",
+  messages: {
+    unsupportedTitle: "No inline preview available",
+    downloadFile: "Download original file"
+  },
+  plugins
+});
+```
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -606,6 +606,48 @@ function revokeObjectUrl(url, isExternal) {
   }
 }
 
+// src/messages.ts
+var defaultMessages = {
+  "zh-CN": {
+    loading: "\u6B63\u5728\u52A0\u8F7D\u9884\u89C8...",
+    unsupportedTitle: "\u5F53\u524D\u6587\u4EF6\u6682\u4E0D\u652F\u6301\u5728\u7EBF\u9884\u89C8",
+    downloadTitle: "\u5F53\u524D\u6587\u4EF6\u53EF\u4E0B\u8F7D\u540E\u67E5\u770B",
+    downloadFile: "\u4E0B\u8F7D\u6587\u4EF6",
+    file: "\u6587\u4EF6",
+    unnamedFile: "\u672A\u547D\u540D\u6587\u4EF6",
+    format: "\u683C\u5F0F",
+    unknown: "\u672A\u77E5",
+    mime: "MIME",
+    undeclared: "\u672A\u58F0\u660E",
+    size: "\u5927\u5C0F",
+    source: "\u6765\u6E90",
+    remoteUrl: "\u8FDC\u7A0B URL",
+    localFile: "\u672C\u5730/\u5185\u5B58\u6587\u4EF6"
+  },
+  "en-US": {
+    loading: "Loading preview...",
+    unsupportedTitle: "Preview is not available for this file",
+    downloadTitle: "This file can be downloaded and opened locally",
+    downloadFile: "Download file",
+    file: "File",
+    unnamedFile: "Untitled file",
+    format: "Format",
+    unknown: "Unknown",
+    mime: "MIME",
+    undeclared: "Not declared",
+    size: "Size",
+    source: "Source",
+    remoteUrl: "Remote URL",
+    localFile: "Local or in-memory file"
+  }
+};
+function resolveMessages(options) {
+  return {
+    ...defaultMessages[options.locale || "zh-CN"],
+    ...options.messages
+  };
+}
+
 // src/plugins/fallback.ts
 function fallbackPlugin() {
   return {
@@ -623,12 +665,12 @@ function fallbackPlugin() {
       const panel = document.createElement("div");
       panel.className = "ofv-fallback";
       const title = document.createElement("strong");
-      title.textContent = ctx.options.fallback === "download" ? "\u5F53\u524D\u6587\u4EF6\u53EF\u4E0B\u8F7D\u540E\u67E5\u770B" : "\u5F53\u524D\u6587\u4EF6\u6682\u4E0D\u652F\u6301\u5728\u7EBF\u9884\u89C8";
-      const meta = createFallbackMeta(ctx.file);
+      title.textContent = ctx.options.fallback === "download" ? ctx.options.messages.downloadTitle : ctx.options.messages.unsupportedTitle;
+      const meta = createFallbackMeta(ctx.file, ctx.options.messages);
       const download = document.createElement("a");
       download.href = url;
       download.download = ctx.file.name;
-      download.textContent = "\u4E0B\u8F7D\u6587\u4EF6";
+      download.textContent = ctx.options.messages.downloadFile;
       panel.append(title, meta, download);
       ctx.viewport.classList.add("ofv-center");
       ctx.viewport.append(panel);
@@ -644,14 +686,14 @@ function fallbackPlugin() {
     }
   };
 }
-function createFallbackMeta(file) {
+function createFallbackMeta(file, messages) {
   const meta = document.createElement("dl");
   meta.className = "ofv-fallback-meta";
-  appendFallbackMeta(meta, "\u6587\u4EF6", file.name || "\u672A\u547D\u540D\u6587\u4EF6");
-  appendFallbackMeta(meta, "\u683C\u5F0F", file.extension ? `.${file.extension}` : "\u672A\u77E5");
-  appendFallbackMeta(meta, "MIME", file.mimeType || "\u672A\u58F0\u660E");
-  appendFallbackMeta(meta, "\u5927\u5C0F", file.size === void 0 ? "\u672A\u77E5" : formatFallbackBytes(file.size));
-  appendFallbackMeta(meta, "\u6765\u6E90", file.url ? "\u8FDC\u7A0B URL" : "\u672C\u5730/\u5185\u5B58\u6587\u4EF6");
+  appendFallbackMeta(meta, messages.file, file.name || messages.unnamedFile);
+  appendFallbackMeta(meta, messages.format, file.extension ? `.${file.extension}` : messages.unknown);
+  appendFallbackMeta(meta, messages.mime, file.mimeType || messages.undeclared);
+  appendFallbackMeta(meta, messages.size, file.size === void 0 ? messages.unknown : formatFallbackBytes(file.size));
+  appendFallbackMeta(meta, messages.source, file.url ? messages.remoteUrl : messages.localFile);
   return meta;
 }
 function appendFallbackMeta(parent, label, value) {
@@ -709,15 +751,17 @@ function createViewer(options) {
   host.append(status, viewport);
   container.replaceChildren(host);
   const normalizedOptions = {
+    ...options,
     fit: options.fit || "contain",
     fallback: options.fallback || "inline",
-    ...options
+    zoom: normalizeInitialZoom(options.zoom),
+    messages: resolveMessages(options)
   };
   let destroyed = false;
   let renderToken = 0;
   const setLoading = (loading) => {
     status.hidden = !loading;
-    status.textContent = loading ? "Loading preview..." : "";
+    status.textContent = loading ? normalizedOptions.messages.loading : "";
   };
   const setError = (error) => {
     status.hidden = false;
@@ -873,6 +917,9 @@ function clampIndex(index, length) {
   }
   return Math.min(Math.max(index, 0), length - 1);
 }
+function normalizeInitialZoom(zoom) {
+  return typeof zoom === "number" && Number.isFinite(zoom) && zoom > 0 ? zoom : 1;
+}
 function applyTheme(container, theme) {
   const media = window.matchMedia?.("(prefers-color-scheme: dark)");
   const classes = ["ofv-theme-light", "ofv-theme-dark"];
@@ -1749,6 +1796,98 @@ async function findPlugin(plugins, file) {
   return fallbackPlugin();
 }
 
+// src/plugins/utils.ts
+async function readArrayBuffer(file) {
+  if (file.source instanceof ArrayBuffer) {
+    return file.source;
+  }
+  if (file.blob) {
+    return file.blob.arrayBuffer();
+  }
+  if (typeof file.source === "string") {
+    const response = await fetch(file.source);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch file: ${response.status}`);
+    }
+    return response.arrayBuffer();
+  }
+  throw new Error("Unsupported file source.");
+}
+async function readTextFile(file) {
+  const decode = (buffer) => decodeTextBuffer(buffer);
+  if (typeof file.source === "string") {
+    const response = await fetch(file.source);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch text file: ${response.status}`);
+    }
+    return decode(await response.arrayBuffer());
+  }
+  if (file.blob) {
+    return decode(await file.blob.arrayBuffer());
+  }
+  if (file.source instanceof ArrayBuffer) {
+    return decode(file.source);
+  }
+  return String(file.source);
+}
+function createPanel(className = "") {
+  const panel = document.createElement("div");
+  panel.className = `ofv-panel ${className}`.trim();
+  return panel;
+}
+function getInitialZoom(ctx, min = 0.1, max = 8) {
+  return Math.min(max, Math.max(min, ctx.options.zoom));
+}
+function createSection(title) {
+  const section = document.createElement("section");
+  section.className = "ofv-section";
+  const heading = document.createElement("h3");
+  heading.textContent = title;
+  section.append(heading);
+  return section;
+}
+function appendMeta(parent, label, value) {
+  const row = document.createElement("div");
+  row.className = "ofv-meta-row";
+  const key = document.createElement("span");
+  key.textContent = label;
+  const content = document.createElement("strong");
+  content.textContent = String(value);
+  row.append(key, content);
+  parent.append(row);
+}
+function decodeTextBuffer(buffer) {
+  return decodeTextBytes(new Uint8Array(buffer));
+}
+function decodeTextBytes(bytes) {
+  if (bytes.length >= 3 && bytes[0] === 239 && bytes[1] === 187 && bytes[2] === 191) {
+    return new TextDecoder("utf-8").decode(bytes.subarray(3));
+  }
+  if (bytes.length >= 2) {
+    if (bytes[0] === 255 && bytes[1] === 254) {
+      return new TextDecoder("utf-16le").decode(bytes.subarray(2));
+    }
+    if (bytes[0] === 254 && bytes[1] === 255) {
+      return new TextDecoder("utf-16be").decode(bytes.subarray(2));
+    }
+  }
+  try {
+    return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+  } catch {
+    return decodeWithFallback(bytes, "gb18030") || decodeWithFallback(bytes, "gbk") || new TextDecoder("utf-8").decode(bytes);
+  }
+}
+function decodeWithFallback(bytes, encoding) {
+  try {
+    return new TextDecoder(encoding).decode(bytes);
+  } catch {
+    return void 0;
+  }
+}
+function resolveFormat(file, mimeMap) {
+  return file.extension || mimeMap[file.mimeType] || "";
+}
+
 // src/plugins/image.ts
 var imageExtensions = /* @__PURE__ */ new Set([
   "jpg",
@@ -1862,7 +2001,7 @@ function imagePlugin() {
         canvasSource.setAttribute("role", "img");
         canvasSource.setAttribute("aria-label", ctx.file.name);
       }
-      let scale = 1;
+      let scale = getInitialZoom(ctx);
       let rotation = 0;
       let offsetX = 0;
       let offsetY = 0;
@@ -3690,95 +3829,6 @@ function readAiffExtended(bytes, offset) {
   return mantissa * Math.pow(2, exponent - 16383 - 63);
 }
 
-// src/plugins/utils.ts
-async function readArrayBuffer(file) {
-  if (file.source instanceof ArrayBuffer) {
-    return file.source;
-  }
-  if (file.blob) {
-    return file.blob.arrayBuffer();
-  }
-  if (typeof file.source === "string") {
-    const response = await fetch(file.source);
-    if (!response.ok) {
-      throw new Error(`Failed to fetch file: ${response.status}`);
-    }
-    return response.arrayBuffer();
-  }
-  throw new Error("Unsupported file source.");
-}
-async function readTextFile(file) {
-  const decode = (buffer) => decodeTextBuffer(buffer);
-  if (typeof file.source === "string") {
-    const response = await fetch(file.source);
-    if (!response.ok) {
-      throw new Error(`Failed to fetch text file: ${response.status}`);
-    }
-    return decode(await response.arrayBuffer());
-  }
-  if (file.blob) {
-    return decode(await file.blob.arrayBuffer());
-  }
-  if (file.source instanceof ArrayBuffer) {
-    return decode(file.source);
-  }
-  return String(file.source);
-}
-function createPanel(className = "") {
-  const panel = document.createElement("div");
-  panel.className = `ofv-panel ${className}`.trim();
-  return panel;
-}
-function createSection(title) {
-  const section = document.createElement("section");
-  section.className = "ofv-section";
-  const heading = document.createElement("h3");
-  heading.textContent = title;
-  section.append(heading);
-  return section;
-}
-function appendMeta(parent, label, value) {
-  const row = document.createElement("div");
-  row.className = "ofv-meta-row";
-  const key = document.createElement("span");
-  key.textContent = label;
-  const content = document.createElement("strong");
-  content.textContent = String(value);
-  row.append(key, content);
-  parent.append(row);
-}
-function decodeTextBuffer(buffer) {
-  return decodeTextBytes(new Uint8Array(buffer));
-}
-function decodeTextBytes(bytes) {
-  if (bytes.length >= 3 && bytes[0] === 239 && bytes[1] === 187 && bytes[2] === 191) {
-    return new TextDecoder("utf-8").decode(bytes.subarray(3));
-  }
-  if (bytes.length >= 2) {
-    if (bytes[0] === 255 && bytes[1] === 254) {
-      return new TextDecoder("utf-16le").decode(bytes.subarray(2));
-    }
-    if (bytes[0] === 254 && bytes[1] === 255) {
-      return new TextDecoder("utf-16be").decode(bytes.subarray(2));
-    }
-  }
-  try {
-    return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-  } catch {
-    return decodeWithFallback(bytes, "gb18030") || decodeWithFallback(bytes, "gbk") || new TextDecoder("utf-8").decode(bytes);
-  }
-}
-function decodeWithFallback(bytes, encoding) {
-  try {
-    return new TextDecoder(encoding).decode(bytes);
-  } catch {
-    return void 0;
-  }
-}
-function resolveFormat(file, mimeMap) {
-  return file.extension || mimeMap[file.mimeType] || "";
-}
-
 // src/plugins/text.ts
 var langMap = {
   js: "javascript",
@@ -4247,7 +4297,7 @@ function textPlugin() {
   };
 }
 function createTextZoomController(target, cssVariable, ctx) {
-  let zoom = 1;
+  let zoom = getInitialZoom(ctx, 0.5, 3);
   const apply = () => {
     const normalized = Math.round(zoom * 100) / 100;
     target.style.setProperty(cssVariable, String(normalized));
@@ -4557,6 +4607,7 @@ function pdfPlugin(options = {}) {
         viewport: ctx.viewport,
         size: ctx.size,
         fit: ctx.options.fit,
+        zoom: ctx.options.zoom,
         toolbar: ctx.toolbar,
         encryptedTitle: "PDF \u5DF2\u52A0\u5BC6\uFF0C\u65E0\u6CD5\u5728\u7EBF\u9884\u89C8",
         encryptedMessage: "\u8BF7\u4E0B\u8F7D\u540E\u4F7F\u7528\u5BC6\u7801\u6253\u5F00\uFF0C\u6216\u4E0A\u4F20\u89E3\u5BC6\u540E\u7684 PDF \u6587\u4EF6\u3002",
@@ -4662,7 +4713,7 @@ async function renderPdfDocumentPreview(options) {
   const pageStates = [];
   let observer = null;
   let currentSize = options.size;
-  let zoomFactor = 1;
+  let zoomFactor = getInitialZoom({ options: { zoom: options.zoom ?? 1 } }, 0.25, 4);
   let rotation = 0;
   const updateSummary = () => {
     renderPdfSummary(summary, pdfDocument.numPages, pagesMeta, options.fit, zoomFactor);
@@ -5987,6 +6038,7 @@ async function renderConvertedOfficePreview(panel, ctx, options, conversionConte
     viewport: panel,
     size: ctx.size,
     fit: ctx.options.fit,
+    zoom: ctx.options.zoom,
     toolbar: ctx.toolbar,
     title: "Office \u9AD8\u4FDD\u771F\u8F6C\u6362\u9884\u89C8",
     fallbackTitle: "Office \u8F6C\u6362\u540E\u7684 PDF \u65E0\u6CD5\u9884\u89C8",
@@ -6050,7 +6102,7 @@ function createOfficeZoomController(panel, ctx) {
   if (!canZoom) {
     return void 0;
   }
-  let zoom = 1;
+  let zoom = getInitialZoom(ctx, 0.5, 3);
   const apply = () => {
     panel.style.setProperty("--ofv-office-zoom", String(zoom));
     panel.dispatchEvent(new CustomEvent("ofv-office-zoom"));
@@ -18870,7 +18922,7 @@ async function createPostScriptPreview(bytes, url, fileName, size, fit, toolbar)
   preview.append(summary);
   return { element: preview };
 }
-async function createPdfCompatibleAiPreview(bytes, url, fileName, size, fit, toolbar, pdfOffset = 0) {
+async function createPdfCompatibleAiPreview(bytes, url, fileName, size, fit, toolbar, pdfOffset = 0, zoom = 1) {
   const wrapper = document.createElement("div");
   wrapper.className = "ofv-ai-pdf-preview";
   let pdfUrl = url;
@@ -18885,6 +18937,7 @@ async function createPdfCompatibleAiPreview(bytes, url, fileName, size, fit, too
     viewport: wrapper,
     size,
     fit,
+    zoom,
     toolbar,
     fallbackTitle: "AI PDF \u517C\u5BB9\u9884\u89C8\u5931\u8D25",
     revokeUrlOnDestroy: false