Struct FlatPlacement 

pub struct FlatPlacement {
    pub fqn: String,
    pub page: usize,
    pub col: Option<usize>,
    pub descent: Option<(u32, u32)>,
    pub check: bool,
}

One authorized SP2 write. col indexes a hand-pinned column-x cluster (None = geometry-exempt, e.g. a wide free-text identity field); descent = (group, ordinal) for per-group strictly- descending-y ordering (None = not in any ordered sequence); check marks a checkbox (only in the no-unmapped scan + any same-y-pair predicate).

Fields

fqn: String

Fully-qualified field name that was written.

page: usize

0-based page the write must land on.

col: Option<usize>

Logical column index into the per-form hand-pinned x-cluster table (None = not column-checked).

descent: Option<(u32, u32)>

(descent_group, ordinal) — within a group, center-y must strictly decrease as ordinal rises.

check: bool

true iff this is a checkbox (geometry-exempt; still in the no-unmapped set).

Implementations

impl FlatPlacement

pub fn cell( fqn: impl Into<String>, page: usize, col: usize, grp: u32, ord: u32, ) -> Self

A column-checked, descent-participating money/text cell.

pub fn col_only(fqn: impl Into<String>, page: usize, col: usize) -> Self

A column-checked cell that does NOT participate in any descent sequence.

pub fn free(fqn: impl Into<String>, page: usize) -> Self

A geometry-exempt write (wide free-text identity field): page-checked + no-unmapped only.

pub fn free_ordered( fqn: impl Into<String>, page: usize, grp: u32, ord: u32, ) -> Self

A geometry-exempt write that ALSO participates in a per-group strictly-descending-y ordinal sequence — for a free-text field SEQUENCE with no column geometry to check but a real physical top-to-bottom order the fill assumes (e.g. Form 8275’s Part IV continuation lines, written in part_iv_continuation array order): a map that reordered the array, or a bundled asset whose lines were not actually laid out top-to-bottom in that order, fails closed here instead of silently landing text out of sequence.

pub fn check(fqn: impl Into<String>, page: usize) -> Self

A checkbox: no-unmapped only (+ any same-y-pair predicate the caller runs).

Trait Implementations

impl Clone for FlatPlacement

fn clone(&self) -> FlatPlacement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FlatPlacement

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

Formats the value using the given formatter.