Struct HwpxStyleStore 

pub struct HwpxStyleStore { /* private fields */ }

HWPX-specific style storage populated from header.xml.

Unlike Blueprint’s StyleRegistry, this has no inheritance or template merging — it holds exactly what was parsed from the file.

Index Safety

All accessors return HwpxResult<&T> to guard against invalid indices from malformed HWPX files.

Examples

use hwpforge_smithy_hwpx::HwpxStyleStore;
use hwpforge_foundation::CharShapeIndex;

let store = HwpxStyleStore::new();
assert!(store.char_shape(CharShapeIndex::new(0)).is_err());

Implementations

impl HwpxStyleStore

pub fn new() -> Self

Creates an empty store.

pub fn with_default_fonts(font_name: &str) -> Self

Creates a new style store with the given font registered for all 7 language groups (HANGUL, LATIN, HANJA, JAPANESE, OTHER, SYMBOL, USER).

This eliminates the common boilerplate of manually pushing fonts for each language.

Examples

use hwpforge_smithy_hwpx::style_store::HwpxStyleStore;

let store = HwpxStyleStore::with_default_fonts("함초롬돋움");
assert_eq!(store.font_count(), 7);

pub fn style_set(&self) -> HancomStyleSet

Returns the style set used by this store.

pub fn from_registry(registry: &StyleRegistry) -> Self

Creates a store from a Blueprint StyleRegistry using the default style set (HancomStyleSet::Modern).

This is the bridge that lets the MD → Core → HWPX pipeline carry resolved styles all the way through to the HWPX encoder.

To target a specific 한글 version, use from_registry_with.

pub fn from_registry_with( registry: &StyleRegistry, style_set: HancomStyleSet, ) -> Self

Creates a store from a Blueprint StyleRegistry with a specific style set.

The style_set controls which default styles are injected:

• Classic — 18 styles (한글 2014–2020)
• Modern — 22 styles (한글 2022+)
• Latest — 23 styles (한글 2025+)

Mapping:

• registry.fonts → HwpxFont (assigned to HANGUL group)
• registry.char_shapes → HwpxCharShape (font ref mirrors same index for all lang groups)
• registry.para_shapes → HwpxParaShape
• registry.style_entries → HwpxStyle (PARA type, Korean langID)

pub fn push_font(&mut self, font: HwpxFont) -> FontIndex

Adds a font and returns its index.

pub fn font(&self, index: FontIndex) -> HwpxResult<&HwpxFont>

Returns the font at index.

pub fn font_count(&self) -> usize

Returns the number of fonts.

pub fn push_char_shape(&mut self, shape: HwpxCharShape) -> CharShapeIndex

Adds a char shape and returns its index.

pub fn char_shape(&self, index: CharShapeIndex) -> HwpxResult<&HwpxCharShape>

Returns the char shape at index.

pub fn char_shape_count(&self) -> usize

Returns the number of char shapes.

pub fn push_para_shape(&mut self, shape: HwpxParaShape) -> ParaShapeIndex

Adds a para shape and returns its index.

pub fn para_shape(&self, index: ParaShapeIndex) -> HwpxResult<&HwpxParaShape>

Returns the para shape at index.

pub fn para_shape_count(&self) -> usize

Returns the number of para shapes.

pub fn iter_fonts(&self) -> impl Iterator<Item = &HwpxFont>

Returns an iterator over all fonts in the store.

pub fn iter_char_shapes(&self) -> impl Iterator<Item = &HwpxCharShape>

Returns an iterator over all character shapes in the store.

pub fn iter_para_shapes(&self) -> impl Iterator<Item = &HwpxParaShape>

Returns an iterator over all paragraph shapes in the store.

pub fn push_style(&mut self, style: HwpxStyle)

Adds a style definition.

pub fn style(&self, index: usize) -> HwpxResult<&HwpxStyle>

Returns the style at index.

pub fn style_count(&self) -> usize

Returns the number of styles.

pub fn iter_styles(&self) -> impl Iterator<Item = &HwpxStyle>

Returns an iterator over all styles in the store.

pub fn push_border_fill(&mut self, bf: HwpxBorderFill) -> u32

Adds a border fill to the store and returns its 1-based ID.

Border fill IDs in HWPX are 1-based (unlike other indices which are 0-based).

pub fn border_fill(&self, id: u32) -> HwpxResult<&HwpxBorderFill>

Returns the border fill with the given 1-based ID.

Errors

Returns HwpxError::IndexOutOfBounds if no border fill with that ID exists.

pub fn border_fill_count(&self) -> usize

Returns the number of border fills in the store.

pub fn iter_border_fills(&self) -> impl Iterator<Item = &HwpxBorderFill>

Returns an iterator over all border fills in the store.

pub fn push_numbering(&mut self, ndef: NumberingDef)

Adds a numbering definition to the store.

pub fn push_tab(&mut self, tab: TabDef)

Adds a tab property definition to the store.

pub fn numbering_count(&self) -> u32

Returns the number of numbering definitions in the store.

pub fn tab_count(&self) -> u32

Returns the number of tab property definitions in the store.

pub fn iter_numberings(&self) -> impl Iterator<Item = &NumberingDef>

Returns an iterator over all numbering definitions in the store.

pub fn iter_tabs(&self) -> impl Iterator<Item = &TabDef>

Returns an iterator over all tab property definitions in the store.

Trait Implementations

impl Clone for HwpxStyleStore

fn clone(&self) -> HwpxStyleStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HwpxStyleStore

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

Formats the value using the given formatter.

impl Default for HwpxStyleStore

fn default() -> HwpxStyleStore

Returns the “default value” for a type.