Struct StyleProfile 

#[non_exhaustive]
pub struct StyleProfile {
    pub name: String,
    pub verbosity: Verbosity,
    pub sentence_length: LengthDistribution,
    pub connectives: ConnectivePreferences,
    pub list_style_bias: ListStyleBias,
    pub pronoun_density: PronounDensity,
    pub hedging: HedgingCalibration,
    pub salience: SalienceBias,
}

A declarative voice configuration for the engine.

Profiles are immutable per engine. Build one through StyleProfile::builder, a serde-deserialized prosaic.toml [style_profile] section, or one of the catalog presets. Apply via Engine::style_profile.

StyleProfile::neutral() is the byte-for-byte-equivalent baseline: constructing an engine with .style_profile(StyleProfile::neutral()) produces output identical to constructing it with no profile at all. This invariant is the backwards-compatibility gate for the entire design and is asserted by the round-trip tests at the workspace level.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

verbosity: Verbosity

sentence_length: LengthDistribution

connectives: ConnectivePreferences

list_style_bias: ListStyleBias

pronoun_density: PronounDensity

hedging: HedgingCalibration

salience: SalienceBias

Implementations

impl StyleProfile

pub fn neutral() -> Self

The byte-for-byte-equivalent baseline. Every dial in its neutral position; constructing an engine with this profile produces the same output as constructing it with no profile at all.

pub fn builder(name: impl Into<String>) -> StyleProfileBuilder

Start a builder rooted at neutral() with the given name.

pub fn is_neutral(&self) -> bool

true when this profile is byte-for-byte equivalent to the neutral baseline — i.e., when every decision site can short-circuit its profile-aware path. The name field is ignored: a custom name applied to neutral dials is still an effective no-op.

pub fn validate(&self) -> Result<(), StyleProfileError>

Validate the profile against the documented invariants. Called by the builder’s build() and at the engine boundary; consumers passing a deserialized profile should call this before applying it to an engine.

Trait Implementations

impl Clone for StyleProfile

fn clone(&self) -> StyleProfile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StyleProfile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StyleProfile

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for StyleProfile

fn eq(&self, other: &StyleProfile) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for StyleProfile