quilldown 1.5.0

Convert GitHub-Flavored Markdown into high-fidelity Word .docx documents.
Documentation
// <auto-generated by typra-emitter>
// Code generated by Typra emitter; DO NOT EDIT.

#![allow(
    unused_imports,
    dead_code,
    non_camel_case_types,
    unused_variables,
    unexpected_cfgs,
    clippy::all
)]

use super::context::{LoadContext, SaveContext};

/// Variant-specific data for [`SlideElement`], discriminated by `kind`.
#[derive(Debug, Clone, PartialEq)]
pub enum SlideElementKind {
    /// `kind` = `"text_box"`
    TextBoxElement {
        text: String,
        bullets: Option<Vec<String>>,
        hyperlink: Option<String>,
    },
    /// `kind` = `"image"`
    SlideImageElement {
        src: String,
        alt: String,
        title: Option<String>,
    },
    /// Lossless fallback for unrecognized `kind` values.
    Unknown {
        /// The raw `kind` string for this unknown variant.
        kind_name: String,
        /// Unmodeled fields preserved for forward-compatible round trips.
        raw: serde_json::Map<String, serde_json::Value>,
    },
}

impl Default for SlideElementKind {
    fn default() -> Self {
        SlideElementKind::Unknown {
            kind_name: String::new(),
            raw: serde_json::Map::new(),
        }
    }
}
#[derive(Debug, Clone, Default, PartialEq)]
pub struct SlideElement {
    /// Variant-specific data, discriminated by `kind`.
    pub kind: SlideElementKind,
}

impl SlideElement {
    /// Create a new SlideElement with default values.
    pub fn new() -> Self {
        Self::default()
    }

    /// Load SlideElement from a JSON string.
    pub fn from_json(json: &str, ctx: &LoadContext) -> Result<Self, serde_json::Error> {
        let value: serde_json::Value = serde_json::from_str(json)?;
        Self::validate_input_at(&value, "")
            .map_err(|message| <serde_json::Error as serde::de::Error>::custom(message))?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load SlideElement from a YAML string.
    pub fn from_yaml(yaml: &str, ctx: &LoadContext) -> Result<Self, serde_yaml::Error> {
        let value: serde_json::Value = serde_yaml::from_str(yaml)?;
        Self::validate_input_at(&value, "")
            .map_err(|message| <serde_yaml::Error as serde::de::Error>::custom(message))?;
        Ok(Self::load_from_value(&value, ctx))
    }

    /// Load SlideElement from an already-parsed JSON value, returning an error
    /// instead of panicking on invalid input. Fallible companion to
    /// `load_from_value` with the same validation policy as `from_json`.
    pub fn try_load_from_value(
        value: &serde_json::Value,
        ctx: &LoadContext,
    ) -> Result<Self, serde_json::Error> {
        Self::validate_input_at(value, "")
            .map_err(|message| <serde_json::Error as serde::de::Error>::custom(message))?;
        Ok(Self::load_from_value(value, ctx))
    }

    /// Load SlideElement from a `serde_json::Value`.
    ///
    /// Calls `ctx.process_input` before field extraction.
    pub fn load_from_value(value: &serde_json::Value, ctx: &LoadContext) -> Self {
        let value = ctx.process_input(value.clone());
        if let Err(message) = Self::validate_input_at(&value, "") {
            panic!("{}", message);
        }
        let kind_str = value.get("kind").and_then(|v| v.as_str()).unwrap_or("");
        let kind = match kind_str {
            "text_box" => SlideElementKind::TextBoxElement {
                text: value
                    .get("text")
                    .and_then(|v| v.as_str())
                    .unwrap_or_default()
                    .to_string(),
                bullets: value.get("bullets").and_then(|v| v.as_array()).map(|arr| {
                    arr.iter()
                        .filter_map(|v| v.as_str().map(|s| s.to_string()))
                        .collect()
                }),
                hyperlink: value
                    .get("hyperlink")
                    .and_then(|v| v.as_str())
                    .map(|s| s.to_string()),
            },
            "image" => SlideElementKind::SlideImageElement {
                src: value
                    .get("src")
                    .and_then(|v| v.as_str())
                    .unwrap_or_default()
                    .to_string(),
                alt: value
                    .get("alt")
                    .and_then(|v| v.as_str())
                    .unwrap_or_default()
                    .to_string(),
                title: value
                    .get("title")
                    .and_then(|v| v.as_str())
                    .map(|s| s.to_string()),
            },
            _ => SlideElementKind::Unknown {
                kind_name: kind_str.to_string(),
                raw: {
                    let mut raw = value.as_object().cloned().unwrap_or_default();
                    raw.remove("kind");
                    raw
                },
            },
        };
        Self { kind: kind }
    }

    pub(crate) fn validate_input_at(value: &serde_json::Value, path: &str) -> Result<(), String> {
        let discriminator = value
            .get("kind")
            .ok_or_else(|| "Missing SlideElement discriminator property: 'kind'".to_string())?;
        let discriminator =
            match discriminator {
                serde_json::Value::String(value) if !value.is_empty() => value.as_str(),
                _ => return Err(
                    "Invalid SlideElement discriminator field 'kind': expected non-blank string"
                        .to_string(),
                ),
            };
        match discriminator {
            "text_box" => {}
            "image" => {}
            _ => {}
        }
        Ok(())
    }

    /// Returns the `kind` discriminator string for this instance.
    pub fn kind_str(&self) -> &str {
        match &self.kind {
            SlideElementKind::TextBoxElement { .. } => "text_box",
            SlideElementKind::SlideImageElement { .. } => "image",
            SlideElementKind::Unknown { kind_name, .. } => kind_name.as_str(),
        }
    }

    /// Serialize SlideElement to a `serde_json::Value`.
    ///
    /// Calls `ctx.process_dict` after serialization.
    pub fn to_value(&self, ctx: &SaveContext) -> serde_json::Value {
        let mut result = serde_json::Map::new();
        // Write the discriminator
        result.insert(
            "kind".to_string(),
            serde_json::Value::String(self.kind_str().to_string()),
        );
        // Write base fields
        // Write variant-specific fields
        match &self.kind {
            SlideElementKind::TextBoxElement {
                text,
                bullets,
                hyperlink,
                ..
            } => {
                result.insert("text".to_string(), serde_json::Value::String(text.clone()));
                if let Some(items) = bullets.as_ref() {
                    result.insert(
                        "bullets".to_string(),
                        serde_json::to_value(items).unwrap_or(serde_json::Value::Null),
                    );
                }
                if let Some(val) = hyperlink {
                    result.insert(
                        "hyperlink".to_string(),
                        serde_json::Value::String(val.clone()),
                    );
                }
            }
            SlideElementKind::SlideImageElement {
                src, alt, title, ..
            } => {
                result.insert("src".to_string(), serde_json::Value::String(src.clone()));
                result.insert("alt".to_string(), serde_json::Value::String(alt.clone()));
                if let Some(val) = title {
                    result.insert("title".to_string(), serde_json::Value::String(val.clone()));
                }
            }
            SlideElementKind::Unknown { raw, .. } => {
                for (key, value) in raw {
                    if matches!(key.as_str(), "kind") {
                        continue;
                    }
                    result.insert(key.clone(), value.clone());
                }
            }
        }
        ctx.process_dict(serde_json::Value::Object(result))
    }

    /// Serialize SlideElement to a JSON string.
    pub fn to_json(&self, ctx: &SaveContext) -> Result<String, serde_json::Error> {
        serde_json::to_string_pretty(&self.to_value(ctx))
    }

    /// Serialize SlideElement to a YAML string.
    pub fn to_yaml(&self, ctx: &SaveContext) -> Result<String, serde_yaml::Error> {
        serde_yaml::to_string(&self.to_value(ctx))
    }
}

// Serde for `SlideElement` delegates to the canonical to_value/load_from_value
// logic so the `kind` discriminator round-trips to its exact wire value. Uses a default (no-op) context — no ${env:}/${file:}
// resolution here — leaving the context-aware LoadContext/SaveContext API intact.
#[cfg(feature = "serde")]
impl serde::Serialize for SlideElement {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        serde::Serialize::serialize(&self.to_value(&SaveContext::default()), serializer)
    }
}

#[cfg(feature = "serde")]
impl<'de> serde::Deserialize<'de> for SlideElement {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <serde_json::Value as serde::Deserialize>::deserialize(deserializer)?;
        Self::validate_input_at(&value, "").map_err(serde::de::Error::custom)?;
        Ok(Self::load_from_value(&value, &LoadContext::default()))
    }
}

// Serde for `SlideElementKind` wraps the variant into its parent `SlideElement` and delegates
// to the canonical to_value/load_from_value logic, so a bare `SlideElementKind`
// serializes to internally-tagged `{"kind": "<value>", ...}` — the same wire
// form as its parent — instead of serde's externally-tagged `{"<Variant>": {...}}`.
#[cfg(feature = "serde")]
impl serde::Serialize for SlideElementKind {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let parent = SlideElement {
            kind: self.clone(),
            ..Default::default()
        };
        serde::Serialize::serialize(&parent.to_value(&SaveContext::default()), serializer)
    }
}

#[cfg(feature = "serde")]
impl<'de> serde::Deserialize<'de> for SlideElementKind {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <serde_json::Value as serde::Deserialize>::deserialize(deserializer)?;
        SlideElement::validate_input_at(&value, "").map_err(serde::de::Error::custom)?;
        Ok(SlideElement::load_from_value(&value, &LoadContext::default()).kind)
    }
}