//! 备注母版 `<p:notesMaster>` 模型（TODO-045）。
//!
//! 备注母版是"主-版-页"三层中的备注页对应母版——所有 notesSlide
//! 默认继承它的形状与样式。对应 python-pptx 中 `NotesMaster` / `NotesMasterPart`。
//!
//! # 与 python-pptx 的对应
//!
//! - `pptx.parts.notesmaster.NotesMasterPart` ←→ 本模块 [`NotesMaster`] 的 OPC 宿主；
//! - `pptx.NotesMaster` ←→ [`crate::notes_masters::NotesMasterRef`] 高阶句柄。
//!
//! # 当前实现范围
//!
//! 本模块支持**读写双向**——`from_opc` 解析已有 .pptx 的 notesMaster，
//! `to_opc_package` 循环写出 notesMasterN.xml part + 关系 + notesMasterIdLst 元素。
//! `clrMap` / `notesStyle` 保留原始 XML 字符串以实现 round-trip 保真。
//!
//! # OOXML 结构
//!
//! ```text
//! <p:notesMaster>
//! <p:cSld>
//! <p:bg>?</p:bg> 可选背景
//! <p:spTree>...</p:spTree> 形状树（含占位符：日期/页码/正文等）
//! </p:cSld>
//! <p:clrMap .../> 颜色映射
//! <p:notesStyle>...</p:notesStyle> 备注文本样式
//! </p:notesMaster>
//! ```
use crate::oxml::shape::Sp;
use crate::oxml::slide::SlideBackground;
use crate::oxml::writer::XmlWriter;
/// 默认 `<p:notesStyle>` 内容（极简版，与 SldMaster 的 TX_STYLES 对齐）。
///
/// 包含 titleStyle / bodyStyle / otherStyle 各 1 个 lvl1pPr，确保 OOXML 校验通过。
/// round-trip 场景下优先使用解析到的原始 notesStyle XML。
const DEFAULT_NOTES_STYLE: &str = r##"<p:notesStyle><p:titleStyle><a:lvl1pPr algn="ctr" defTabSz="457200" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:spcBef><a:spcPct val="0"/></a:spcBef><a:buNone/><a:defRPr sz="4400" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill><a:latin typeface="+mj-lt"/><a:ea typeface="+mj-ea"/><a:cs typeface="+mj-cs"/></a:defRPr></a:lvl1pPr></p:titleStyle><p:bodyStyle><a:lvl1pPr marL="342900" indent="-342900" algn="l" defTabSz="457200" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:spcBef><a:spcPct val="20000"/></a:spcBef><a:buFont typeface="Arial"/><a:buChar char="•"/><a:defRPr sz="3200" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill><a:latin typeface="+mn-lt"/><a:ea typeface="+mj-ea"/><a:cs typeface="+mj-cs"/></a:defRPr></a:lvl1pPr></p:bodyStyle><p:otherStyle><a:defPPr><a:defRPr lang="en-US"/></a:defPPr><a:lvl1pPr marL="0" algn="l" defTabSz="457200" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:defRPr sz="1800" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill><a:latin typeface="+mn-lt"/><a:ea typeface="+mj-ea"/><a:cs typeface="+mj-cs"/></a:defRPr></a:lvl1pPr></p:otherStyle></p:notesStyle>"##;
/// 默认 `<p:clrMap>` 内容（与 SldMaster 对齐）。
const DEFAULT_CLR_MAP: &str = "<p:clrMap bg1=\"lt1\" tx1=\"dk1\" bg2=\"lt2\" tx2=\"dk2\" accent1=\"accent1\" accent2=\"accent2\" accent3=\"accent3\" accent4=\"accent4\" accent5=\"accent5\" accent6=\"accent6\" hlink=\"hlink\" folHlink=\"folHlink\"/>";
/// `<p:notesMaster>` 的内存模型。
///
/// 承载 `cSld/spTree` 内的形状列表 + 可选背景 + clrMap/notesStyle 原始 XML。
/// 读写双向支持：`from_opc` 解析时回填，`to_opc_package` 写出时调用 [`NotesMaster::to_xml`]。
#[derive(Clone, Debug, Default)]
pub struct NotesMaster {
/// 备注母版中的形状列表（`<p:cSld>/<p:spTree>` 内的 `<p:sp>`）。
pub shapes: Vec<Sp>,
/// 备注母版背景（`<p:bg>`，可选）。`None` 表示使用默认背景。
pub background: Option<SlideBackground>,
/// 原始 `<p:clrMap>` XML 字符串（round-trip 保真）。
///
/// `None` 时 [`NotesMaster::to_xml`] 使用 [`DEFAULT_CLR_MAP`]。
/// `Some` 时直接 raw 输出原始 XML，确保读→写不漂移。
pub clr_map_xml: Option<String>,
/// 原始 `<p:notesStyle>` XML 字符串（round-trip 保真）。
///
/// `None` 时 [`NotesMaster::to_xml`] 使用 [`DEFAULT_NOTES_STYLE`]。
/// `Some` 时直接 raw 输出原始 XML，确保读→写不漂移。
pub notes_style_xml: Option<String>,
}
impl NotesMaster {
/// 创建一个空的备注母版。
pub fn new() -> Self {
Self::default()
}
/// 形状数量。
pub fn len(&self) -> usize {
self.shapes.len()
}
/// 是否无形状。
pub fn is_empty(&self) -> bool {
self.shapes.is_empty()
}
/// 写出 `<p:notesMaster>` 完整 XML（notesMasterN.xml 内容）。
///
/// # 元素结构（OOXML 严格顺序）
///
/// ```text
/// <p:notesMaster xmlns:a=... xmlns:p=... xmlns:r=...>
/// <p:cSld>
/// <p:bg>?</p:bg> 可选背景
/// <p:spTree>...</p:spTree> 形状树
/// </p:cSld>
/// <p:clrMap .../> 颜色映射（优先用 clr_map_xml，否则默认）
/// <p:notesStyle>...</p:notesStyle> 备注文本样式（优先用 notes_style_xml，否则默认）
/// </p:notesMaster>
/// ```
///
/// # 与 python-pptx 的对应
///
/// python-pptx 不直接生成 notesMaster XML（仅读取），本库为 round-trip 保真实现写路径。
pub fn to_xml(&self) -> String {
let mut xml = String::with_capacity(1024);
xml.push_str("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n");
xml.push_str(
"<p:notesMaster xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\"",
);
xml.push_str(" xmlns:p=\"http://schemas.openxmlformats.org/presentationml/2006/main\"");
xml.push_str(
" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">",
);
// cSld —— 必须按 <p:bg>? <p:spTree> <p:custDataLst>? <p:controls>? <p:extLst>? 顺序
xml.push_str("<p:cSld>");
// 背景在 spTree 之前
if let Some(bg) = &self.background {
let mut w = XmlWriter::default();
bg.write_xml(&mut w);
xml.push_str(&w.into_string());
}
xml.push_str("<p:spTree>");
// nvGrpSpPr + grpSpPr (spTree 必填项)
xml.push_str(
"<p:nvGrpSpPr><p:cNvPr id=\"1\" name=\"\"/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>",
);
xml.push_str("<p:grpSpPr><a:xfrm><a:off x=\"0\" y=\"0\"/><a:ext cx=\"0\" cy=\"0\"/><a:chOff x=\"0\" y=\"0\"/><a:chExt cx=\"0\" cy=\"0\"/></a:xfrm></p:grpSpPr>");
// 用户 shapes
let mut w = XmlWriter::default();
for s in &self.shapes {
s.write_xml(&mut w);
}
xml.push_str(&w.into_string());
xml.push_str("</p:spTree></p:cSld>");
// clrMap —— 优先用解析到的原始 XML，否则用默认
if let Some(clr_map) = &self.clr_map_xml {
xml.push_str(clr_map);
} else {
xml.push_str(DEFAULT_CLR_MAP);
}
// notesStyle —— 优先用解析到的原始 XML，否则用默认
if let Some(notes_style) = &self.notes_style_xml {
xml.push_str(notes_style);
} else {
xml.push_str(DEFAULT_NOTES_STYLE);
}
xml.push_str("</p:notesMaster>");
xml
}
}