Struct Form8959Map 

pub struct Form8959Map {

    pub form: String,
    pub year: i32,
    pub identity: IdentityCells,
    pub line1: MoneyCell,
    pub line4: MoneyCell,
    pub line5: MoneyCell,
    pub line6: MoneyCell,
    pub line7: MoneyCell,
    pub line8: MoneyCell,
    pub line9: MoneyCell,
    pub line10: MoneyCell,
    pub line11: MoneyCell,
    pub line12: MoneyCell,
    pub line13: MoneyCell,
    pub line18: MoneyCell,
    pub line19: MoneyCell,
    pub line20: MoneyCell,
    pub line21: MoneyCell,
    pub line22: MoneyCell,
    pub line24: MoneyCell,
}

The Form 8959 (Additional Medicare Tax) field map for one tax year.

Only the lines we FILL are mapped. Lines 2/3 (Form 4137 / Form 8919) and all of Part III plus line 23 (RRTA) are unmodeled and are deliberately absent — they stay blank on the filed form, which is why line 4 = line 1, line 18 = 7 + 13, and line 24 = line 22.

Fields

form: String

"f8959".

year: i32

Tax year.

identity: IdentityCells

The name + SSN header cells (P6.2). REQUIRED: a full-return schedule that does not name its taxpayer is not a filable form, so a map lacking [identity] fails at deserialization.

line1: MoneyCell

L1 — Σ W-2 box 5 Medicare wages, MID column.

line4: MoneyCell

L4 — add lines 1–3 (2/3 blank ⇒ = line 1), MID column.

line5: MoneyCell

L5 — filing-status threshold, MID column.

line6: MoneyCell

L6 — line 4 − line 5, floored at 0, AMOUNT column.

line7: MoneyCell

L7 — 0.9% × line 6, AMOUNT column.

line8: MoneyCell

L8 — Schedule SE Part I line 6 (net SE earnings), MID column.

line9: MoneyCell

L9 — filing-status threshold (again), MID column.

line10: MoneyCell

L10 — the amount from line 4, MID column.

line11: MoneyCell

L11 — line 9 − line 10, floored at 0, MID column.

line12: MoneyCell

L12 — line 8 − line 11, floored at 0, AMOUNT column.

line13: MoneyCell

L13 — 0.9% × line 12, AMOUNT column.

line18: MoneyCell

L18 — add 7, 13, 17 → Schedule 2 line 11, AMOUNT column.

line19: MoneyCell

L19 — Σ W-2 box 6 Medicare tax withheld, MID column.

line20: MoneyCell

L20 — the amount from line 1, MID column.

line21: MoneyCell

L21 — 1.45% × line 20, MID column.

line22: MoneyCell

L22 — line 19 − line 21, floored at 0, AMOUNT column.

line24: MoneyCell

L24 — add 22 and 23 → 1040 line 25c, AMOUNT column.

Implementations

impl Form8959Map

pub fn parse(toml_src: &str) -> Result<Self, Error>

Parse the committed TOML.

pub fn ty2024() -> Self

The TY2024 map.

pub fn for_year(year: i32) -> Result<Self, FormsError>

The map for a supported tax year. Full-return v1 is TY2024-only: Form 8959 is reachable only from the absolute return, which itself has tables for 2024 alone.

pub fn lines(&self) -> [&MoneyCell; 17]

The 17 filled cells, in printed reading order (strictly descending y on page 1) — the order fill_form_8959 walks and the ordinal the geometric verifier checks the descent of.

Trait Implementations

impl Clone for Form8959Map

fn clone(&self) -> Form8959Map

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Form8959Map

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Form8959Map

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.