Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

5.9 KB
Raw Blame
package layout

import (
	"encoding/base64"
	"strings"

	pdf "ragflow/internal/deepdoc/parser/pdf/type"
	util "ragflow/internal/deepdoc/parser/pdf/util"
)

// ResolvePageSpan computes the ending page and bottom coordinate for a box
// that may span multiple pages.  When pageHeights is nil or the box fits
// within its starting page the returned (toPage, bottom) equal the inputs.
//
// Zero or negative page heights are treated as invalid: the span stops at
// the preceding page, guarding against infinite loops caused by corrupted
// page images.
func ResolvePageSpan(pageNum int, bottom float64, pageHeights map[int]float64) (toPage int, newBottom float64) {
	toPage = pageNum
	newBottom = bottom
	if pageHeights == nil {
		return
	}
	ph, ok := pageHeights[pageNum]
	if !ok || ph <= 0 || bottom <= ph {
		return
	}
	remaining := bottom
	for remaining > ph && ph > 0 {
		nextPh, ok := pageHeights[toPage+1]
		if !ok || nextPh <= 0 {
			// Unknown or invalid next page height — extend by the
			// last known height once and stop (Python: _line_tag
			// while-loop break path).
			remaining -= ph
			toPage++
			break
		}
		remaining -= ph
		ph = nextPh
		toPage++
	}
	newBottom = remaining
	return
}

// BoxesToSections converts layout boxes to section format with position tags.
//
// pageHeights provides the PDF-point height of each page (image height / zoom).
// Boxes that extend beyond their page produce multi-page position tags
// (Python's _line_tag while-loop detection via resolvePageSpan).
//
// Python equivalent: output consumed by naive.py::chunk()
func BoxesToSections(boxes []pdf.TextBox, pageHeights map[int]float64) []pdf.Section {
	sections := make([]pdf.Section, 0, len(boxes))
	for _, b := range boxes {
		t := strings.TrimSpace(b.Text)
		if t == "" && b.LayoutType != pdf.LayoutTypeFigure {
			continue
		}

		var posTag string
		var pageNums []int
		var bottom float64
		if len(b.Pages) > 0 {
			// Box carries an explicit page span (e.g. a cross-page merged
			// table). Use it directly instead of inferring from geometry, so
			// the section records every page the box occupies.
			pageNums = b.Pages
			bottom = b.Bottom
			if len(pageNums) == 1 {
				posTag = util.FormatPositionTag(pageNums[0], b.X0, b.X1, b.Top, bottom)
			} else {
				posTag = util.FormatPositionTagRange(pageNums[0], pageNums[len(pageNums)-1], b.X0, b.X1, b.Top, bottom)
			}
		} else {
			toPage, resolved := ResolvePageSpan(b.PageNumber, b.Bottom, pageHeights)
			bottom = resolved
			if b.PageNumber == toPage {
				posTag = util.FormatPositionTag(b.PageNumber, b.X0, b.X1, b.Top, bottom)
				pageNums = []int{b.PageNumber}
			} else {
				posTag = util.FormatPositionTagRange(b.PageNumber, toPage, b.X0, b.X1, b.Top, bottom)
				pageNums = make([]int, 0, toPage-b.PageNumber+1)
				for p := b.PageNumber; p <= toPage; p++ {
					pageNums = append(pageNums, p)
				}
			}
		}
		sections = append(sections, pdf.Section{
			Text:        t,
			PositionTag: posTag,
			LayoutType:  b.LayoutType,
			Positions:   []pdf.Position{{PageNumbers: pageNums, Left: b.X0, Right: b.X1, Top: b.Top, Bottom: bottom}},
		})
	}
	return sections
}

// NormalizeSectionPositions ensures each Section's Positions field is populated
// by parsing PositionTag when Positions is empty. Sections that already have
// Positions populated are left unchanged.
//
// This mirrors the Python normalize_pdf_items_metadata — canonicalizing
// position metadata from the string tag format into the typed []Position form.
//
// Callers should invoke this AFTER Parse() returns, just before consuming
// Sections (e.g., before serialization to JSON or passing to the chunker).
// The normalization is intentionally NOT embedded inside the parser pipeline
// because Sections may come from multiple sources (deepdoc, MinerU, Docling,
// JSON deserialization, etc.).
func NormalizeSectionPositions(sections []pdf.Section) {
	for i := range sections {
		if len(sections[i].Positions) == 0 && sections[i].PositionTag != "" {
			sections[i].Positions = util.ExtractPositions(sections[i].PositionTag)
		}
	}
}

// InlinePNGDataURL ensures a raw base64 or Data URI string has a valid
// "data:image/png;base64," prefix. It trims surrounding whitespace, preserves
// pre-formatted data/http URIs, normalizes line-wrapped base64 by stripping
// CR/LF/whitespace, and validates raw base64 before prefixing.
func InlinePNGDataURL(raw string) string {
	raw = strings.TrimSpace(raw)
	if raw == "" {
		return ""
	}
	if strings.HasPrefix(raw, "data:image/") || strings.HasPrefix(raw, "http://") || strings.HasPrefix(raw, "https://") {
		return raw
	}
	cleaned := strings.Map(func(r rune) rune {
		if r == '\r' || r == '\n' || r == ' ' || r == '\t' {
			return -1
		}
		return r
	}, raw)
	if cleaned == "" {
		return ""
	}
	if _, err := base64.StdEncoding.DecodeString(cleaned); err != nil {
		if _, rerr := base64.RawStdEncoding.DecodeString(cleaned); rerr != nil {
			return raw
		}
	}
	return "data:image/png;base64," + cleaned
}

// SectionsToJSON converts Sections to a Python-compatible JSON dict format.
//
// Each dict has keys: text, layout_type, doc_type_kwd, _pdf_positions, image.
// The _pdf_positions key mirrors Python's PDF_POSITIONS_KEY constant —
// the canonical position format consumed by the chunker's extract_pdf_positions.
//
// This mirrors the Python parser.py:662 set_output("json", bboxes) path.
func SectionsToJSON(sections []pdf.Section) []map[string]any {
	result := make([]map[string]any, len(sections))
	for i, s := range sections {
		positions := make([][]any, len(s.Positions))
		for j, p := range s.Positions {
			pages := make([]any, len(p.PageNumbers))
			for k, pn := range p.PageNumbers {
				pages[k] = pn
			}
			positions[j] = []any{pages, p.Left, p.Right, p.Top, p.Bottom}
		}
		result[i] = map[string]any{
			"text":           s.Text,
			"layout_type":    s.LayoutType,
			"doc_type_kwd":   s.DocTypeKwd,
			"_pdf_positions": positions,
			"image":          s.Image,
		}
	}
	return result
}