adtec-core-package 3.1.6 → 3.1.8

package/src/utils/docxPreviewUtil.ts

@@ -0,0 +1,108 @@
+export type WordBinaryFormat = 'docx' | 'doc' | 'unknown'
+
+export interface DocxSearchMatch {
+  pageIndex: number
+  markId: string
+}
+
+const OLE_DOC_MAGIC = [0xd0, 0xcf, 0x11, 0xe0]
+const ZIP_MAGIC = [0x50, 0x4b]
+
+export const detectWordBinaryFormat = (buffer: ArrayBuffer): WordBinaryFormat => {
+  const bytes = new Uint8Array(buffer, 0, 4)
+  if (bytes.length < 4) return 'unknown'
+  if (ZIP_MAGIC.every((value, index) => bytes[index] === value)) return 'docx'
+  if (OLE_DOC_MAGIC.every((value, index) => bytes[index] === value)) return 'doc'
+  return 'unknown'
+}
+
+export const resolveRawWordExt = (type?: string, name?: string, fileUrl?: string) => {
+  const normalizedType = (type || '').toLowerCase().replace(/^\./, '')
+  if (normalizedType === 'doc' || normalizedType === 'docx') return normalizedType
+  const fromName = (name || '').match(/\.([a-z0-9]+)$/i)?.[1]?.toLowerCase()
+  if (fromName === 'doc' || fromName === 'docx') return fromName
+  const urlStr = (fileUrl || '').toLowerCase()
+  if (urlStr.includes('.docx')) return 'docx'
+  if (urlStr.match(/\.doc(\?|#|$)/)) return 'doc'
+  return ''
+}
+
+const collectTextNodes = (root: ParentNode) => {
+  const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT)
+  const nodes: Text[] = []
+  let current = walker.nextNode()
+  while (current) {
+    if (current.textContent?.trim()) nodes.push(current as Text)
+    current = walker.nextNode()
+  }
+  return nodes
+}
+
+const unwrapMarks = (root: ParentNode) => {
+  root.querySelectorAll('mark.docx-search-mark').forEach((mark) => {
+    const parent = mark.parentNode
+    if (!parent) return
+    while (mark.firstChild) parent.insertBefore(mark.firstChild, mark)
+    parent.removeChild(mark)
+  })
+  root.normalize()
+}
+
+export const clearDocxSearchMarks = (root: ParentNode) => {
+  unwrapMarks(root)
+  root.querySelectorAll('.docx-search-mark--active').forEach((el) => {
+    el.classList.remove('docx-search-mark--active')
+  })
+}
+
+export const searchDocxPages = (
+  pages: HTMLElement[],
+  query: string,
+): DocxSearchMatch[] => {
+  const keyword = query.trim().toLowerCase()
+  if (!keyword) return []
+  const matches: DocxSearchMatch[] = []
+
+  pages.forEach((page, pageIndex) => {
+    unwrapMarks(page)
+    const textNodes = collectTextNodes(page)
+    for (const node of [...textNodes]) {
+      let text = node.textContent || ''
+      let lower = text.toLowerCase()
+      let fromIndex = 0
+      while (fromIndex < lower.length) {
+        const hit = lower.indexOf(keyword, fromIndex)
+        if (hit < 0) break
+        const parent = node.parentNode
+        if (!parent) break
+        const mark = document.createElement('mark')
+        mark.className = 'docx-search-mark'
+        const markId = `${pageIndex}-${matches.length}`
+        mark.dataset.matchId = markId
+        const before = text.slice(0, hit)
+        const middle = text.slice(hit, hit + keyword.length)
+        const after = text.slice(hit + keyword.length)
+        if (before) parent.insertBefore(document.createTextNode(before), node)
+        mark.textContent = middle
+        parent.insertBefore(mark, node)
+        if (after) {
+          node.textContent = after
+          text = after
+          lower = after.toLowerCase()
+          fromIndex = 0
+        } else {
+          parent.removeChild(node)
+          break
+        }
+        matches.push({ pageIndex, markId })
+      }
+    }
+  })
+  return matches
+}
+
+export const activateDocxSearchMark = (root: ParentNode, markId: string) => {
+  root.querySelectorAll('.docx-search-mark').forEach((el) => {
+    el.classList.toggle('docx-search-mark--active', el instanceof HTMLElement && el.dataset.matchId === markId)
+  })
+}

package/src/utils/excelPreviewUtil.ts

@@ -0,0 +1,307 @@
+import * as XLSX from 'xlsx-js-style'
+
+export interface ExcelPreviewCellStyle {
+  backgroundColor?: string
+  color?: string
+  fontWeight?: string
+  fontStyle?: string
+  textDecoration?: string
+  textAlign?: 'left' | 'center' | 'right' | 'justify'
+  verticalAlign?: 'top' | 'middle' | 'bottom'
+  borderTop?: string
+  borderRight?: string
+  borderBottom?: string
+  borderLeft?: string
+  fontSize?: string
+  whiteSpace?: string
+}
+
+export interface ExcelPreviewCell {
+  value: string
+  row: number
+  col: number
+  rowSpan?: number
+  colSpan?: number
+  style?: ExcelPreviewCellStyle
+  width?: number
+}
+
+export interface ExcelPreviewSheet {
+  name: string
+  rows: ExcelPreviewCell[][]
+  startCol: number
+  endCol: number
+  colWidths: Record<number, number>
+}
+
+export interface ExcelSearchMatch {
+  sheetIndex: number
+  row: number
+  col: number
+  text: string
+}
+
+type ColorStyle = { rgb?: string; theme?: number; tint?: number; indexed?: number }
+
+/** Excel 默认主题色（Office 2013+） */
+const EXCEL_THEME_COLORS: Record<number, string> = {
+  0: '#FFFFFF',
+  1: '#000000',
+  2: '#E7E6E6',
+  3: '#44546A',
+  4: '#4472C4',
+  5: '#ED7D31',
+  6: '#A5A5A5',
+  7: '#FFC000',
+  8: '#5B9BD5',
+  9: '#70AD47',
+}
+
+const BORDER_WIDTH: Record<string, string> = {
+  hair: '1px',
+  thin: '1px',
+  medium: '2px',
+  thick: '3px',
+  dashed: '1px',
+  dotted: '1px',
+  double: '3px',
+}
+
+const DEFAULT_COL_WIDTH = 72
+
+const hexToRgb = (hex: string) => {
+  const normalized = hex.replace('#', '')
+  const value =
+    normalized.length === 8 ? normalized.slice(2) : normalized.length === 6 ? normalized : ''
+  if (value.length !== 6) return null
+  return {
+    r: parseInt(value.slice(0, 2), 16),
+    g: parseInt(value.slice(2, 4), 16),
+    b: parseInt(value.slice(4, 6), 16),
+  }
+}
+
+const rgbToHex = (r: number, g: number, b: number) =>
+  `#${[r, g, b]
+    .map((v) => Math.min(255, Math.max(0, Math.round(v))).toString(16).padStart(2, '0'))
+    .join('')}`
+
+const applyTint = (hex: string, tint: number) => {
+  const rgb = hexToRgb(hex)
+  if (!rgb) return hex
+  const mix = tint < 0 ? { r: 0, g: 0, b: 0 } : { r: 255, g: 255, b: 255 }
+  const ratio = Math.abs(tint)
+  return rgbToHex(
+    rgb.r + (mix.r - rgb.r) * ratio,
+    rgb.g + (mix.g - rgb.g) * ratio,
+    rgb.b + (mix.b - rgb.b) * ratio,
+  )
+}
+
+const resolveColor = (color?: ColorStyle): string | undefined => {
+  if (!color) return undefined
+  if (color.rgb) {
+    const raw = color.rgb.replace(/[^0-9a-f]/gi, '')
+    if (raw.length === 8) return `#${raw.slice(2)}`
+    if (raw.length === 6) return `#${raw}`
+    return undefined
+  }
+  if (color.theme != null) {
+    const base = EXCEL_THEME_COLORS[color.theme] ?? '#FFFFFF'
+    return color.tint ? applyTint(base, color.tint) : base
+  }
+  return undefined
+}
+
+const resolveBorderSide = (side?: { style?: string; color?: ColorStyle }) => {
+  if (!side?.style || side.style === 'none') return undefined
+  const width = BORDER_WIDTH[side.style] ?? '1px'
+  const color = resolveColor(side.color) ?? '#d0d0d0'
+  const lineStyle = side.style === 'dashed' ? 'dashed' : side.style === 'dotted' ? 'dotted' : 'solid'
+  return `${width} ${lineStyle} ${color}`
+}
+
+const extractCellStyle = (cell?: XLSX.CellObject): ExcelPreviewCellStyle | undefined => {
+  const rawStyle = cell?.s
+  if (!rawStyle || typeof rawStyle === 'number') return undefined
+  const style = rawStyle as Record<string, unknown>
+  const css: ExcelPreviewCellStyle = {}
+
+  const fill = style.fill as { patternType?: string; fgColor?: ColorStyle; bgColor?: ColorStyle } | undefined
+  if (fill && fill.patternType !== 'none') {
+    const bg = resolveColor(fill.fgColor) || resolveColor(fill.bgColor)
+    if (bg) css.backgroundColor = bg
+  }
+
+  const font = style.font as {
+    bold?: boolean
+    italic?: boolean
+    underline?: boolean | string
+    sz?: number | string
+    color?: ColorStyle
+  } | undefined
+  if (font) {
+    if (font.bold) css.fontWeight = 'bold'
+    if (font.italic) css.fontStyle = 'italic'
+    if (font.underline) css.textDecoration = 'underline'
+    if (font.sz) css.fontSize = `${font.sz}pt`
+    const color = resolveColor(font.color)
+    if (color) css.color = color
+  }
+
+  const alignment = style.alignment as {
+    horizontal?: string
+    vertical?: string
+    wrapText?: boolean
+  } | undefined
+  if (alignment) {
+    if (alignment.horizontal && alignment.horizontal !== 'general') {
+      css.textAlign = alignment.horizontal as ExcelPreviewCellStyle['textAlign']
+    }
+    if (alignment.vertical) {
+      css.verticalAlign =
+        alignment.vertical === 'center'
+          ? 'middle'
+          : (alignment.vertical as ExcelPreviewCellStyle['verticalAlign'])
+    }
+    if (alignment.wrapText) css.whiteSpace = 'pre-wrap'
+  }
+
+  const border = style.border as Record<string, { style?: string; color?: ColorStyle }> | undefined
+  if (border) {
+    const top = resolveBorderSide(border.top)
+    const right = resolveBorderSide(border.right)
+    const bottom = resolveBorderSide(border.bottom)
+    const left = resolveBorderSide(border.left)
+    if (top) css.borderTop = top
+    if (right) css.borderRight = right
+    if (bottom) css.borderBottom = bottom
+    if (left) css.borderLeft = left
+  }
+
+  return Object.keys(css).length > 0 ? css : undefined
+}
+
+export const cellStyleToCss = (style?: ExcelPreviewCellStyle): Record<string, string> => {
+  if (!style) return {}
+  const css: Record<string, string> = {}
+  if (style.backgroundColor) css.backgroundColor = style.backgroundColor
+  if (style.color) css.color = style.color
+  if (style.fontWeight) css.fontWeight = style.fontWeight
+  if (style.fontStyle) css.fontStyle = style.fontStyle
+  if (style.textDecoration) css.textDecoration = style.textDecoration
+  if (style.textAlign) css.textAlign = style.textAlign
+  if (style.verticalAlign) css.verticalAlign = style.verticalAlign
+  if (style.borderTop) css.borderTop = style.borderTop
+  if (style.borderRight) css.borderRight = style.borderRight
+  if (style.borderBottom) css.borderBottom = style.borderBottom
+  if (style.borderLeft) css.borderLeft = style.borderLeft
+  if (style.fontSize) css.fontSize = style.fontSize
+  if (style.whiteSpace) css.whiteSpace = style.whiteSpace
+  return css
+}
+
+export const toExcelColumnLabel = (colIndex: number) => XLSX.utils.encode_col(colIndex)
+
+const formatCellValue = (cell?: XLSX.CellObject) => {
+  if (!cell) return ''
+  if (cell.w != null && cell.w !== '') return String(cell.w)
+  if (cell.v == null) return ''
+  if (cell.t === 'd') {
+    const date = cell.v instanceof Date ? cell.v : new Date(cell.v as number)
+    if (!Number.isNaN(date.getTime())) return date.toLocaleString()
+  }
+  return String(cell.v)
+}
+
+const parseColWidths = (sheet: XLSX.WorkSheet, startCol: number, endCol: number) => {
+  const cols = sheet['!cols'] || []
+  const widths: Record<number, number> = {}
+  for (let c = startCol; c <= endCol; c++) {
+    const col = cols[c]
+    if (col?.wpx) widths[c] = col.wpx
+    else if (col?.wch) widths[c] = Math.max(48, col.wch * 7)
+    else widths[c] = DEFAULT_COL_WIDTH
+  }
+  return widths
+}
+
+export const parseExcelWorkbook = async (src: Blob | ArrayBuffer): Promise<ExcelPreviewSheet[]> => {
+  const buffer = src instanceof Blob ? await src.arrayBuffer() : src
+  const workbook = XLSX.read(buffer, { type: 'array', cellDates: true, cellStyles: true })
+  return workbook.SheetNames.map((name) => {
+    const sheet = workbook.Sheets[name]
+    const range = sheet?.['!ref'] ? XLSX.utils.decode_range(sheet['!ref']) : null
+    return {
+      name,
+      rows: buildSheetRows(sheet),
+      startCol: range?.s.c ?? 0,
+      endCol: range?.e.c ?? 0,
+      colWidths: range ? parseColWidths(sheet, range.s.c, range.e.c) : {},
+    }
+  })
+}
+
+const buildSheetRows = (sheet?: XLSX.WorkSheet): ExcelPreviewCell[][] => {
+  if (!sheet || !sheet['!ref']) return []
+  const range = XLSX.utils.decode_range(sheet['!ref'])
+  const colWidths = parseColWidths(sheet, range.s.c, range.e.c)
+  const mergeStarts = new Map<string, { rowSpan: number; colSpan: number }>()
+  const covered = new Set<string>()
+
+  for (const merge of sheet['!merges'] || []) {
+    const rowSpan = merge.e.r - merge.s.r + 1
+    const colSpan = merge.e.c - merge.s.c + 1
+    mergeStarts.set(`${merge.s.r},${merge.s.c}`, { rowSpan, colSpan })
+    for (let r = merge.s.r; r <= merge.e.r; r++) {
+      for (let c = merge.s.c; c <= merge.e.c; c++) {
+        if (r !== merge.s.r || c !== merge.s.c) covered.add(`${r},${c}`)
+      }
+    }
+  }
+
+  const rows: ExcelPreviewCell[][] = []
+  for (let r = range.s.r; r <= range.e.r; r++) {
+    const row: ExcelPreviewCell[] = []
+    for (let c = range.s.c; c <= range.e.c; c++) {
+      if (covered.has(`${r},${c}`)) continue
+      const addr = XLSX.utils.encode_cell({ r, c })
+      const cellObj = sheet[addr]
+      const merge = mergeStarts.get(`${r},${c}`)
+      row.push({
+        value: formatCellValue(cellObj),
+        row: r,
+        col: c,
+        rowSpan: merge?.rowSpan,
+        colSpan: merge?.colSpan,
+        style: extractCellStyle(cellObj),
+        width: colWidths[c],
+      })
+    }
+    if (row.length > 0) rows.push(row)
+  }
+  return rows
+}
+
+export const searchExcelSheets = (
+  sheets: ExcelPreviewSheet[],
+  query: string,
+): ExcelSearchMatch[] => {
+  const keyword = query.trim().toLowerCase()
+  if (!keyword) return []
+  const matches: ExcelSearchMatch[] = []
+  sheets.forEach((sheet, sheetIndex) => {
+    for (const row of sheet.rows) {
+      for (const cell of row) {
+        const text = cell.value
+        if (text.toLowerCase().includes(keyword)) {
+          matches.push({ sheetIndex, row: cell.row, col: cell.col, text })
+        }
+      }
+    }
+  })
+  return matches
+}
+
+export const cellKey = (sheetIndex: number, row: number, col: number) =>
+  `${sheetIndex}:${row}:${col}`

package/src/utils/officePreviewUtil.ts

@@ -0,0 +1,122 @@
+export type OfficePreviewType = 'pdf' | 'docx' | 'excel' | 'pptx' | 'txt' | ''
+
+/** 当前支持在线预览的格式 */
+export const SUPPORTED_PREVIEW_TYPES: ReadonlySet<OfficePreviewType> = new Set([
+  'pdf',
+  'docx',
+  'excel',
+  'txt',
+])
+
+/** 使用内置 OfficePreviewHeaderBar 的格式（与 PDF 同款工具栏） */
+export const HEADER_PREVIEW_TYPES: ReadonlySet<OfficePreviewType> = new Set([
+  'pdf',
+  'docx',
+  'excel',
+])
+
+export const isSupportedPreviewType = (type: OfficePreviewType) =>
+  SUPPORTED_PREVIEW_TYPES.has(type)
+
+export const resolveOfficeFileExt = (type?: string, name?: string, fileUrl?: string) => {
+  const normalizedType = (type || '').toLowerCase().replace(/^\./, '')
+  if (normalizedType) {
+    return normalizedType === 'doc' ? 'docx' : normalizedType
+  }
+  const fromName = (name || '').match(/\.([a-z0-9]+)$/i)?.[1]?.toLowerCase()
+  if (fromName) {
+    return fromName === 'doc' ? 'docx' : fromName
+  }
+  const urlStr = (fileUrl || '').toLowerCase()
+  if (urlStr.includes('.docx') || urlStr.includes('.doc')) return 'docx'
+  if (urlStr.includes('.pdf')) return 'pdf'
+  if (urlStr.includes('.xlsx') || urlStr.includes('.xls')) return 'xlsx'
+  if (urlStr.includes('.pptx') || urlStr.includes('.ppt')) return 'pptx'
+  if (urlStr.includes('.txt')) return 'txt'
+  return ''
+}
+
+export const toOfficePreviewType = (
+  type?: string,
+  name?: string,
+  fileUrl?: string,
+): OfficePreviewType => {
+  const ext = resolveOfficeFileExt(type, name, fileUrl)
+  if (ext === 'pdf') return 'pdf'
+  if (ext === 'docx') return 'docx'
+  if (ext === 'xlsx' || ext === 'xls' || ext === 'excel') return 'excel'
+  if (ext === 'pptx' || ext === 'ppt') return 'pptx'
+  if (ext === 'txt') return 'txt'
+  return ''
+}
+
+export const MIN_OFFICE_ZOOM = 0.5
+/** 非 PDF 预览（当前无在线预览）缩放上限 */
+export const MAX_OFFICE_ZOOM = 1
+/** pdf / excel 自研查看器支持高清放大 */
+export const MAX_RICH_PREVIEW_ZOOM = 3
+/** @deprecated 使用 MAX_RICH_PREVIEW_ZOOM */
+export const MAX_PDF_ZOOM = MAX_RICH_PREVIEW_ZOOM
+export const MAX_EXCEL_ZOOM = MAX_RICH_PREVIEW_ZOOM
+export const OFFICE_ZOOM_STEP = 0.1
+
+export const clampOfficeZoom = (value: number) =>
+  Math.min(MAX_OFFICE_ZOOM, Math.max(MIN_OFFICE_ZOOM, +value.toFixed(2)))
+
+export const clampPdfZoom = (value: number) =>
+  Math.min(MAX_RICH_PREVIEW_ZOOM, Math.max(MIN_OFFICE_ZOOM, +value.toFixed(2)))
+
+export const clampExcelZoom = clampPdfZoom
+
+export const clampRichPreviewZoom = clampPdfZoom
+
+export const clampPreviewZoom = (value: number, type: OfficePreviewType) =>
+  type === 'pdf' || type === 'excel' || type === 'docx'
+    ? clampRichPreviewZoom(value)
+    : clampOfficeZoom(value)
+
+/** PDF 点阵 DPI（pdfjs scale=1） */
+export const PDF_POINT_DPI = 72
+/** 屏幕 CSS 像素 DPI，用于「实际大小」换算 */
+export const SCREEN_CSS_DPI = 96
+/** A4 纸宽度（PDF 点） */
+export const A4_WIDTH_PT = 595.28
+
+/** A4 在屏幕上的目标宽度（px，约 794） */
+export const getA4ScreenWidthPx = () =>
+  Math.round(A4_WIDTH_PT * (SCREEN_CSS_DPI / PDF_POINT_DPI))
+
+/**
+ * 默认以 A4 实际大小展示；预览区比 A4 窄时等比缩小以完整显示。
+ */
+export const computePdfDefaultFitScale = (
+  pageWidthPt: number,
+  containerWidth: number,
+) => {
+  if (!pageWidthPt || !containerWidth) return SCREEN_CSS_DPI / PDF_POINT_DPI
+  const a4Scale = getA4ScreenWidthPx() / pageWidthPt
+  const containerScale = containerWidth / pageWidthPt
+  return Math.min(a4Scale, containerScale)
+}
+
+export const isPdfPreviewFile = (type?: string, name?: string, fileUrl?: string) =>
+  toOfficePreviewType(type, name, fileUrl) === 'pdf'
+
+export const isExcelPreviewFile = (type?: string, name?: string, fileUrl?: string) =>
+  toOfficePreviewType(type, name, fileUrl) === 'excel'
+
+export const isDocxPreviewFile = (type?: string, name?: string, fileUrl?: string) =>
+  toOfficePreviewType(type, name, fileUrl) === 'docx'
+
+export const isLegacyDocFile = (type?: string, name?: string, fileUrl?: string) => {
+  const raw = (type || '').toLowerCase().replace(/^\./, '')
+  if (raw === 'doc') return true
+  const fromName = (name || '').match(/\.([a-z0-9]+)$/i)?.[1]?.toLowerCase()
+  if (fromName === 'doc') return true
+  const urlStr = (fileUrl || '').toLowerCase()
+  return !!urlStr.match(/\.doc(\?|#|$)/) && !urlStr.includes('.docx')
+}
+
+/** 弹层等场景：使用 OfficePreview 内置标题栏（PDF / Word / Excel） */
+export const isHeaderPreviewFile = (type?: string, name?: string, fileUrl?: string) =>
+  HEADER_PREVIEW_TYPES.has(toOfficePreviewType(type, name, fileUrl))

package/src/utils/pdfSearchUtil.ts

@@ -0,0 +1,127 @@
+import * as pdfjsLib from 'pdfjs-dist/legacy/build/pdf.mjs'
+
+export interface PdfSearchMatch {
+  page: number
+  globalIndex: number
+  rects: Array<{ left: number; top: number; width: number; height: number }>
+}
+
+interface TextSpan {
+  start: number
+  end: number
+  left: number
+  top: number
+  width: number
+  height: number
+}
+
+type PdfViewportLike = {
+  height: number
+  width: number
+  scale: number
+  transform: number[]
+}
+
+type PdfPageLike = {
+  getViewport: (opts: { scale: number }) => PdfViewportLike
+  getTextContent: () => Promise<{ items: Array<Record<string, unknown>> }>
+}
+
+type PdfDocumentLike = {
+  numPages: number
+  getPage: (pageNum: number) => Promise<PdfPageLike>
+}
+
+const normalizeQuery = (query: string) => query.trim().toLowerCase()
+
+const getItemRect = (item: Record<string, unknown>, viewport: PdfViewportLike) => {
+  const transform = pdfjsLib.Util.transform(
+    viewport.transform,
+    item.transform as number[],
+  )
+  const fontHeight = Math.hypot(transform[2], transform[3]) || Number(item.height) || 12
+  const width = Math.abs(Number(item.width) || 0) * viewport.scale
+  return {
+    left: transform[4],
+    top: transform[5] - fontHeight,
+    width: Math.max(width, 4),
+    height: Math.max(fontHeight, 10),
+  }
+}
+
+const getPartialRect = (span: TextSpan, start: number, end: number) => {
+  const overlapStart = Math.max(start, span.start)
+  const overlapEnd = Math.min(end, span.end)
+  if (overlapEnd <= overlapStart) return null
+
+  const spanLen = Math.max(span.end - span.start, 1)
+  const offsetRatio = (overlapStart - span.start) / spanLen
+  const lengthRatio = (overlapEnd - overlapStart) / spanLen
+  const width = Math.max(span.width * lengthRatio, 4)
+
+  return {
+    left: span.left + span.width * offsetRatio,
+    top: span.top,
+    width,
+    height: span.height,
+  }
+}
+
+const getRangeRects = (spans: TextSpan[], start: number, end: number) => {
+  const rects: Array<{ left: number; top: number; width: number; height: number }> = []
+  for (const span of spans) {
+    const rect = getPartialRect(span, start, end)
+    if (rect) rects.push(rect)
+  }
+  return rects
+}
+
+export const searchPdfDocument = async (
+  doc: PdfDocumentLike,
+  query: string,
+  scale: number,
+): Promise<PdfSearchMatch[]> => {
+  const normalizedQuery = normalizeQuery(query)
+  if (!normalizedQuery) return []
+
+  const matches: PdfSearchMatch[] = []
+  let globalIndex = 0
+
+  for (let pageNum = 1; pageNum <= doc.numPages; pageNum++) {
+    const page = await doc.getPage(pageNum)
+    const viewport = page.getViewport({ scale })
+    const content = await page.getTextContent()
+
+    let fullText = ''
+    const spans: TextSpan[] = []
+
+    for (const item of content.items) {
+      if (!('str' in item) || typeof item.str !== 'string' || !item.str) continue
+      const rect = getItemRect(item, viewport)
+      const start = fullText.length
+      fullText += item.str
+      spans.push({
+        start,
+        end: fullText.length,
+        ...rect,
+      })
+    }
+
+    const lower = fullText.toLowerCase()
+    let idx = lower.indexOf(normalizedQuery)
+    while (idx !== -1) {
+      const endIdx = idx + normalizedQuery.length
+      const rects = getRangeRects(spans, idx, endIdx)
+      if (rects.length > 0) {
+        matches.push({
+          page: pageNum,
+          globalIndex: globalIndex++,
+          rects,
+        })
+      }
+      idx = lower.indexOf(normalizedQuery, idx + 1)
+    }
+  }
+
+  return matches
+}

package/src/utils/toSameOriginFileUrl.ts

@@ -1,6 +1,6 @@
 /**
  * 浏览器侧下载/拉取文件：将 fileurl 内网绝对地址转为当前页同源相对路径。
- * OnlyOffice 预览仍须使用原始内网 URL（Document Server 服务端拉取）。
+ * 将内网绝对地址转为当前页同源相对路径，供浏览器侧拉取文件。
  */
 export function toSameOriginFileUrl(url?: string | null): string {
   if (!url) return ''