package com.gzzm.lobster.parse;

import java.util.LinkedHashMap;
import java.util.Map;

/**
 * OutlineSection —— outline 中的一节 / One entry of the document outline.
 *
 * <p>语义见 {@code design-big-lobster-document-parsing} §2.2。
 */
public class OutlineSection {

    /** 全文档唯一短 id（如 s1 / sh1 / p3），LLM 传回来时作引用锚点. */
    private String id;

    /** markdown 标题层级，1~6；非标题段（sheet/page）可为 0 或 null. */
    private Integer level;

    /** 显示标题，已截断到合理长度. */
    private String title;

    /** markdown 字符偏移（起，含）. */
    private int startChar;

    /** markdown 字符偏移（止，不含）. */
    private int endChar;

    /** 附加信息：xlsx 记 rows/cols/renderedRows；pdf 记 pageStart/pageEnd 等. */
    private Map<String, Object> extra;

    public OutlineSection() {}

    public OutlineSection(String id, Integer level, String title, int startChar) {
        this.id = id;
        this.level = level;
        this.title = title;
        this.startChar = startChar;
        this.extra = new LinkedHashMap<>();
    }

    public String getId() { return id; }
    public void setId(String id) { this.id = id; }
    public Integer getLevel() { return level; }
    public void setLevel(Integer level) { this.level = level; }
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public int getStartChar() { return startChar; }
    public void setStartChar(int startChar) { this.startChar = startChar; }
    public int getEndChar() { return endChar; }
    public void setEndChar(int endChar) { this.endChar = endChar; }
    public Map<String, Object> getExtra() { return extra; }
    public void setExtra(Map<String, Object> extra) { this.extra = extra; }

    public void putExtra(String key, Object value) {
        if (extra == null) extra = new LinkedHashMap<>();
        extra.put(key, value);
    }
}