dxpdf 0.2.8

//! DrawingML types — images, pictures, shapes, anchoring, and preset geometry.

use crate::model::dimension::{Dimension, Emu, SixtieThousandthDeg, ThousandthPercent};
use crate::model::geometry::{EdgeInsets, Offset, Size};

use super::content::Block;
use super::drawing_color::DrawingColor;
use super::identifiers::RelId;

/// Format of an embedded image, detected from the OOXML relationship target path
/// (§M.1.1) with magic-byte fallback.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum ImageFormat {
    Png,
    Jpeg,
    Gif,
    Bmp,
    Tiff,
    /// Windows Enhanced Metafile (MS-EMF).
    Emf,
    /// Windows Metafile (MS-WMF).
    Wmf,
    Svg,
    WebP,
    Unknown,
}

impl ImageFormat {
    /// Detect format from the relationship target file extension (OOXML §M.1.1)
    /// with magic-byte fallback for unrecognised or missing extensions.
    pub fn detect(target_path: &str, data: &[u8]) -> Self {
        let ext = target_path
            .rsplit('.')
            .next()
            .map(|e| e.to_ascii_lowercase());
        match ext.as_deref() {
            Some("png") => Self::Png,
            Some("jpg" | "jpeg") => Self::Jpeg,
            Some("gif") => Self::Gif,
            Some("bmp") => Self::Bmp,
            Some("tif" | "tiff") => Self::Tiff,
            Some("emf") => Self::Emf,
            Some("wmf") => Self::Wmf,
            Some("svg" | "svgz") => Self::Svg,
            Some("webp") => Self::WebP,
            _ => Self::detect_by_magic(data),
        }
    }

    /// Magic-byte detection for the most common raster formats.
    fn detect_by_magic(data: &[u8]) -> Self {
        match data {
            [0x89, b'P', b'N', b'G', ..] => Self::Png,
            [0xFF, 0xD8, 0xFF, ..] => Self::Jpeg,
            [b'G', b'I', b'F', b'8', ..] => Self::Gif,
            [b'B', b'M', ..] => Self::Bmp,
            // EMF header: RecordType=0x00000001 followed by size, then EMF signature 0x464D4520
            [0x01, 0x00, 0x00, 0x00, _, _, _, _, 0x20, 0x45, 0x4D, 0x46, ..] => Self::Emf,
            [b'R', b'I', b'F', b'F', _, _, _, _, b'W', b'E', b'B', b'P', ..] => Self::WebP,
            [b'<', ..] => Self::Svg,
            _ => Self::Unknown,
        }
    }
}

#[derive(Clone, Debug)]
pub struct Image {
    /// §20.4.2.7: drawing extent.
    pub extent: Size<Emu>,
    /// §20.4.2.6: additional extent for effects.
    pub effect_extent: Option<EdgeInsets<Emu>>,
    /// §20.1.2.2.8: non-visual drawing properties (wp:docPr).
    pub doc_properties: DocProperties,
    /// §20.4.2.4: graphic frame locking properties.
    pub graphic_frame_locks: Option<GraphicFrameLocks>,
    /// Graphic content from a:graphic > a:graphicData.
    pub graphic: Option<GraphicContent>,
    /// Inline or anchor placement.
    pub placement: ImagePlacement,
}

/// How the image is placed in the document flow.
#[derive(Clone, Debug)]
pub enum ImagePlacement {
    /// §20.4.2.8: inline with text — no wrapping.
    Inline {
        /// Distance from surrounding text.
        distance: EdgeInsets<Emu>,
    },
    /// §20.4.2.3: floating/anchored with text wrapping.
    Anchor(AnchorProperties),
}

/// §20.1.2.2.8 CT_NonVisualDrawingProps — shared by wp:docPr and pic:cNvPr.
#[derive(Clone, Debug)]
pub struct DocProperties {
    /// Unique identifier.
    pub id: u32,
    /// Element name.
    pub name: String,
    /// Alternative text description.
    pub description: Option<String>,
    /// Whether the element is hidden.
    pub hidden: Option<bool>,
    /// Title (Office 2010+).
    pub title: Option<String>,
}

/// §20.1.2.2.19 CT_GraphicalObjectFrameLocking.
#[derive(Clone, Copy, Debug)]
pub struct GraphicFrameLocks {
    pub no_change_aspect: Option<bool>,
    pub no_drilldown: Option<bool>,
    pub no_grp: Option<bool>,
    pub no_move: Option<bool>,
    pub no_resize: Option<bool>,
    pub no_select: Option<bool>,
}

/// Content type inside a:graphicData.
#[derive(Clone, Debug)]
pub enum GraphicContent {
    /// §19.3.1.37: picture.
    Picture(Picture),
    /// §14.5 wps:wsp: Word Processing Shape.
    WordProcessingShape(WordProcessingShape),
}

/// §14.5 wps:wsp — a Word Processing Shape.
/// Contains shape properties and optional text body.
#[derive(Clone, Debug)]
pub struct WordProcessingShape {
    /// §20.1.2.2.8: non-visual drawing properties.
    pub cnv_pr: Option<DocProperties>,
    /// §20.1.2.2.35: shape properties.
    pub shape_properties: Option<ShapeProperties>,
    /// §20.1.2.2.45 wps:style / §20.1.4.1.22 a:lnRef — reference to a theme
    /// line style. Attributes absent from the direct `<a:ln>` inherit from
    /// the referenced theme line style (e.g. width when `<a:ln>` omits `@w`).
    pub style_line_ref: Option<StyleMatrixRef>,
    /// §20.1.2.2.45 wps:style / §20.1.4.1.10 a:effectRef — reference to a
    /// theme effect style. Word treats a present-but-empty `<a:effectLst/>`
    /// on spPr as inheritance from this reference, so resolve consults it
    /// when the direct effect list is absent or empty.
    pub style_effect_ref: Option<StyleMatrixRef>,
    /// §20.1.2.1.1: body properties (text layout within the shape).
    pub body_pr: Option<BodyProperties>,
    /// §17.17.1: text content inside the shape.
    pub txbx_content: Vec<Block>,
}

/// §20.1.4.2.19 CT_StyleMatrixReference — a 1-based index into one of the
/// theme's style matrices (`fillStyleLst`, `lnStyleLst`, `effectStyleLst`,
/// `bgFillStyleLst`) paired with an optional color used to substitute
/// `phClr` placeholders within the referenced style.
#[derive(Clone, Debug)]
pub struct StyleMatrixRef {
    pub idx: u32,
    pub color: Option<DrawingColor>,
}

/// §20.1.2.1.1 CT_TextBodyProperties — text body properties inside a shape.
#[derive(Clone, Debug)]
pub struct BodyProperties {
    /// Rotation of the text body in 60,000ths of a degree.
    pub rotation: Option<Dimension<SixtieThousandthDeg>>,
    /// §20.1.10.82 ST_TextVerticalType: vertical text mode.
    pub vert: Option<TextVerticalType>,
    /// §20.1.10.85 ST_TextWrappingType: text wrapping within the shape.
    pub wrap: Option<TextWrappingType>,
    /// Left inset in EMU.
    pub left_inset: Option<Dimension<Emu>>,
    /// Top inset in EMU.
    pub top_inset: Option<Dimension<Emu>>,
    /// Right inset in EMU.
    pub right_inset: Option<Dimension<Emu>>,
    /// Bottom inset in EMU.
    pub bottom_inset: Option<Dimension<Emu>>,
    /// §20.1.10.59 ST_TextAnchoringType: vertical anchor.
    pub anchor: Option<TextAnchoringType>,
    /// Auto-fit mode.
    pub auto_fit: Option<TextAutoFit>,
}

/// §20.1.10.82 ST_TextVerticalType.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum TextVerticalType {
    Horz,
    Vert,
    Vert270,
    WordArtVert,
    EaVert,
    MongolianVert,
    WordArtVertRtl,
}

/// §20.1.10.85 ST_TextWrappingType.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum TextWrappingType {
    None,
    Square,
}

/// §20.1.10.59 ST_TextAnchoringType.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum TextAnchoringType {
    Top,
    Center,
    Bottom,
    Justified,
    Distributed,
}

/// Text auto-fit mode for shape text bodies.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum TextAutoFit {
    /// §20.1.2.1.16: no auto-fit.
    NoAutoFit,
    /// §20.1.2.1.18: shrink text to fit.
    NormalAutoFit,
    /// §20.1.2.1.20: resize shape to fit text.
    SpAutoFit,
}

/// §19.3.1.37 pic:pic — a picture element.
#[derive(Clone, Debug)]
pub struct Picture {
    /// §19.3.1.32: non-visual picture properties.
    pub nv_pic_pr: NvPicProperties,
    /// §20.1.8.14: blip fill (picture data + crop + fill mode).
    pub blip_fill: BlipFill,
    /// §20.1.2.2.35: shape properties (transform, geometry, outline).
    pub shape_properties: Option<ShapeProperties>,
}

/// §19.3.1.32 pic:nvPicPr — non-visual picture properties.
#[derive(Clone, Debug)]
pub struct NvPicProperties {
    /// §20.1.2.2.8 pic:cNvPr.
    pub cnv_pr: DocProperties,
    /// §19.3.1.4 pic:cNvPicPr.
    pub cnv_pic_pr: Option<CnvPicProperties>,
}

/// §19.3.1.4 pic:cNvPicPr — non-visual picture drawing properties.
#[derive(Clone, Debug)]
pub struct CnvPicProperties {
    pub prefer_relative_resize: Option<bool>,
    /// §20.1.2.2.31: picture locking.
    pub pic_locks: Option<PicLocks>,
}

/// §20.1.2.2.31 a:picLocks — picture locking constraints.
#[derive(Clone, Copy, Debug)]
pub struct PicLocks {
    pub no_change_aspect: Option<bool>,
    pub no_crop: Option<bool>,
    pub no_resize: Option<bool>,
    pub no_move: Option<bool>,
    pub no_rot: Option<bool>,
    pub no_select: Option<bool>,
    pub no_edit_points: Option<bool>,
    pub no_adjust_handles: Option<bool>,
    pub no_change_arrowheads: Option<bool>,
    pub no_change_shape_type: Option<bool>,
    pub no_grp: Option<bool>,
}

/// §20.1.8.14 CT_BlipFillProperties — image fill. Used both as a picture
/// content (via `Picture.blip_fill`) and as an `EG_FillProperties` choice
/// inside shape `spPr`/outline fills.
#[derive(Clone, Debug)]
pub struct BlipFill {
    pub rotate_with_shape: Option<bool>,
    pub dpi: Option<u32>,
    /// §20.1.8.13: blip reference.
    pub blip: Option<Blip>,
    /// §20.1.10.48: source rectangle (crop).
    pub src_rect: Option<RelativeRect>,
    /// §20.1.8.14 choice: stretch, tile, or neither.
    pub fill_kind: BlipFillKind,
}

/// §20.1.8.14 fill presentation — stretch into fillRect or tile.
///
/// Per spec the choice is optional; `Unspecified` is Word's default
/// (equivalent to `Stretch` with no `fillRect`).
#[derive(Clone, Debug)]
pub enum BlipFillKind {
    Stretch(StretchFill),
    Tile(TileFill),
    Unspecified,
}

/// §20.1.8.58 CT_TileInfoProperties — tiled blip fill parameters.
#[derive(Clone, Copy, Debug)]
pub struct TileFill {
    /// Translate X in EMU.
    pub tx: Option<Dimension<Emu>>,
    /// Translate Y in EMU.
    pub ty: Option<Dimension<Emu>>,
    /// Scale X (1000ths of a percent).
    pub sx: Option<Dimension<ThousandthPercent>>,
    /// Scale Y (1000ths of a percent).
    pub sy: Option<Dimension<ThousandthPercent>>,
    /// §20.1.10.86: tile flip mode.
    pub flip: Option<TileFlipMode>,
    /// §20.1.10.53: alignment of the tiled blip within the fill rect.
    pub alignment: Option<RectAlignment>,
}

/// §20.1.8.13 a:blip — reference to image data.
#[derive(Clone, Debug)]
pub struct Blip {
    /// r:embed — relationship ID for embedded image.
    pub embed: Option<RelId>,
    /// r:link — relationship ID for linked (external) image.
    pub link: Option<RelId>,
    /// §20.1.10.7: compression state.
    pub compression: Option<BlipCompression>,
}

/// §20.1.10.7 ST_BlipCompression.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum BlipCompression {
    Email,
    Hqprint,
    None,
    Print,
    Screen,
}

/// §20.1.10.48 CT_RelativeRect — relative rectangle (thousandths of percent).
/// Used for a:srcRect and a:fillRect.
#[derive(Clone, Copy, Debug)]
pub struct RelativeRect {
    pub left: Option<Dimension<ThousandthPercent>>,
    pub top: Option<Dimension<ThousandthPercent>>,
    pub right: Option<Dimension<ThousandthPercent>>,
    pub bottom: Option<Dimension<ThousandthPercent>>,
}

/// §20.1.8.56 a:stretch — stretch fill mode.
#[derive(Clone, Copy, Debug)]
pub struct StretchFill {
    /// §20.1.10.48: fill rectangle.
    pub fill_rect: Option<RelativeRect>,
}

/// §20.1.2.2.35 CT_ShapeProperties — shape visual properties.
#[derive(Clone, Debug)]
pub struct ShapeProperties {
    /// §20.1.10.10: black-and-white mode.
    pub bw_mode: Option<BlackWhiteMode>,
    /// §20.1.7.6: 2D transform.
    pub transform: Option<Transform2D>,
    /// §20.1.9.18 prstGeom or §20.1.9.8 custGeom — shape geometry.
    pub geometry: Option<ShapeGeometry>,
    /// Fill type (noFill, solidFill, etc.).
    pub fill: Option<DrawingFill>,
    /// §20.1.2.2.24: outline/line properties.
    pub outline: Option<Outline>,
    /// §20.1.8.24: shape effects, in document order.
    pub effect_list: Option<EffectList>,
}

/// §20.1.7.6 CT_Transform2D — 2D transform.
#[derive(Clone, Copy, Debug)]
pub struct Transform2D {
    /// Rotation in 60,000ths of a degree (§20.1.10.3).
    pub rotation: Option<Dimension<SixtieThousandthDeg>>,
    pub flip_h: Option<bool>,
    pub flip_v: Option<bool>,
    /// §20.1.7.4: offset (x, y).
    pub offset: Option<Offset<Emu>>,
    /// §20.1.7.3: extent (cx, cy).
    pub extent: Option<Size<Emu>>,
}

/// §20.1.9.18 CT_PresetGeometry2D — preset shape geometry.
#[derive(Clone, Debug)]
pub struct PresetGeometryDef {
    /// §20.1.10.56: preset shape type.
    pub preset: PresetShapeType,
    /// §20.1.9.5: adjustment values.
    pub adjust_values: Vec<GeomGuide>,
}

/// §20.1.9.11 CT_GeomGuide — geometry guide (named formula).
#[derive(Clone, Debug)]
pub struct GeomGuide {
    pub name: String,
    pub formula: String,
}

// ── §20.1.9.8 CT_CustomGeometry2D ──────────────────────────────────────────

/// §20.1.9.8 CT_CustomGeometry2D — user-defined shape geometry.
///
/// The coordinate system is defined by the `path` element's `w` and `h`
/// attributes. Guides in `av_list` are user-adjustable values (shipped with
/// the authored shape); guides in `gd_list` are computed from formulas
/// referencing other guides, `w`/`h`, and the spec's named constants.
#[derive(Clone, Debug, Default)]
pub struct CustomGeometry {
    /// §20.1.9.1 avLst — adjust-value list (user-editable guides).
    pub av_list: Vec<GeomGuide>,
    /// §20.1.9.10 gdLst — computed-guide list.
    pub gd_list: Vec<GeomGuide>,
    /// §20.1.9.1 ahLst — adjust-handle list.
    pub ah_list: Vec<AdjustHandle>,
    /// §20.1.9.7 cxnLst — connection sites.
    pub cxn_list: Vec<ConnectionSite>,
    /// §20.1.9.22 rect — text rectangle within the shape.
    pub rect: Option<TextRect>,
    /// §20.1.9.15 pathLst — the actual path(s).
    pub paths: Vec<PathDef>,
}

/// §20.1.9.15 CT_Path2D — one path in a custom geometry.
#[derive(Clone, Debug)]
pub struct PathDef {
    /// Path-local coordinate width in EMUs.
    pub w: Dimension<Emu>,
    /// Path-local coordinate height in EMUs.
    pub h: Dimension<Emu>,
    /// §20.1.10.45: path fill mode.
    pub fill: PathFillMode,
    /// §20.1.9.15 @stroke — whether the path is stroked.
    pub stroke: bool,
    /// §20.1.9.15 @extrusionOk — whether 3D extrusion is permitted.
    pub extrusion_ok: bool,
    /// Path verbs (moveTo/lnTo/cubicBezTo/quadBezTo/arcTo/close) in order.
    pub commands: Vec<PathCommand>,
}

/// §20.1.10.45 ST_PathFillMode.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash)]
pub enum PathFillMode {
    /// No fill (`"none"`).
    None,
    /// Normal fill (`"norm"`). Default per spec.
    #[default]
    Norm,
    /// `"lighten"`.
    Lighten,
    /// `"lightenLess"`.
    LightenLess,
    /// `"darken"`.
    Darken,
    /// `"darkenLess"`.
    DarkenLess,
}

/// §20.1.9.14 / §20.1.9.2 / §20.1.9.19 / §20.1.9.3 / §20.1.9.4 — path verbs.
#[derive(Clone, Debug)]
pub enum PathCommand {
    /// §20.1.9.14 moveTo.
    MoveTo(AdjPoint),
    /// §20.1.9.13 lnTo.
    LineTo(AdjPoint),
    /// §20.1.9.2 cubicBezTo — three control points (two controls + endpoint).
    CubicBezTo(AdjPoint, AdjPoint, AdjPoint),
    /// §20.1.9.19 quadBezTo — two control points (control + endpoint).
    QuadBezTo(AdjPoint, AdjPoint),
    /// §20.1.9.3 arcTo — elliptical arc.
    ArcTo {
        /// Horizontal radius (any AdjCoord expression).
        wr: AdjCoord,
        /// Vertical radius.
        hr: AdjCoord,
        /// Start angle (any AdjAngle expression).
        start_angle: AdjAngle,
        /// Swing angle (arc sweep).
        swing_angle: AdjAngle,
    },
    /// §20.1.9.4 close — close the current subpath.
    Close,
}

/// §20.1.9.12 CT_AdjPoint2D — a point in path-local coordinates.
#[derive(Clone, Debug)]
pub struct AdjPoint {
    pub x: AdjCoord,
    pub y: AdjCoord,
}

/// Coordinate value: either a literal integer (EMU when positional, raw
/// integer for size attributes) or a guide-name reference that the evaluator
/// resolves via the enclosing `PathDef`/`CustomGeometry` guide scope.
#[derive(Clone, Debug, PartialEq)]
pub enum AdjCoord {
    Lit(i64),
    Guide(String),
}

/// §20.1.10.4 ST_AdjAngle — angle value (shares the `AdjCoord` shape).
pub type AdjAngle = AdjCoord;

/// §20.1.9.1 CT_AdjustHandleList — each entry may be XY or polar. For Tier 0
/// we capture the raw structure (positions + guide references); evaluators
/// can derive concrete handle positions from the enclosing geometry.
#[derive(Clone, Debug)]
pub enum AdjustHandle {
    /// §20.1.9.1.1 ahXY.
    XY {
        guide_ref_x: Option<String>,
        guide_ref_y: Option<String>,
        min_x: Option<AdjCoord>,
        max_x: Option<AdjCoord>,
        min_y: Option<AdjCoord>,
        max_y: Option<AdjCoord>,
        position: AdjPoint,
    },
    /// §20.1.9.1.2 ahPolar.
    Polar {
        guide_ref_r: Option<String>,
        guide_ref_ang: Option<String>,
        min_r: Option<AdjCoord>,
        max_r: Option<AdjCoord>,
        min_ang: Option<AdjAngle>,
        max_ang: Option<AdjAngle>,
        position: AdjPoint,
    },
}

/// §20.1.9.7 CT_ConnectionSite — attachment point on a shape boundary.
#[derive(Clone, Debug)]
pub struct ConnectionSite {
    /// §20.1.9.7 @ang — angle of the connection site (any AdjAngle expression).
    pub angle: AdjAngle,
    pub position: AdjPoint,
}

/// §20.1.9.22 CT_GeomRect — text bounds within a shape, as AdjCoord.
#[derive(Clone, Debug)]
pub struct TextRect {
    pub left: AdjCoord,
    pub top: AdjCoord,
    pub right: AdjCoord,
    pub bottom: AdjCoord,
}

/// The unified geometry reference for a shape — either a preset or fully
/// custom. Populated by `parse_shape_properties` from either `<a:prstGeom>`
/// or `<a:custGeom>`.
#[derive(Clone, Debug)]
pub enum ShapeGeometry {
    Preset(PresetGeometryDef),
    Custom(CustomGeometry),
}

/// §20.1.10.56 ST_ShapeType — preset shape types (subset).
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum PresetShapeType {
    Rect,
    RoundRect,
    Ellipse,
    Triangle,
    RtTriangle,
    Diamond,
    Parallelogram,
    Trapezoid,
    Pentagon,
    Hexagon,
    Octagon,
    Star4,
    Star5,
    Star6,
    Star8,
    Star10,
    Star12,
    Star16,
    Star24,
    Star32,
    Line,
    Plus,
    Can,
    Cube,
    Donut,
    NoSmoking,
    BlockArc,
    Heart,
    Sun,
    Moon,
    SmileyFace,
    LightningBolt,
    Cloud,
    Arc,
    Plaque,
    Frame,
    Bevel,
    FoldedCorner,
    Chevron,
    HomePlate,
    Ribbon,
    Ribbon2,
    Pie,
    PieWedge,
    Chord,
    Teardrop,
    Arrow,
    LeftArrow,
    RightArrow,
    UpArrow,
    DownArrow,
    LeftRightArrow,
    UpDownArrow,
    QuadArrow,
    BentArrow,
    UturnArrow,
    CircularArrow,
    CurvedRightArrow,
    CurvedLeftArrow,
    CurvedUpArrow,
    CurvedDownArrow,
    StripedRightArrow,
    NotchedRightArrow,
    BentUpArrow,
    LeftUpArrow,
    LeftRightUpArrow,
    LeftArrowCallout,
    RightArrowCallout,
    UpArrowCallout,
    DownArrowCallout,
    LeftRightArrowCallout,
    UpDownArrowCallout,
    QuadArrowCallout,
    SwooshArrow,
    LeftCircularArrow,
    LeftRightCircularArrow,
    Callout1,
    Callout2,
    Callout3,
    AccentCallout1,
    AccentCallout2,
    AccentCallout3,
    BorderCallout1,
    BorderCallout2,
    BorderCallout3,
    AccentBorderCallout1,
    AccentBorderCallout2,
    AccentBorderCallout3,
    WedgeRectCallout,
    WedgeRoundRectCallout,
    WedgeEllipseCallout,
    CloudCallout,
    LeftBracket,
    RightBracket,
    LeftBrace,
    RightBrace,
    BracketPair,
    BracePair,
    StraightConnector1,
    BentConnector2,
    BentConnector3,
    BentConnector4,
    BentConnector5,
    CurvedConnector2,
    CurvedConnector3,
    CurvedConnector4,
    CurvedConnector5,
    FlowChartProcess,
    FlowChartDecision,
    FlowChartInputOutput,
    FlowChartPredefinedProcess,
    FlowChartInternalStorage,
    FlowChartDocument,
    FlowChartMultidocument,
    FlowChartTerminator,
    FlowChartPreparation,
    FlowChartManualInput,
    FlowChartManualOperation,
    FlowChartConnector,
    FlowChartPunchedCard,
    FlowChartPunchedTape,
    FlowChartSummingJunction,
    FlowChartOr,
    FlowChartCollate,
    FlowChartSort,
    FlowChartExtract,
    FlowChartMerge,
    FlowChartOfflineStorage,
    FlowChartOnlineStorage,
    FlowChartMagneticTape,
    FlowChartMagneticDisk,
    FlowChartMagneticDrum,
    FlowChartDisplay,
    FlowChartDelay,
    FlowChartAlternateProcess,
    FlowChartOffpageConnector,
    ActionButtonBlank,
    ActionButtonHome,
    ActionButtonHelp,
    ActionButtonInformation,
    ActionButtonForwardNext,
    ActionButtonBackPrevious,
    ActionButtonEnd,
    ActionButtonBeginning,
    ActionButtonReturn,
    ActionButtonDocument,
    ActionButtonSound,
    ActionButtonMovie,
    IrregularSeal1,
    IrregularSeal2,
    Wave,
    DoubleWave,
    EllipseRibbon,
    EllipseRibbon2,
    VerticalScroll,
    HorizontalScroll,
    LeftRightRibbon,
    Gear6,
    Gear9,
    Funnel,
    MathPlus,
    MathMinus,
    MathMultiply,
    MathDivide,
    MathEqual,
    MathNotEqual,
    CornerTabs,
    SquareTabs,
    PlaqueTabs,
    ChartX,
    ChartStar,
    ChartPlus,
    HalfFrame,
    Corner,
    DiagStripe,
    NonIsoscelesTrapezoid,
    Heptagon,
    Decagon,
    Dodecagon,
    Round1Rect,
    Round2SameRect,
    Round2DiagRect,
    SnipRoundRect,
    Snip1Rect,
    Snip2SameRect,
    Snip2DiagRect,
    /// Unrecognized shape type — preserved as raw string.
    Other(String),
}

/// §20.1.10.10 ST_BlackWhiteMode.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum BlackWhiteMode {
    Auto,
    Black,
    BlackGray,
    BlackWhite,
    Clr,
    Gray,
    GrayWhite,
    Hidden,
    InvGray,
    LtGray,
    White,
}

/// §20.1.8 EG_FillProperties — fill choice for shapes, outlines, overlays.
///
/// Every base fill carries its own structure; pattern of use is
/// `match fill { DrawingFill::Solid(color) => …, … }`.
#[derive(Clone, Debug)]
pub enum DrawingFill {
    /// §20.1.8.44 noFill — transparent.
    None,
    /// §20.1.8.54 solidFill — single color.
    Solid(DrawingColor),
    /// §20.1.8.33 gradFill — gradient with stops and a shade shape.
    Gradient(GradientFill),
    /// §20.1.8.14 blipFill — image fill.
    Blip(BlipFill),
    /// §20.1.8.47 pattFill — preset pattern with fg/bg colors.
    Pattern(PatternFill),
    /// §20.1.8.35 grpFill — inherit fill from the enclosing group.
    Group,
}

/// §20.1.8.33 CT_GradientFillProperties.
#[derive(Clone, Debug)]
pub struct GradientFill {
    /// §20.1.8.37 gsLst — gradient stops, in document order.
    pub stops: Vec<GradientStop>,
    /// The gradient shape: linear at an angle, or a path-based (radial etc.).
    pub shade_properties: GradientShadeProperties,
    /// §20.1.10.86 @flip — tile flip mode.
    pub flip: Option<TileFlipMode>,
    /// §20.1.8.33 @rotWithShape — rotate with the containing shape.
    pub rot_with_shape: Option<bool>,
    /// §20.1.8.56 tileRect — source rect within the gradient's conceptual area.
    pub tile_rect: Option<RelativeRect>,
}

/// §20.1.8.38 CT_GradientStop.
#[derive(Clone, Debug)]
pub struct GradientStop {
    /// §20.1.10.42 @pos — stop position in 1000ths of a percent [0, 100000].
    pub position: Dimension<ThousandthPercent>,
    pub color: DrawingColor,
}

/// §20.1.8.33 EG_ShadeProperties — the gradient's geometric shape.
#[derive(Clone, Debug)]
pub enum GradientShadeProperties {
    /// §20.1.8.41 lin — linear gradient at `angle`.
    Linear {
        /// Angle in 60000ths of a degree.
        angle: Dimension<SixtieThousandthDeg>,
        /// §20.1.8.41 @scaled — scale gradient with shape.
        scaled: Option<bool>,
    },
    /// §20.1.8.46 path — radial / shape / rect gradient.
    Path {
        path_type: PathShadeType,
        fill_to_rect: Option<RelativeRect>,
    },
}

/// §20.1.10.46 ST_PathShadeType.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PathShadeType {
    Shape,
    Circle,
    Rect,
}

/// §20.1.10.86 ST_TileFlipMode.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum TileFlipMode {
    None,
    X,
    Y,
    Xy,
}

/// §20.1.8.47 CT_PatternFillProperties.
#[derive(Clone, Debug)]
pub struct PatternFill {
    /// §20.1.10.50 @prst — preset pattern.
    pub preset: PresetPatternVal,
    /// §20.1.8.30 fgClr — foreground color.
    pub fg_color: Option<DrawingColor>,
    /// §20.1.8.10 bgClr — background color.
    pub bg_color: Option<DrawingColor>,
}

/// §20.1.10.50 ST_PresetPatternVal — 48 preset pattern names.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PresetPatternVal {
    Pct5,
    Pct10,
    Pct20,
    Pct25,
    Pct30,
    Pct40,
    Pct50,
    Pct60,
    Pct70,
    Pct75,
    Pct80,
    Pct90,
    Horz,
    Vert,
    LtHorz,
    LtVert,
    DkHorz,
    DkVert,
    NarHorz,
    NarVert,
    DashHorz,
    DashVert,
    Cross,
    DnDiag,
    UpDiag,
    LtDnDiag,
    LtUpDiag,
    DkDnDiag,
    DkUpDiag,
    WdDnDiag,
    WdUpDiag,
    DashDnDiag,
    DashUpDiag,
    DiagCross,
    SmCheck,
    LgCheck,
    SmGrid,
    LgGrid,
    DotGrid,
    SmConfetti,
    LgConfetti,
    HorzBrick,
    DiagBrick,
    SolidDmnd,
    OpenDmnd,
    DotDmnd,
    Plaid,
    Sphere,
    Weave,
    DivotShingle,
    Trellis,
    ZigZag,
    Wave,
}

/// §20.1.10.53 ST_RectAlignment — nine-point rect alignment grid.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum RectAlignment {
    Tl,
    T,
    Tr,
    L,
    Ctr,
    R,
    Bl,
    B,
    Br,
}

/// §20.1.2.2.24 CT_LineProperties — full shape outline specification.
#[derive(Clone, Debug)]
pub struct Outline {
    /// §20.1.2.2.24 @w — line width in EMUs.
    pub width: Option<Dimension<Emu>>,
    /// §20.1.10.31: line cap style.
    pub cap: Option<LineCap>,
    /// §20.1.10.15: compound line type.
    pub compound: Option<CompoundLine>,
    /// §20.1.10.39: pen alignment.
    pub alignment: Option<PenAlignment>,
    /// §20.1.2.2.24 EG_LineFillProperties — outlines use any fill choice.
    pub fill: Option<DrawingFill>,
    /// §20.1.8.25: preset or custom dash pattern.
    pub dash: Option<LineDash>,
    /// §20.1.2.2.22: line join style.
    pub join: Option<LineJoin>,
    /// §20.1.2.2.12 headEnd — arrow at the line's head (start).
    pub head_end: Option<LineEnd>,
    /// §20.1.2.2.46 tailEnd — arrow at the line's tail (end).
    pub tail_end: Option<LineEnd>,
}

/// §20.1.8.25 CT_LineDashProperties — preset pattern or custom stop list.
#[derive(Clone, Debug)]
pub enum LineDash {
    /// §20.1.10.48: named preset pattern.
    Preset(PresetLineDashVal),
    /// §20.1.8.26 custDash — sequence of dash/space pairs.
    Custom(Vec<DashStop>),
}

/// §20.1.10.48 ST_PresetLineDashVal.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PresetLineDashVal {
    Solid,
    Dot,
    Dash,
    LgDash,
    DashDot,
    LgDashDot,
    LgDashDotDot,
    SysDash,
    SysDot,
    SysDashDot,
    SysDashDotDot,
}

/// §20.1.8.27 CT_DashStop — one dash/space pair in a custom dash pattern.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct DashStop {
    pub dash: Dimension<ThousandthPercent>,
    pub space: Dimension<ThousandthPercent>,
}

/// §20.1.2.2.22 EG_LineJoinProperties — line join style.
#[derive(Clone, Copy, Debug, PartialEq)]
pub enum LineJoin {
    /// §20.1.8.42 round.
    Round,
    /// §20.1.8.9 bevel.
    Bevel,
    /// §20.1.8.43 miter with optional limit (1000ths of a percent).
    Miter {
        limit: Option<Dimension<ThousandthPercent>>,
    },
}

/// §20.1.2.2.12 / §20.1.2.2.46 CT_LineEndProperties — arrow head / tail.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct LineEnd {
    pub kind: LineEndType,
    pub width: LineEndSize,
    pub length: LineEndSize,
}

/// §20.1.10.33 ST_LineEndType.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum LineEndType {
    None,
    Triangle,
    Stealth,
    Diamond,
    Oval,
    Arrow,
}

/// §20.1.10.34 ST_LineEndWidth / §20.1.10.35 ST_LineEndLength (shared enum).
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum LineEndSize {
    Sm,
    Med,
    Lg,
}

/// §20.1.10.31 ST_LineCap.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum LineCap {
    Flat,
    Round,
    Square,
}

/// §20.1.10.15 ST_CompoundLine.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum CompoundLine {
    Single,
    Double,
    ThickThin,
    ThinThick,
    Triple,
}

/// §20.1.10.39 ST_PenAlignment.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum PenAlignment {
    Center,
    Inset,
}

/// §20.4.2.3 CT_Anchor — anchor/floating drawing properties.
#[derive(Clone, Debug)]
pub struct AnchorProperties {
    /// §20.4.2.3: distance from surrounding text.
    pub distance: EdgeInsets<Emu>,
    /// §20.4.2.13: simple positioning point.
    pub simple_pos: Option<Offset<Emu>>,
    /// §20.4.2.3 @simplePos: whether to use simplePos coordinates.
    pub use_simple_pos: Option<bool>,
    /// §20.4.2.10: horizontal position.
    pub horizontal_position: AnchorPosition,
    /// §20.4.2.11: vertical position.
    pub vertical_position: AnchorPosition,
    /// Text wrapping mode.
    pub wrap: TextWrap,
    /// §20.4.2.3 @behindDoc: behind document text.
    pub behind_text: bool,
    /// §20.4.2.3 @locked: anchor is locked to position.
    pub lock_anchor: bool,
    /// §20.4.2.3 @allowOverlap: can overlap other anchored objects.
    pub allow_overlap: bool,
    /// §20.4.2.3 @relativeHeight: z-ordering value.
    pub relative_height: u32,
    /// §20.4.2.3 @layoutInCell: allow layout inside table cell.
    pub layout_in_cell: Option<bool>,
    /// §20.4.2.3 @hidden: whether the anchor is hidden.
    pub hidden: Option<bool>,
}

/// §20.4.2.10 / §20.4.2.11: anchor position (offset or alignment).
#[derive(Clone, Copy, Debug)]
pub enum AnchorPosition {
    /// §20.4.2.12: position by EMU offset from relativeFrom.
    Offset {
        relative_from: AnchorRelativeFrom,
        offset: Dimension<Emu>,
    },
    /// §20.4.2.1: position by alignment within relativeFrom.
    Align {
        relative_from: AnchorRelativeFrom,
        alignment: AnchorAlignment,
    },
}

/// §20.4.3.4 ST_RelFromH / §20.4.3.5 ST_RelFromV — relative-from values.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum AnchorRelativeFrom {
    Page,
    Margin,
    Column,
    Character,
    Paragraph,
    Line,
    InsideMargin,
    OutsideMargin,
    TopMargin,
    BottomMargin,
    LeftMargin,
    RightMargin,
}

/// §20.4.3.1 ST_AlignH / §20.4.3.2 ST_AlignV — alignment values.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum AnchorAlignment {
    Left,
    Center,
    Right,
    Inside,
    Outside,
    Top,
    Bottom,
}

/// Text wrapping mode for anchored drawings.
#[derive(Clone, Debug)]
pub enum TextWrap {
    /// §20.4.2.15: no wrapping.
    None,
    /// §20.4.2.17: square wrapping.
    Square {
        distance: EdgeInsets<Emu>,
        wrap_text: WrapText,
    },
    /// §20.4.2.16: tight wrapping around the shape's polygon outline.
    /// `polygon` is optional: malformed documents may omit it and are
    /// treated as square-wrap approximations at layout time.
    Tight {
        distance: EdgeInsets<Emu>,
        wrap_text: WrapText,
        polygon: Option<WrapPolygon>,
    },
    /// §20.4.2.18: text above and below only.
    TopAndBottom {
        distance_top: Dimension<Emu>,
        distance_bottom: Dimension<Emu>,
    },
    /// §20.4.2.14: through wrapping — text flows through polygon interior.
    Through {
        distance: EdgeInsets<Emu>,
        wrap_text: WrapText,
        polygon: Option<WrapPolygon>,
    },
}

/// §20.4.2.10 CT_WrapPath — the polygon outline used by `wrapTight` and
/// `wrapThrough`. `start` is the initial moveTo; `line_to` is the sequence
/// of subsequent edge endpoints; the polygon is implicitly closed back to
/// `start` (§20.4.2.10 spec note).
#[derive(Clone, Debug)]
pub struct WrapPolygon {
    /// @edited — whether the polygon has been hand-edited. Default false.
    pub edited: Option<bool>,
    /// §20.4.2.13 wp:start — first point (shape-local EMU coords).
    pub start: Offset<Emu>,
    /// §20.4.2.11 wp:lineTo — edge sequence after `start`. The spec
    /// requires at least two lineTo entries (polygon must have ≥3 points
    /// total when closed); malformed shorter inputs are accepted but will
    /// be skipped at layout time.
    pub line_to: Vec<Offset<Emu>>,
}

/// §20.4.3.7 ST_WrapText — which sides text wraps on.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum WrapText {
    BothSides,
    Left,
    Right,
    Largest,
}

// ── §20.1.8.24 CT_EffectList — shape effects ─────────────────────────────────

/// §20.1.8.24 CT_EffectList — an ordered sequence of shape effects.
///
/// Each variant is applied in order. The spec also defines §20.1.8.25
/// CT_EffectContainer (`effectDag`) for arbitrary compositing; our parser
/// accepts only `effectLst` and logs-and-skips `effectDag` for Tier 0.
#[derive(Clone, Debug, Default)]
pub struct EffectList {
    pub effects: Vec<Effect>,
}

/// §20.1.8 — effect variants.
#[derive(Clone, Debug)]
pub enum Effect {
    /// §20.1.8.15.
    Blur(BlurEffect),
    /// §20.1.8.29.
    FillOverlay(FillOverlayEffect),
    /// §20.1.8.32.
    Glow(GlowEffect),
    /// §20.1.8.40.
    InnerShdw(InnerShadowEffect),
    /// §20.1.8.45.
    OuterShdw(OuterShadowEffect),
    /// §20.1.8.49.
    PrstShdw(PresetShadowEffect),
    /// §20.1.8.50.
    Reflection(ReflectionEffect),
    /// §20.1.8.53.
    SoftEdge(SoftEdgeEffect),
}

/// §20.1.8.15 CT_BlurEffect.
#[derive(Clone, Copy, Debug)]
pub struct BlurEffect {
    pub radius: Dimension<Emu>,
    pub grow: Option<bool>,
}

/// §20.1.8.29 CT_FillOverlayEffect.
#[derive(Clone, Debug)]
pub struct FillOverlayEffect {
    pub fill: DrawingFill,
    pub blend: BlendMode,
}

/// §20.1.8.32 CT_GlowEffect.
#[derive(Clone, Debug)]
pub struct GlowEffect {
    pub radius: Dimension<Emu>,
    pub color: DrawingColor,
}

/// §20.1.8.40 CT_InnerShadowEffect.
#[derive(Clone, Debug)]
pub struct InnerShadowEffect {
    pub blur_radius: Dimension<Emu>,
    pub distance: Dimension<Emu>,
    pub direction: Dimension<SixtieThousandthDeg>,
    pub color: DrawingColor,
}

/// §20.1.8.45 CT_OuterShadowEffect.
///
/// `sx/sy` are horizontal/vertical scale factors (1000ths of a percent);
/// `kx/ky` are skew angles (60000ths of a degree). All default to their
/// parent attribute defaults when absent.
#[derive(Clone, Debug)]
pub struct OuterShadowEffect {
    pub blur_radius: Dimension<Emu>,
    pub distance: Dimension<Emu>,
    pub direction: Dimension<SixtieThousandthDeg>,
    pub sx: Dimension<ThousandthPercent>,
    pub sy: Dimension<ThousandthPercent>,
    pub kx: Dimension<SixtieThousandthDeg>,
    pub ky: Dimension<SixtieThousandthDeg>,
    pub alignment: RectAlignment,
    pub rot_with_shape: Option<bool>,
    pub color: DrawingColor,
}

/// §20.1.8.49 CT_PresetShadowEffect.
#[derive(Clone, Debug)]
pub struct PresetShadowEffect {
    pub preset: PresetShadowVal,
    pub distance: Dimension<Emu>,
    pub direction: Dimension<SixtieThousandthDeg>,
    pub color: DrawingColor,
}

/// §20.1.10.51 ST_PresetShadowVal — 20 shadow presets.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PresetShadowVal {
    Shdw1,
    Shdw2,
    Shdw3,
    Shdw4,
    Shdw5,
    Shdw6,
    Shdw7,
    Shdw8,
    Shdw9,
    Shdw10,
    Shdw11,
    Shdw12,
    Shdw13,
    Shdw14,
    Shdw15,
    Shdw16,
    Shdw17,
    Shdw18,
    Shdw19,
    Shdw20,
}

/// §20.1.8.50 CT_ReflectionEffect.
#[derive(Clone, Copy, Debug)]
pub struct ReflectionEffect {
    pub blur_radius: Dimension<Emu>,
    pub start_alpha: Dimension<ThousandthPercent>,
    pub start_pos: Dimension<ThousandthPercent>,
    pub end_alpha: Dimension<ThousandthPercent>,
    pub end_pos: Dimension<ThousandthPercent>,
    pub distance: Dimension<Emu>,
    pub direction: Dimension<SixtieThousandthDeg>,
    pub fade_direction: Dimension<SixtieThousandthDeg>,
    pub sx: Dimension<ThousandthPercent>,
    pub sy: Dimension<ThousandthPercent>,
    pub kx: Dimension<SixtieThousandthDeg>,
    pub ky: Dimension<SixtieThousandthDeg>,
    pub alignment: RectAlignment,
    pub rot_with_shape: Option<bool>,
}

/// §20.1.8.53 CT_SoftEdgesEffect.
#[derive(Clone, Copy, Debug)]
pub struct SoftEdgeEffect {
    pub radius: Dimension<Emu>,
}

/// §20.1.10.11 ST_BlendMode.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum BlendMode {
    Over,
    Mult,
    Screen,
    Darken,
    Lighten,
}