drawingml 1.0.0

//! `drawing` — shared DrawingML content model (shapes, fills, colors, lines) for the
//! WordprocessingML/SpreadsheetML/PresentationML crates.
//!
//! # Scope
//!
//! DrawingML (`dml-main.xsd`, ECMA-376/ISO-IEC 29500-1) is never used standalone — it is embedded
//! inside each host format's own vocabulary: `xl/drawings/drawingN.xml` (`xdr:` namespace) for
//! SpreadsheetML, `<w:drawing>` (`wp:`/`wps:` namespaces) for WordprocessingML, and a slide's own
//! `<p:spTree>` for PresentationML (PowerPoint depends on it the most heavily of the three, since a
//! slide's shapes essentially *are* its content). This crate factors that shared DrawingML surface
//! out into one place — shapes, fills, colors, lines, effects, geometry, text, `chart` — reused by
//! every host format instead of being duplicated three times over.
//!
//! Consequently, this crate models only a shape's *content* — `CT_ShapeProperties`, the type behind
//! `<a:spPr>` wherever it appears (`ShapeProperties`: position/size via [`Transform2D`], outline
//! via [`Geometry`], interior paint via [`Fill`]/[`Color`], stroke via [`Line`]). It never models a
//! shape's *anchor/container* — how it is placed within its host document (`xdr:twoCellAnchor` for
//! Excel, `wp:inline`/`wp:anchor` for Word, direct placement in `p:spTree` for PowerPoint) is
//! structurally different per format and stays the responsibility of each host crate, not this one.
//!
//! # Content model
//!
//! Geometry covers preset shapes ([`PresetShape`]) and custom, path-based geometry
//! ([`Geometry::Custom`]/[`CustomGeometry`]/[`PathCommand`]), plus preset-geometry adjustment values
//! ([`GeometryAdjustment`] on [`ShapeProperties::geometry_adjustments`], a sibling field rather than
//! a change to [`Geometry::Preset`] itself). Colors cover literal RGB/HSL/system/preset values
//! ([`Color`]; scheme-relative colors are not modeled). Fills cover solid/gradient/pattern/image
//! ([`Fill`], [`BlipFill`]/[`Fill::Image`], including cropping via [`CropRect`] on
//! [`BlipFill::crop`]). Lines cover stroke properties ([`Line`]), including compound line style
//! ([`LineCompound`] on [`Line::compound`]); [`write_line_named`]/[`read_line`] exist alongside
//! [`write_line`] for hosts that reuse `CT_LineProperties` under a name other than `<a:ln>` (for
//! example PresentationML table cell borders).
//!
//! Text-in-shape ([`TextBody`]) is a **sibling** of [`ShapeProperties`], not a field on it — per
//! `dml-spreadsheetDrawing.xsd`'s `CT_Shape`, where `txBody` sits alongside `spPr` inside the host's
//! own `<*:sp>` wrapper. [`TextParagraphProperties`] carries paragraph spacing ([`TextSpacing`] on
//! `line_spacing`/`space_before`/`space_after`), an indent/outline `level`, tab stops
//! ([`TabStop`]/[`TabAlignment`]), bullets/numbering
//! ([`BulletKind`]/[`BulletColor`]/[`BulletSize`]/[`BulletFont`]), and default run formatting
//! (`default_run_properties`, reusing [`TextRunProperties`] verbatim). A text run
//! ([`TextRunProperties`]) supports clickable hyperlinks ([`Hyperlink`] — see its own doc comment
//! for why it carries an already-resolved relationship id rather than a raw URL), casing and
//! character spacing ([`TextCaps`] on `text_caps`, `character_spacing_100ths_point`),
//! superscript/subscript and highlight color (`baseline_1000ths_percent`/`highlight`), and dynamic
//! text fields ([`TextRun::Field`]). [`TextBodyProperties`] supports autofit ([`TextAutofit`]),
//! horizontal centering (`anchorCtr`/`anchor_center`), and vertical direction/rotation
//! ([`TextVerticalType`]/`vertical_direction`/`rotation_60000ths`).
//!
//! Shape visual effects ([`EffectList`]/[`OuterShadow`]/[`Glow`]/[`Reflection`]/[`SoftEdge`] on
//! [`ShapeProperties::effects`]) round out the shape-content surface. [`read_color`] exists
//! alongside [`read_fill`] for a host embedding a bare color choice outside this crate's own
//! fill/line vocabulary.

mod error;
mod model;
mod reader;
mod writer;

pub use error::{Error, Result};
pub use model::{
    BlipFill, BlipFillMode, BulletColor, BulletFont, BulletKind, BulletSize, Color, CropRect,
    CustomGeometry, EffectList, Fill, Geometry, GeometryAdjustment, Glow, GradientFill,
    GradientStop, Hyperlink, Line, LineCap, LineCompound, LineEnd, LineEndSize, LineEndType,
    LineJoin, OuterShadow, PathCommand, PatternFill, PresetLineDash, PresetPattern, PresetShape,
    Reflection, ShapeProperties, SoftEdge, TabAlignment, TabStop, TextAlign, TextAnchor,
    TextAutofit, TextBody, TextBodyProperties, TextCaps, TextParagraph, TextParagraphProperties,
    TextRun, TextRunProperties, TextSpacing, TextStrike, TextUnderline, TextVerticalType, TextWrap,
    Transform2D,
};
pub use reader::{
    is_fill_choice_element, read_color, read_fill, read_fill_choice, read_line,
    read_shape_properties, read_text_body,
};
pub use writer::{
    write_blip_fill, write_color, write_effect_list, write_fill, write_geometry,
    write_geometry_fill_line_effects, write_line, write_line_named, write_shape_properties,
    write_text_body, write_text_body_properties, write_text_paragraph,
    write_text_paragraph_properties, write_text_run, write_transform,
};

// Re-exported so a future host crate (or this crate's own tests) can drive the reader without
// depending on `xml-core` directly for the `Reader` type itself — the same "don't make callers
// reach past us" posture `word-ooxml`/`excel-ooxml` apply to `opc`/`xml-core`.
pub use xml_core::Reader;