@lamberl-lee/file-preview 0.2.0

package/dist/core/i18n.js

@@ -0,0 +1,200 @@
+const zhCN = {
+  // View mode bar
+  preview: "\u9884\u89C8",
+  source: "\u6E90\u7801",
+  split: "\u5206\u680F",
+  // Common actions
+  download: "\u4E0B\u8F7D",
+  copy: "\u590D\u5236",
+  search: "\u641C\u7D22...",
+  zoomIn: "\u653E\u5927",
+  zoomOut: "\u7F29\u5C0F",
+  reset: "\u91CD\u7F6E",
+  fullscreen: "\u5168\u5C4F",
+  previous: "\u4E0A\u4E00\u4E2A",
+  next: "\u4E0B\u4E00\u4E2A",
+  // Page / slide units
+  page: "\u9875",
+  pages: "\u9875",
+  slideView: "\u5E7B\u706F\u7247\u89C6\u56FE",
+  gridView: "\u7F29\u7565\u56FE\u89C6\u56FE",
+  previousPage: "\u4E0A\u4E00\u9875 (\u2190)",
+  nextPage: "\u4E0B\u4E00\u9875 (\u2192)",
+  // Loading states
+  loadingPreview: "\u52A0\u8F7D\u9884\u89C8\u4E2D...",
+  loadingRtf: "\u6B63\u5728\u89E3\u6790 RTF...",
+  loadingSpreadsheet: "\u6B63\u5728\u89E3\u6790\u8868\u683C...",
+  loadingEbook: "Loading e-book...",
+  loadingPresentation: "\u6B63\u5728\u89E3\u6790\u6F14\u793A\u6587\u7A3F...",
+  // Error states
+  previewFailed: "\u9884\u89C8\u5931\u8D25",
+  parseFailed: "\u89E3\u6790\u5931\u8D25",
+  formatNotSupported: "\u683C\u5F0F\u4E0D\u652F\u6301",
+  // Legacy office formats
+  legacyDocTitle: "\u65E7\u7248 Word \u683C\u5F0F\u6682\u4E0D\u652F\u6301",
+  legacyPptTitle: "\u65E7\u7248 PowerPoint \u683C\u5F0F\u6682\u4E0D\u652F\u6301",
+  legacyXlsTitle: "\u65E7\u7248 Excel \u683C\u5F0F\u6682\u4E0D\u652F\u6301",
+  legacyDocDesc: "\u8BE5\u6587\u4EF6\u4E3A\u65E7\u7248 .doc \u4E8C\u8FDB\u5236\u683C\u5F0F\uFF0C\u5F53\u524D\u6D4F\u89C8\u5668\u7AEF\u9884\u89C8\u4EC5\u652F\u6301 .docx\u3002\u5EFA\u8BAE\u4F7F\u7528 Word \u6216 WPS \u5C06\u6587\u4EF6\u53E6\u5B58\u4E3A .docx \u540E\u91CD\u8BD5\u3002",
+  legacyPptDesc: "\u8BE5\u6587\u4EF6\u4E3A\u65E7\u7248 .ppt \u4E8C\u8FDB\u5236\u683C\u5F0F\uFF0C\u5F53\u524D\u4EC5\u652F\u6301 Open XML \u683C\u5F0F\uFF08.pptx\uFF09\u3002\u5EFA\u8BAE\u4F7F\u7528 PowerPoint \u6216 WPS \u5C06\u6587\u4EF6\u53E6\u5B58\u4E3A .pptx \u683C\u5F0F\u540E\u91CD\u8BD5\u3002",
+  legacyXlsDesc: "\u8BE5\u6587\u4EF6\u4E3A\u65E7\u7248 .xls \u4E8C\u8FDB\u5236\u683C\u5F0F\uFF0C\u5F53\u524D\u4EC5\u652F\u6301 Open XML \u683C\u5F0F\uFF08.xlsx/.xlsm\uFF09\u3002\u5EFA\u8BAE\u4F7F\u7528 Excel \u6216 WPS \u5C06\u6587\u4EF6\u53E6\u5B58\u4E3A .xlsx \u683C\u5F0F\u540E\u91CD\u8BD5\u3002",
+  legacyXlsFallbackDesc: "\u5F53\u524D\u6587\u4EF6\u4E3A\u65E7\u7248 .xls \u683C\u5F0F\uFF0C\u90E8\u5206\u5185\u5BB9\u53EF\u80FD\u65E0\u6CD5\u5B8C\u6574\u663E\u793A\u3002\u5EFA\u8BAE\u53E6\u5B58\u4E3A .xlsx \u683C\u5F0F\u4EE5\u83B7\u5F97\u6700\u4F73\u9884\u89C8\u6548\u679C\u3002",
+  legacyXlsError: "\u8BE5\u6587\u4EF6\u4E3A\u65E7\u7248 Excel \u4E8C\u8FDB\u5236\u683C\u5F0F\uFF08.xls\uFF09\uFF0C\u5F53\u524D\u4EC5\u652F\u6301 Open XML \u683C\u5F0F\uFF08.xlsx/.xlsm\uFF09\u3002\u5EFA\u8BAE\u4F7F\u7528 Excel \u6216 WPS \u5C06\u6587\u4EF6\u53E6\u5B58\u4E3A .xlsx \u683C\u5F0F\u540E\u91CD\u8BD5\u3002",
+  legacyXlsBanner: "\u65E7\u7248 Excel \u683C\u5F0F\u6682\u4E0D\u652F\u6301",
+  unsupportedFileType: "\u8BE5\u6587\u4EF6\u7C7B\u578B ({fileType}) \u6682\u4E0D\u652F\u6301\u6D4F\u89C8\u5668\u7AEF\u9884\u89C8\u3002",
+  // Large file
+  largeFileHint: "\u5F53\u524D\u6587\u4EF6\u8F83\u5927\uFF0C\u6D4F\u89C8\u5668\u7AEF\u89E3\u6790\u53EF\u80FD\u9700\u8981\u66F4\u957F\u65F6\u95F4\uFF0C\u671F\u95F4\u9875\u9762\u53EF\u80FD\u77ED\u6682\u5361\u987F\u3002",
+  largeFile: "\u5927\u6587\u4EF6",
+  largeFileRows: "\u884C",
+  largeFileCols: "\u5217",
+  largeFileImages: "\u5F20\u56FE\u7247",
+  largeFileFastModeBanner: "\u5F53\u524D Excel \u6587\u4EF6\u8F83\u5927\uFF08{fileSize}\uFF09\uFF0C\u5DF2\u9ED8\u8BA4\u4F7F\u7528\u5FEB\u901F\u6A21\u5F0F\uFF1A\u4EC5\u6E32\u67D3\u524D {rowLimit} \u884C\uFF0C\u5E76\u8DF3\u8FC7\u56FE\u7247\u89E3\u6790\u3002",
+  largeFileFidelityBanner: "\u5F53\u524D\u6B63\u5728\u4F7F\u7528\u9AD8\u4FDD\u771F\u6A21\u5F0F\u9884\u89C8\u5927\u6587\u4EF6\uFF0C\u53EF\u80FD\u5BFC\u81F4\u6D4F\u89C8\u5668\u5361\u987F\u3002",
+  largeFileFidelityConfirm: "\u5F53\u524D Excel \u6587\u4EF6\u5927\u5C0F\u4E3A {fileSize}\uFF0C\u9AD8\u4FDD\u771F\u6A21\u5F0F\u53EF\u80FD\u5BFC\u81F4\u6D4F\u89C8\u5668\u5361\u987F\u751A\u81F3\u65E0\u54CD\u5E94\u3002\u662F\u5426\u7EE7\u7EED\uFF1F",
+  truncatedRows: "\u6570\u636E\u91CF\u8F83\u5927\uFF0C\u4EC5\u663E\u793A\u524D {shown} \u884C\uFF08\u5171 {total} \u884C\uFF09",
+  // Spreadsheet
+  sheetNotFound: "\u672A\u627E\u5230\u5DE5\u4F5C\u8868",
+  fastMode: "\u5FEB\u901F",
+  fidelityMode: "\u9AD8\u4FDD\u771F",
+  fastModeTitle: "\u5FEB\u901F\u6A21\u5F0F\uFF1A\u9650\u5236\u884C\u6570\uFF0C\u8DF3\u8FC7\u56FE\u7247\u548C\u590D\u6742\u6837\u5F0F",
+  fidelityModeTitle: "\u9AD8\u4FDD\u771F\u6A21\u5F0F\uFF1A\u4FDD\u7559\u6837\u5F0F\u3001\u56FE\u7247\u3001\u6279\u6CE8",
+  noData: "\u65E0\u6570\u636E",
+  noSearchResults: "\u672A\u627E\u5230\u5339\u914D\u6570\u636E",
+  comment: "\u6279\u6CE8",
+  unsupportedImageFormat: "\u4E0D\u652F\u6301\u7684\u56FE\u7247\u683C\u5F0F",
+  unknown: "\u672A\u77E5",
+  downloadOriginal: "\u4E0B\u8F7D\u539F\u6587\u4EF6",
+  // Plain text
+  lines: "\u884C",
+  wordWrapOn: "\u5F00\u542F\u81EA\u52A8\u6362\u884C",
+  wordWrapOff: "\u5173\u95ED\u81EA\u52A8\u6362\u884C",
+  copyContent: "\u590D\u5236\u5185\u5BB9",
+  // Markdown
+  oversizedCodeBlock: "\u5927\u4EE3\u7801\u5757",
+  // RTF
+  rtfFallback: "\u5BCC\u6587\u672C\u6E32\u67D3\u4E0D\u53EF\u7528\uFF0C\u5DF2\u964D\u7EA7\u4E3A\u7EAF\u6587\u672C\u9884\u89C8",
+  rtfNoText: "\u65E0\u6CD5\u4ECE\u6587\u4EF6\u4E2D\u63D0\u53D6\u6587\u672C\u5185\u5BB9\u3002",
+  showErrorDetails: "\u67E5\u770B\u9519\u8BEF\u8BE6\u60C5",
+  // EPUB
+  noChaptersFound: "No Chapters Found",
+  ebookLoadFailed: "Failed to Load E-book",
+  unknownError: "\u672A\u77E5\u9519\u8BEF",
+  tableOfContents: "Table of Contents",
+  foundInChapters: "Found in {count} chapter(s)",
+  noResultsFound: "\u672A\u627E\u5230\u7ED3\u679C",
+  searchPlaceholder: "\u641C\u7D22...",
+  // Shared fallback
+  previewNotAvailable: "\u9884\u89C8\u4E0D\u53EF\u7528",
+  failedToLoadPreview: "\u9884\u89C8\u52A0\u8F7D\u5931\u8D25",
+  failedToReadFile: "\u6587\u4EF6\u8BFB\u53D6\u5931\u8D25",
+  loadingCancelled: "\u52A0\u8F7D\u5DF2\u53D6\u6D88",
+  copyCode: "\u590D\u5236\u4EE3\u7801"
+};
+const enUS = {
+  // View mode bar
+  preview: "Preview",
+  source: "Source",
+  split: "Split",
+  // Common actions
+  download: "Download",
+  copy: "Copy",
+  search: "Search...",
+  zoomIn: "Zoom In",
+  zoomOut: "Zoom Out",
+  reset: "Reset",
+  fullscreen: "Fullscreen",
+  previous: "Previous",
+  next: "Next",
+  // Page / slide units
+  page: "page",
+  pages: "pages",
+  slideView: "Slide View",
+  gridView: "Grid View",
+  previousPage: "Previous Page (\u2190)",
+  nextPage: "Next Page (\u2192)",
+  // Loading states
+  loadingPreview: "Loading preview...",
+  loadingRtf: "Parsing RTF...",
+  loadingSpreadsheet: "Parsing spreadsheet...",
+  loadingEbook: "Loading e-book...",
+  loadingPresentation: "Parsing presentation...",
+  // Error states
+  previewFailed: "Preview Failed",
+  parseFailed: "Parse Failed",
+  formatNotSupported: "Format Not Supported",
+  // Legacy office formats
+  legacyDocTitle: "Legacy Word format not supported",
+  legacyPptTitle: "Legacy PowerPoint format not supported",
+  legacyXlsTitle: "Legacy Excel format not supported",
+  legacyDocDesc: "This file is in the legacy .doc binary format. Browser-side preview only supports .docx. Please use Word or WPS to save the file as .docx and try again.",
+  legacyPptDesc: "This file is in the legacy .ppt binary format. Only the Open XML format (.pptx) is supported. Please use PowerPoint or WPS to save the file as .pptx and try again.",
+  legacyXlsDesc: "This file is in the legacy .xls binary format. Only the Open XML format (.xlsx/.xlsm) is supported. Please use Excel or WPS to save the file as .xlsx and try again.",
+  legacyXlsFallbackDesc: "This file is in the legacy .xls format. Some content may not display correctly. Please save as .xlsx for the best preview experience.",
+  legacyXlsError: "This file is in the legacy .xls binary format. Only the Open XML format (.xlsx/.xlsm) is supported. Please use Excel or WPS to save the file as .xlsx and try again.",
+  legacyXlsBanner: "Legacy Excel format not supported",
+  unsupportedFileType: "File type ({fileType}) is not supported for browser-side preview.",
+  // Large file
+  largeFileHint: "This file is large. Browser-side parsing may take longer and the page may briefly freeze.",
+  largeFile: "Large File",
+  largeFileRows: "rows",
+  largeFileCols: "cols",
+  largeFileImages: "images",
+  largeFileFastModeBanner: "This Excel file is large ({fileSize}). Fast mode is enabled by default: only the first {rowLimit} rows are rendered and image parsing is skipped.",
+  largeFileFidelityBanner: "You are using fidelity mode to preview a large file. This may cause the browser to freeze.",
+  largeFileFidelityConfirm: "This Excel file is {fileSize}. Fidelity mode may cause the browser to freeze or become unresponsive. Continue?",
+  truncatedRows: "Data is large. Showing first {shown} of {total} rows",
+  // Spreadsheet
+  sheetNotFound: "No Sheets Found",
+  fastMode: "Fast",
+  fidelityMode: "Fidelity",
+  fastModeTitle: "Fast mode: limited rows, skip images and complex styles",
+  fidelityModeTitle: "Fidelity mode: preserve styles, images, and comments",
+  noData: "No data",
+  noSearchResults: "No matching data found",
+  comment: "Comment",
+  unsupportedImageFormat: "Unsupported image format",
+  unknown: "Unknown",
+  downloadOriginal: "Download Original",
+  // Plain text
+  lines: "lines",
+  wordWrapOn: "Enable word wrap",
+  wordWrapOff: "Disable word wrap",
+  copyContent: "Copy content",
+  // Markdown
+  oversizedCodeBlock: "Large code block",
+  // RTF
+  rtfFallback: "Rich text rendering unavailable, fallback to plain text preview",
+  rtfNoText: "Unable to extract text content from file.",
+  showErrorDetails: "Show error details",
+  // EPUB
+  noChaptersFound: "No Chapters Found",
+  ebookLoadFailed: "Failed to Load E-book",
+  unknownError: "Unknown error",
+  tableOfContents: "Table of Contents",
+  foundInChapters: "Found in {count} chapter(s)",
+  noResultsFound: "No results found",
+  searchPlaceholder: "Search...",
+  // Shared fallback
+  previewNotAvailable: "Preview Not Available",
+  failedToLoadPreview: "Failed to Load Preview",
+  failedToReadFile: "Failed to Read File",
+  loadingCancelled: "Loading Cancelled",
+  copyCode: "Copy code"
+};
+import { createContext, useContext } from "react";
+const defaultLocale = zhCN;
+const LocaleContext = createContext(defaultLocale);
+const LocaleProvider = LocaleContext.Provider;
+function useLocale() {
+  return useContext(LocaleContext);
+}
+function getDefaultLocale() {
+  return defaultLocale;
+}
+export {
+  LocaleProvider,
+  enUS,
+  getDefaultLocale,
+  useLocale,
+  zhCN
+};
+//# sourceMappingURL=i18n.js.map

package/dist/core/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/i18n.ts"],"sourcesContent":["/**\n * FileVista i18n — locale messages for all UI strings.\n *\n * Library consumers can import and override any locale, or provide\n * a fully custom translation via `<FileVistaProvider locale={...}>`.\n *\n * Usage in components:\n *   import { useLocale } from \"./core/i18n\";\n *   const t = useLocale();\n *   <button>{t.preview}</button>\n */\n\n// ─── Type definition ───\n\nexport interface LocaleMessages {\n  // View mode bar\n  preview: string;\n  source: string;\n  split: string;\n\n  // Common actions\n  download: string;\n  copy: string;\n  search: string;\n  zoomIn: string;\n  zoomOut: string;\n  reset: string;\n  fullscreen: string;\n  previous: string;\n  next: string;\n\n  // Page / slide units\n  page: string;\n  pages: string;\n  slideView: string;\n  gridView: string;\n  previousPage: string;\n  nextPage: string;\n\n  // Loading states\n  loadingPreview: string;\n  loadingRtf: string;\n  loadingSpreadsheet: string;\n  loadingEbook: string;\n  loadingPresentation: string;\n\n  // Error states\n  previewFailed: string;\n  parseFailed: string;\n  formatNotSupported: string;\n\n  // Legacy office formats\n  legacyDocTitle: string;\n  legacyPptTitle: string;\n  legacyXlsTitle: string;\n  legacyDocDesc: string;\n  legacyPptDesc: string;\n  legacyXlsDesc: string;\n  legacyXlsFallbackDesc: string;\n  legacyXlsError: string;\n  legacyXlsBanner: string;\n  unsupportedFileType: string;\n\n  // Large file\n  largeFileHint: string;\n  largeFile: string;\n  largeFileRows: string;\n  largeFileCols: string;\n  largeFileImages: string;\n  largeFileFastModeBanner: string;\n  largeFileFidelityBanner: string;\n  largeFileFidelityConfirm: string;\n  truncatedRows: string;\n\n  // Spreadsheet\n  sheetNotFound: string;\n  fastMode: string;\n  fidelityMode: string;\n  fastModeTitle: string;\n  fidelityModeTitle: string;\n  noData: string;\n  noSearchResults: string;\n  comment: string;\n  unsupportedImageFormat: string;\n  unknown: string;\n  downloadOriginal: string;\n\n  // Plain text\n  lines: string;\n  wordWrapOn: string;\n  wordWrapOff: string;\n  copyContent: string;\n\n  // Markdown\n  oversizedCodeBlock: string;\n\n  // RTF\n  rtfFallback: string;\n  rtfNoText: string;\n  showErrorDetails: string;\n\n  // EPUB\n  noChaptersFound: string;\n  ebookLoadFailed: string;\n  unknownError: string;\n  tableOfContents: string;\n  foundInChapters: string;\n  noResultsFound: string;\n  searchPlaceholder: string;\n\n  // Shared fallback\n  previewNotAvailable: string;\n  failedToLoadPreview: string;\n  failedToReadFile: string;\n  loadingCancelled: string;\n  copyCode: string;\n}\n\n// ─── zh-CN (default) ───\n\nexport const zhCN: LocaleMessages = {\n  // View mode bar\n  preview: \"预览\",\n  source: \"源码\",\n  split: \"分栏\",\n\n  // Common actions\n  download: \"下载\",\n  copy: \"复制\",\n  search: \"搜索...\",\n  zoomIn: \"放大\",\n  zoomOut: \"缩小\",\n  reset: \"重置\",\n  fullscreen: \"全屏\",\n  previous: \"上一个\",\n  next: \"下一个\",\n\n  // Page / slide units\n  page: \"页\",\n  pages: \"页\",\n  slideView: \"幻灯片视图\",\n  gridView: \"缩略图视图\",\n  previousPage: \"上一页 (←)\",\n  nextPage: \"下一页 (→)\",\n\n  // Loading states\n  loadingPreview: \"加载预览中...\",\n  loadingRtf: \"正在解析 RTF...\",\n  loadingSpreadsheet: \"正在解析表格...\",\n  loadingEbook: \"Loading e-book...\",\n  loadingPresentation: \"正在解析演示文稿...\",\n\n  // Error states\n  previewFailed: \"预览失败\",\n  parseFailed: \"解析失败\",\n  formatNotSupported: \"格式不支持\",\n\n  // Legacy office formats\n  legacyDocTitle: \"旧版 Word 格式暂不支持\",\n  legacyPptTitle: \"旧版 PowerPoint 格式暂不支持\",\n  legacyXlsTitle: \"旧版 Excel 格式暂不支持\",\n  legacyDocDesc: \"该文件为旧版 .doc 二进制格式，当前浏览器端预览仅支持 .docx。建议使用 Word 或 WPS 将文件另存为 .docx 后重试。\",\n  legacyPptDesc: \"该文件为旧版 .ppt 二进制格式，当前仅支持 Open XML 格式（.pptx）。建议使用 PowerPoint 或 WPS 将文件另存为 .pptx 格式后重试。\",\n  legacyXlsDesc: \"该文件为旧版 .xls 二进制格式，当前仅支持 Open XML 格式（.xlsx/.xlsm）。建议使用 Excel 或 WPS 将文件另存为 .xlsx 格式后重试。\",\n  legacyXlsFallbackDesc: \"当前文件为旧版 .xls 格式，部分内容可能无法完整显示。建议另存为 .xlsx 格式以获得最佳预览效果。\",\n  legacyXlsError: \"该文件为旧版 Excel 二进制格式（.xls），当前仅支持 Open XML 格式（.xlsx/.xlsm）。建议使用 Excel 或 WPS 将文件另存为 .xlsx 格式后重试。\",\n  legacyXlsBanner: \"旧版 Excel 格式暂不支持\",\n  unsupportedFileType: \"该文件类型 ({fileType}) 暂不支持浏览器端预览。\",\n\n  // Large file\n  largeFileHint: \"当前文件较大，浏览器端解析可能需要更长时间，期间页面可能短暂卡顿。\",\n  largeFile: \"大文件\",\n  largeFileRows: \"行\",\n  largeFileCols: \"列\",\n  largeFileImages: \"张图片\",\n  largeFileFastModeBanner: \"当前 Excel 文件较大（{fileSize}），已默认使用快速模式：仅渲染前 {rowLimit} 行，并跳过图片解析。\",\n  largeFileFidelityBanner: \"当前正在使用高保真模式预览大文件，可能导致浏览器卡顿。\",\n  largeFileFidelityConfirm: \"当前 Excel 文件大小为 {fileSize}，高保真模式可能导致浏览器卡顿甚至无响应。是否继续？\",\n  truncatedRows: \"数据量较大，仅显示前 {shown} 行（共 {total} 行）\",\n\n  // Spreadsheet\n  sheetNotFound: \"未找到工作表\",\n  fastMode: \"快速\",\n  fidelityMode: \"高保真\",\n  fastModeTitle: \"快速模式：限制行数，跳过图片和复杂样式\",\n  fidelityModeTitle: \"高保真模式：保留样式、图片、批注\",\n  noData: \"无数据\",\n  noSearchResults: \"未找到匹配数据\",\n  comment: \"批注\",\n  unsupportedImageFormat: \"不支持的图片格式\",\n  unknown: \"未知\",\n  downloadOriginal: \"下载原文件\",\n\n  // Plain text\n  lines: \"行\",\n  wordWrapOn: \"开启自动换行\",\n  wordWrapOff: \"关闭自动换行\",\n  copyContent: \"复制内容\",\n\n  // Markdown\n  oversizedCodeBlock: \"大代码块\",\n\n  // RTF\n  rtfFallback: \"富文本渲染不可用，已降级为纯文本预览\",\n  rtfNoText: \"无法从文件中提取文本内容。\",\n  showErrorDetails: \"查看错误详情\",\n\n  // EPUB\n  noChaptersFound: \"No Chapters Found\",\n  ebookLoadFailed: \"Failed to Load E-book\",\n  unknownError: \"未知错误\",\n  tableOfContents: \"Table of Contents\",\n  foundInChapters: \"Found in {count} chapter(s)\",\n  noResultsFound: \"未找到结果\",\n  searchPlaceholder: \"搜索...\",\n\n  // Shared fallback\n  previewNotAvailable: \"预览不可用\",\n  failedToLoadPreview: \"预览加载失败\",\n  failedToReadFile: \"文件读取失败\",\n  loadingCancelled: \"加载已取消\",\n  copyCode: \"复制代码\",\n};\n\n// ─── en-US ───\n\nexport const enUS: LocaleMessages = {\n  // View mode bar\n  preview: \"Preview\",\n  source: \"Source\",\n  split: \"Split\",\n\n  // Common actions\n  download: \"Download\",\n  copy: \"Copy\",\n  search: \"Search...\",\n  zoomIn: \"Zoom In\",\n  zoomOut: \"Zoom Out\",\n  reset: \"Reset\",\n  fullscreen: \"Fullscreen\",\n  previous: \"Previous\",\n  next: \"Next\",\n\n  // Page / slide units\n  page: \"page\",\n  pages: \"pages\",\n  slideView: \"Slide View\",\n  gridView: \"Grid View\",\n  previousPage: \"Previous Page (←)\",\n  nextPage: \"Next Page (→)\",\n\n  // Loading states\n  loadingPreview: \"Loading preview...\",\n  loadingRtf: \"Parsing RTF...\",\n  loadingSpreadsheet: \"Parsing spreadsheet...\",\n  loadingEbook: \"Loading e-book...\",\n  loadingPresentation: \"Parsing presentation...\",\n\n  // Error states\n  previewFailed: \"Preview Failed\",\n  parseFailed: \"Parse Failed\",\n  formatNotSupported: \"Format Not Supported\",\n\n  // Legacy office formats\n  legacyDocTitle: \"Legacy Word format not supported\",\n  legacyPptTitle: \"Legacy PowerPoint format not supported\",\n  legacyXlsTitle: \"Legacy Excel format not supported\",\n  legacyDocDesc: \"This file is in the legacy .doc binary format. Browser-side preview only supports .docx. Please use Word or WPS to save the file as .docx and try again.\",\n  legacyPptDesc: \"This file is in the legacy .ppt binary format. Only the Open XML format (.pptx) is supported. Please use PowerPoint or WPS to save the file as .pptx and try again.\",\n  legacyXlsDesc: \"This file is in the legacy .xls binary format. Only the Open XML format (.xlsx/.xlsm) is supported. Please use Excel or WPS to save the file as .xlsx and try again.\",\n  legacyXlsFallbackDesc: \"This file is in the legacy .xls format. Some content may not display correctly. Please save as .xlsx for the best preview experience.\",\n  legacyXlsError: \"This file is in the legacy .xls binary format. Only the Open XML format (.xlsx/.xlsm) is supported. Please use Excel or WPS to save the file as .xlsx and try again.\",\n  legacyXlsBanner: \"Legacy Excel format not supported\",\n  unsupportedFileType: \"File type ({fileType}) is not supported for browser-side preview.\",\n\n  // Large file\n  largeFileHint: \"This file is large. Browser-side parsing may take longer and the page may briefly freeze.\",\n  largeFile: \"Large File\",\n  largeFileRows: \"rows\",\n  largeFileCols: \"cols\",\n  largeFileImages: \"images\",\n  largeFileFastModeBanner: \"This Excel file is large ({fileSize}). Fast mode is enabled by default: only the first {rowLimit} rows are rendered and image parsing is skipped.\",\n  largeFileFidelityBanner: \"You are using fidelity mode to preview a large file. This may cause the browser to freeze.\",\n  largeFileFidelityConfirm: \"This Excel file is {fileSize}. Fidelity mode may cause the browser to freeze or become unresponsive. Continue?\",\n  truncatedRows: \"Data is large. Showing first {shown} of {total} rows\",\n\n  // Spreadsheet\n  sheetNotFound: \"No Sheets Found\",\n  fastMode: \"Fast\",\n  fidelityMode: \"Fidelity\",\n  fastModeTitle: \"Fast mode: limited rows, skip images and complex styles\",\n  fidelityModeTitle: \"Fidelity mode: preserve styles, images, and comments\",\n  noData: \"No data\",\n  noSearchResults: \"No matching data found\",\n  comment: \"Comment\",\n  unsupportedImageFormat: \"Unsupported image format\",\n  unknown: \"Unknown\",\n  downloadOriginal: \"Download Original\",\n\n  // Plain text\n  lines: \"lines\",\n  wordWrapOn: \"Enable word wrap\",\n  wordWrapOff: \"Disable word wrap\",\n  copyContent: \"Copy content\",\n\n  // Markdown\n  oversizedCodeBlock: \"Large code block\",\n\n  // RTF\n  rtfFallback: \"Rich text rendering unavailable, fallback to plain text preview\",\n  rtfNoText: \"Unable to extract text content from file.\",\n  showErrorDetails: \"Show error details\",\n\n  // EPUB\n  noChaptersFound: \"No Chapters Found\",\n  ebookLoadFailed: \"Failed to Load E-book\",\n  unknownError: \"Unknown error\",\n  tableOfContents: \"Table of Contents\",\n  foundInChapters: \"Found in {count} chapter(s)\",\n  noResultsFound: \"No results found\",\n  searchPlaceholder: \"Search...\",\n\n  // Shared fallback\n  previewNotAvailable: \"Preview Not Available\",\n  failedToLoadPreview: \"Failed to Load Preview\",\n  failedToReadFile: \"Failed to Read File\",\n  loadingCancelled: \"Loading Cancelled\",\n  copyCode: \"Copy code\",\n};\n\n// ─── Context ───\n\nimport { createContext, useContext } from \"react\";\n\nconst defaultLocale = zhCN;\n\nconst LocaleContext = createContext<LocaleMessages>(defaultLocale);\n\n/** Provider component — wrap your preview tree with this to override locale. */\nexport const LocaleProvider = LocaleContext.Provider;\n\n/** Hook to access the current locale messages. */\nexport function useLocale(): LocaleMessages {\n  return useContext(LocaleContext);\n}\n\n/** Get the default locale (zh-CN). */\nexport function getDefaultLocale(): LocaleMessages {\n  return defaultLocale;\n}\n"],"mappings":"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","names":[]}

package/dist/core/plugin.d.ts

@@ -0,0 +1,38 @@
+import { ComponentType } from 'react';
+import { FileInfo } from './types.js';
+
+interface PreviewPlugin {
+    id: string;
+    name: string;
+    priority?: number;
+    match(file: FileInfo): boolean;
+    load(): Promise<{
+        default: ComponentType<{
+            file: FileInfo;
+        }>;
+    }>;
+}
+/**
+ * Wrap a dynamic-import loader so that, if the import fails because an
+ * optional peer dependency is missing (e.g. `pdfjs-dist`, `exceljs`), the
+ * user sees a clear "install this package" message instead of the raw
+ * bundler error.
+ *
+ * @example
+ * load: loadWithOptionalDep(
+ *   () => import("../preview-adapters/PdfPreviewAdapter"),
+ *   { package: "pdfjs-dist", featureLabel: "PDF preview" },
+ * )
+ */
+declare function loadWithOptionalDep<T>(loader: () => Promise<T>, meta: {
+    package: string;
+    featureLabel: string;
+}): () => Promise<T>;
+declare class MissingPeerDependencyError extends Error {
+    packageName: string;
+    featureLabel: string;
+    cause: unknown;
+    constructor(packageName: string, featureLabel: string, cause: unknown);
+}
+
+export { MissingPeerDependencyError, type PreviewPlugin, loadWithOptionalDep };

package/dist/core/plugin.js

@@ -0,0 +1,46 @@
+function loadWithOptionalDep(loader, meta) {
+  return async () => {
+    try {
+      return await loader();
+    } catch (cause) {
+      if (isModuleNotFoundError(cause, meta.package)) {
+        throw new MissingPeerDependencyError(meta.package, meta.featureLabel, cause);
+      }
+      throw cause;
+    }
+  };
+}
+class MissingPeerDependencyError extends Error {
+  constructor(packageName, featureLabel, cause) {
+    super(
+      `${featureLabel} requires the optional peer dependency "${packageName}".
+
+Install it in your app:
+  pnpm add ${packageName}
+  # or: npm install ${packageName}
+  # or: yarn add ${packageName}
+
+See: https://github.com/CoderLambert/filevista/tree/main/packages/file-preview#optional-peer-dependencies`
+    );
+    this.packageName = packageName;
+    this.featureLabel = featureLabel;
+    this.cause = cause;
+    this.name = "MissingPeerDependencyError";
+  }
+}
+function isModuleNotFoundError(error, packageName) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message ?? "";
+  if (!message) return false;
+  if (!message.includes(packageName)) return false;
+  return message.includes("Cannot find module") || // Node ESM, Webpack
+  message.includes("Failed to fetch dynamically imported module") || // Native browser ESM
+  message.includes("Failed to resolve module specifier") || // Vite dev
+  message.includes("Module not found") || // Webpack production
+  message.includes("Unable to resolve");
+}
+export {
+  MissingPeerDependencyError,
+  loadWithOptionalDep
+};
+//# sourceMappingURL=plugin.js.map

package/dist/core/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/plugin.ts"],"sourcesContent":["import type { ComponentType } from \"react\";\nimport type { FileInfo } from \"../utils\";\n\nexport interface PreviewPlugin {\n  id: string;\n  name: string;\n  priority?: number;\n  match(file: FileInfo): boolean;\n  load(): Promise<{ default: ComponentType<{ file: FileInfo }> }>;\n}\n\n/**\n * Wrap a dynamic-import loader so that, if the import fails because an\n * optional peer dependency is missing (e.g. `pdfjs-dist`, `exceljs`), the\n * user sees a clear \"install this package\" message instead of the raw\n * bundler error.\n *\n * @example\n * load: loadWithOptionalDep(\n *   () => import(\"../preview-adapters/PdfPreviewAdapter\"),\n *   { package: \"pdfjs-dist\", featureLabel: \"PDF preview\" },\n * )\n */\nexport function loadWithOptionalDep<T>(\n  loader: () => Promise<T>,\n  meta: { package: string; featureLabel: string },\n): () => Promise<T> {\n  return async () => {\n    try {\n      return await loader();\n    } catch (cause) {\n      if (isModuleNotFoundError(cause, meta.package)) {\n        throw new MissingPeerDependencyError(meta.package, meta.featureLabel, cause);\n      }\n      throw cause;\n    }\n  };\n}\n\nexport class MissingPeerDependencyError extends Error {\n  constructor(\n    public packageName: string,\n    public featureLabel: string,\n    public cause: unknown,\n  ) {\n    super(\n      `${featureLabel} requires the optional peer dependency \"${packageName}\".\\n\\n` +\n        `Install it in your app:\\n` +\n        `  pnpm add ${packageName}\\n` +\n        `  # or: npm install ${packageName}\\n` +\n        `  # or: yarn add ${packageName}\\n\\n` +\n        `See: https://github.com/CoderLambert/filevista/tree/main/packages/file-preview#optional-peer-dependencies`,\n    );\n    this.name = \"MissingPeerDependencyError\";\n  }\n}\n\n/**\n * Detect \"module not found\" failures across the bundlers/runtimes our users\n * are likely on — Webpack, Turbopack, Vite, native ESM, esbuild.\n *\n * We deliberately match loosely. False positives are cheap (the install hint\n * is always actionable) but false negatives swallow the affordance.\n */\nfunction isModuleNotFoundError(error: unknown, packageName: string): boolean {\n  if (!(error instanceof Error)) return false;\n  const message = error.message ?? \"\";\n  if (!message) return false;\n\n  // The package name must appear in the message — otherwise we're attributing\n  // an unrelated error to the wrong dependency.\n  if (!message.includes(packageName)) return false;\n\n  return (\n    message.includes(\"Cannot find module\") || // Node ESM, Webpack\n    message.includes(\"Failed to fetch dynamically imported module\") || // Native browser ESM\n    message.includes(\"Failed to resolve module specifier\") || // Vite dev\n    message.includes(\"Module not found\") || // Webpack production\n    message.includes(\"Unable to resolve\") // Metro / some bundlers\n  );\n}\n"],"mappings":"AAuBO,SAAS,oBACd,QACA,MACkB;AAClB,SAAO,YAAY;AACjB,QAAI;AACF,aAAO,MAAM,OAAO;AAAA,IACtB,SAAS,OAAO;AACd,UAAI,sBAAsB,OAAO,KAAK,OAAO,GAAG;AAC9C,cAAM,IAAI,2BAA2B,KAAK,SAAS,KAAK,cAAc,KAAK;AAAA,MAC7E;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEO,MAAM,mCAAmC,MAAM;AAAA,EACpD,YACS,aACA,cACA,OACP;AACA;AAAA,MACE,GAAG,YAAY,2CAA2C,WAAW;AAAA;AAAA;AAAA,aAErD,WAAW;AAAA,sBACF,WAAW;AAAA,mBACd,WAAW;AAAA;AAAA;AAAA,IAEnC;AAXO;AACA;AACA;AAUP,SAAK,OAAO;AAAA,EACd;AACF;AASA,SAAS,sBAAsB,OAAgB,aAA8B;AAC3E,MAAI,EAAE,iBAAiB,OAAQ,QAAO;AACtC,QAAM,UAAU,MAAM,WAAW;AACjC,MAAI,CAAC,QAAS,QAAO;AAIrB,MAAI,CAAC,QAAQ,SAAS,WAAW,EAAG,QAAO;AAE3C,SACE,QAAQ,SAAS,oBAAoB;AAAA,EACrC,QAAQ,SAAS,6CAA6C;AAAA,EAC9D,QAAQ,SAAS,oCAAoC;AAAA,EACrD,QAAQ,SAAS,kBAAkB;AAAA,EACnC,QAAQ,SAAS,mBAAmB;AAExC;","names":[]}

package/dist/core/registry.d.ts

@@ -0,0 +1,13 @@
+import { FileInfo } from './types.js';
+import { PreviewPlugin } from './plugin.js';
+import 'react';
+
+declare class PreviewPluginRegistry {
+    private plugins;
+    register(plugin: PreviewPlugin): void;
+    resolve(file: FileInfo): PreviewPlugin | null;
+    list(): PreviewPlugin[];
+}
+declare function createPreviewPluginRegistry(plugins: PreviewPlugin[]): PreviewPluginRegistry;
+
+export { PreviewPluginRegistry, createPreviewPluginRegistry };

package/dist/core/registry.js

@@ -0,0 +1,33 @@
+class PreviewPluginRegistry {
+  constructor() {
+    this.plugins = [];
+  }
+  register(plugin) {
+    const existingIndex = this.plugins.findIndex((item) => item.id === plugin.id);
+    if (existingIndex >= 0) {
+      this.plugins[existingIndex] = plugin;
+      return;
+    }
+    this.plugins.push(plugin);
+  }
+  resolve(file) {
+    return this.list().find((plugin) => plugin.match(file)) ?? null;
+  }
+  list() {
+    return [...this.plugins].sort(
+      (a, b) => (b.priority ?? 0) - (a.priority ?? 0)
+    );
+  }
+}
+function createPreviewPluginRegistry(plugins) {
+  const registry = new PreviewPluginRegistry();
+  for (const plugin of plugins) {
+    registry.register(plugin);
+  }
+  return registry;
+}
+export {
+  PreviewPluginRegistry,
+  createPreviewPluginRegistry
+};
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/registry.ts"],"sourcesContent":["import type { FileInfo } from \"../utils\";\nimport type { PreviewPlugin } from \"./plugin\";\n\nexport class PreviewPluginRegistry {\n  private plugins: PreviewPlugin[] = [];\n\n  register(plugin: PreviewPlugin): void {\n    const existingIndex = this.plugins.findIndex((item) => item.id === plugin.id);\n\n    if (existingIndex >= 0) {\n      this.plugins[existingIndex] = plugin;\n      return;\n    }\n\n    this.plugins.push(plugin);\n  }\n\n  resolve(file: FileInfo): PreviewPlugin | null {\n    return this.list().find((plugin) => plugin.match(file)) ?? null;\n  }\n\n  list(): PreviewPlugin[] {\n    return [...this.plugins].sort(\n      (a, b) => (b.priority ?? 0) - (a.priority ?? 0)\n    );\n  }\n}\n\nexport function createPreviewPluginRegistry(\n  plugins: PreviewPlugin[]\n): PreviewPluginRegistry {\n  const registry = new PreviewPluginRegistry();\n\n  for (const plugin of plugins) {\n    registry.register(plugin);\n  }\n\n  return registry;\n}"],"mappings":"AAGO,MAAM,sBAAsB;AAAA,EAA5B;AACL,SAAQ,UAA2B,CAAC;AAAA;AAAA,EAEpC,SAAS,QAA6B;AACpC,UAAM,gBAAgB,KAAK,QAAQ,UAAU,CAAC,SAAS,KAAK,OAAO,OAAO,EAAE;AAE5E,QAAI,iBAAiB,GAAG;AACtB,WAAK,QAAQ,aAAa,IAAI;AAC9B;AAAA,IACF;AAEA,SAAK,QAAQ,KAAK,MAAM;AAAA,EAC1B;AAAA,EAEA,QAAQ,MAAsC;AAC5C,WAAO,KAAK,KAAK,EAAE,KAAK,CAAC,WAAW,OAAO,MAAM,IAAI,CAAC,KAAK;AAAA,EAC7D;AAAA,EAEA,OAAwB;AACtB,WAAO,CAAC,GAAG,KAAK,OAAO,EAAE;AAAA,MACvB,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,YAAY;AAAA,IAC/C;AAAA,EACF;AACF;AAEO,SAAS,4BACd,SACuB;AACvB,QAAM,WAAW,IAAI,sBAAsB;AAE3C,aAAW,UAAU,SAAS;AAC5B,aAAS,SAAS,MAAM;AAAA,EAC1B;AAEA,SAAO;AACT;","names":[]}

package/dist/core/source.d.ts

@@ -0,0 +1,14 @@
+import { PreviewSource } from './types.js';
+
+interface ReadSourceOptions {
+    signal?: AbortSignal;
+}
+declare function readSourceAsArrayBuffer(source: PreviewSource, options?: ReadSourceOptions): Promise<ArrayBuffer>;
+declare function readSourceAsText(source: PreviewSource, options?: ReadSourceOptions): Promise<string>;
+declare function readSourceAsBase64(source: PreviewSource, options?: ReadSourceOptions): Promise<string>;
+declare function createObjectUrlFromSource(source: PreviewSource): string | null;
+declare function getSourceName(source: PreviewSource): string | undefined;
+declare function getSourceMimeType(source: PreviewSource): string | undefined;
+declare function getSourceSize(source: PreviewSource): number | undefined;
+
+export { type ReadSourceOptions, createObjectUrlFromSource, getSourceMimeType, getSourceName, getSourceSize, readSourceAsArrayBuffer, readSourceAsBase64, readSourceAsText };

package/dist/core/source.js

@@ -0,0 +1,131 @@
+async function readSourceAsArrayBuffer(source, options = {}) {
+  switch (source.kind) {
+    case "file":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return source.file.arrayBuffer();
+    case "blob":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return source.blob.arrayBuffer();
+    case "arrayBuffer":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return source.buffer;
+    case "url": {
+      const response = await fetch(source.url, {
+        headers: source.headers,
+        signal: options.signal
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to fetch file: ${response.status}`);
+      }
+      return response.arrayBuffer();
+    }
+    default:
+      throw new Error("Unsupported preview source");
+  }
+}
+async function readSourceAsText(source, options = {}) {
+  switch (source.kind) {
+    case "file":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return source.file.text();
+    case "blob":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return source.blob.text();
+    case "arrayBuffer":
+      if (options.signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      return new TextDecoder("utf-8").decode(source.buffer);
+    case "url": {
+      const response = await fetch(source.url, {
+        headers: source.headers,
+        signal: options.signal
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to fetch text: ${response.status}`);
+      }
+      return response.text();
+    }
+    default:
+      throw new Error("Unsupported preview source");
+  }
+}
+async function readSourceAsBase64(source, options = {}) {
+  const buffer = await readSourceAsArrayBuffer(source, options);
+  const bytes = new Uint8Array(buffer);
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += 8192) {
+    const chunk = bytes.subarray(i, Math.min(i + 8192, bytes.length));
+    binary += String.fromCharCode(...chunk);
+  }
+  return btoa(binary);
+}
+function createObjectUrlFromSource(source) {
+  if (source.kind === "file") {
+    return URL.createObjectURL(source.file);
+  }
+  if (source.kind === "blob") {
+    return URL.createObjectURL(source.blob);
+  }
+  return null;
+}
+function getSourceName(source) {
+  switch (source.kind) {
+    case "file":
+      return source.file.name;
+    case "blob":
+    case "arrayBuffer":
+      return source.name;
+    case "url":
+      return source.name || source.url.split("/").pop();
+    default:
+      return void 0;
+  }
+}
+function getSourceMimeType(source) {
+  switch (source.kind) {
+    case "file":
+      return source.file.type;
+    case "blob":
+      return source.mimeType || source.blob.type;
+    case "arrayBuffer":
+    case "url":
+      return source.mimeType;
+    default:
+      return void 0;
+  }
+}
+function getSourceSize(source) {
+  switch (source.kind) {
+    case "file":
+      return source.file.size;
+    case "blob":
+      return source.blob.size;
+    case "arrayBuffer":
+      return source.buffer.byteLength;
+    case "url":
+      return void 0;
+    default:
+      return void 0;
+  }
+}
+export {
+  createObjectUrlFromSource,
+  getSourceMimeType,
+  getSourceName,
+  getSourceSize,
+  readSourceAsArrayBuffer,
+  readSourceAsBase64,
+  readSourceAsText
+};
+//# sourceMappingURL=source.js.map

package/dist/core/source.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/source.ts"],"sourcesContent":["import type { PreviewSource } from \"./types\";\n\nexport interface ReadSourceOptions {\n  signal?: AbortSignal;\n}\n\nexport async function readSourceAsArrayBuffer(\n  source: PreviewSource,\n  options: ReadSourceOptions = {}\n): Promise<ArrayBuffer> {\n  switch (source.kind) {\n    case \"file\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return source.file.arrayBuffer();\n\n    case \"blob\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return source.blob.arrayBuffer();\n\n    case \"arrayBuffer\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return source.buffer;\n\n    case \"url\": {\n      const response = await fetch(source.url, {\n        headers: source.headers,\n        signal: options.signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch file: ${response.status}`);\n      }\n\n      return response.arrayBuffer();\n    }\n\n    default:\n      throw new Error(\"Unsupported preview source\");\n  }\n}\n\nexport async function readSourceAsText(\n  source: PreviewSource,\n  options: ReadSourceOptions = {}\n): Promise<string> {\n  switch (source.kind) {\n    case \"file\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return source.file.text();\n\n    case \"blob\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return source.blob.text();\n\n    case \"arrayBuffer\":\n      if (options.signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n      return new TextDecoder(\"utf-8\").decode(source.buffer);\n\n    case \"url\": {\n      const response = await fetch(source.url, {\n        headers: source.headers,\n        signal: options.signal,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch text: ${response.status}`);\n      }\n\n      return response.text();\n    }\n\n    default:\n      throw new Error(\"Unsupported preview source\");\n  }\n}\n\nexport async function readSourceAsBase64(\n  source: PreviewSource,\n  options: ReadSourceOptions = {}\n): Promise<string> {\n  const buffer = await readSourceAsArrayBuffer(source, options);\n  const bytes = new Uint8Array(buffer);\n\n  let binary = \"\";\n  for (let i = 0; i < bytes.length; i += 8192) {\n    const chunk = bytes.subarray(i, Math.min(i + 8192, bytes.length));\n    binary += String.fromCharCode(...chunk);\n  }\n\n  return btoa(binary);\n}\n\nexport function createObjectUrlFromSource(source: PreviewSource): string | null {\n  if (source.kind === \"file\") {\n    return URL.createObjectURL(source.file);\n  }\n\n  if (source.kind === \"blob\") {\n    return URL.createObjectURL(source.blob);\n  }\n\n  return null;\n}\n\nexport function getSourceName(source: PreviewSource): string | undefined {\n  switch (source.kind) {\n    case \"file\":\n      return source.file.name;\n\n    case \"blob\":\n    case \"arrayBuffer\":\n      return source.name;\n\n    case \"url\":\n      return source.name || source.url.split(\"/\").pop();\n\n    default:\n      return undefined;\n  }\n}\n\nexport function getSourceMimeType(source: PreviewSource): string | undefined {\n  switch (source.kind) {\n    case \"file\":\n      return source.file.type;\n\n    case \"blob\":\n      return source.mimeType || source.blob.type;\n\n    case \"arrayBuffer\":\n    case \"url\":\n      return source.mimeType;\n\n    default:\n      return undefined;\n  }\n}\n\nexport function getSourceSize(source: PreviewSource): number | undefined {\n  switch (source.kind) {\n    case \"file\":\n      return source.file.size;\n\n    case \"blob\":\n      return source.blob.size;\n\n    case \"arrayBuffer\":\n      return source.buffer.byteLength;\n\n    case \"url\":\n      return undefined;\n\n    default:\n      return undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Core types for the preview pipeline.
+ *
+ * Kept dependency-free so that {@link PreviewSource}, {@link NormalizedFile},
+ * {@link FileInfo}, and the {@link FileType} union can be shared between the
+ * runtime helpers in `utils.ts` and the plugin/registry layer without forming
+ * a cycle.
+ */
+/**
+ * Canonical file-type tags recognized by the built-in plugin registry.
+ * Use {@link detectFileType} (in `utils`) to map a filename + MIME pair to one
+ * of these values.
+ */
+declare const ALL_FILE_TYPES: readonly ["pdf", "markdown", "json", "code", "docx", "doc", "pptx", "ppt", "xlsx", "xls", "html", "zip", "svg", "rtf", "epub", "image", "text", "csv", "video", "audio", "unknown"];
+type FileType = (typeof ALL_FILE_TYPES)[number];
+/**
+ * Source abstraction read by every preview plugin.
+ *
+ * Plugins should never touch raw `File`/`Blob`/`ArrayBuffer`/URL directly —
+ * always go through `readSourceAsText` / `readSourceAsArrayBuffer` / the
+ * matching React hooks. That keeps consumers free to mix local uploads,
+ * blobs, decoded buffers, and remote URLs without each plugin re-deriving
+ * the data path.
+ */
+type PreviewSource = {
+    kind: "file";
+    file: File;
+} | {
+    kind: "blob";
+    blob: Blob;
+    name?: string;
+    mimeType?: string;
+} | {
+    kind: "arrayBuffer";
+    buffer: ArrayBuffer;
+    name?: string;
+    mimeType?: string;
+} | {
+    kind: "url";
+    url: string;
+    name?: string;
+    mimeType?: string;
+    headers?: Record<string, string>;
+};
+/**
+ * The shape consumers pass into `<PluginPreviewRenderer file={...} />`.
+ *
+ * `source` is the only field the plugin pipeline reads. The legacy `content`
+ * and `url` fields exist for pre-Stage-18 callers and will be removed in a
+ * future major.
+ */
+interface FileInfo {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    fileType: FileType;
+    /**
+     * Primary source abstraction. Mandatory in Stage 18+.
+     * Read via `readSourceAsText` / `readSourceAsArrayBuffer` from `core/source`.
+     */
+    source: PreviewSource;
+    /**
+     * @deprecated Use `source` + `readSourceAsText`/`readSourceAsArrayBuffer`.
+     * Compatibility field for legacy preview components.
+     */
+    content?: string | null;
+    /**
+     * @deprecated Use `source` or an adapter-local object URL.
+     * Compatibility field for legacy media preview components.
+     */
+    url?: string | null;
+}
+/**
+ * Slimmer normalized representation used by the registry / plugin internals.
+ * Most consumers should work with {@link FileInfo} instead.
+ */
+interface NormalizedFile {
+    id: string;
+    name: string;
+    size?: number;
+    mimeType?: string;
+    extension?: string;
+    fileType: FileType;
+    source: PreviewSource;
+}
+
+export { ALL_FILE_TYPES, type FileInfo, type FileType, type NormalizedFile, type PreviewSource };