xfa-layout-engine 1.0.0-beta.5

Box-model and pagination layout engine for XFA forms. Experimental — part of the PDFluent XFA stack, under active development.
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
//! Form node types — the input to the layout engine.
//!
//! These represent the merged Form DOM nodes that the layout engine processes.
//! In a full implementation, these would come from xfa-dom-resolver's merge step.

use std::collections::HashMap;

use crate::text::FontMetrics;
use crate::types::{BoxModel, LayoutStrategy, TextAlign, VerticalAlign};

/// A unique identifier for a form node.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct FormNodeId(pub usize);

/// The form tree: a node-based representation of the merged template+data.
#[derive(Debug)]
pub struct FormTree {
    /// Nodes in the form tree.
    pub nodes: Vec<FormNode>,
    /// Per-node metadata (parallel to `nodes`).
    pub metadata: Vec<FormNodeMeta>,
    /// Lookup table: XFA `id` attribute -> `FormNodeId`.
    pub node_ids: HashMap<String, FormNodeId>,
    /// XFA 3.3 §5.5 `<variables>` `<script name="X">…</script>` blocks
    /// gathered at merge time. Each entry is `(subform_scope, name, body)`.
    /// `subform_scope` is `None` for root-level scripts (globally accessible)
    /// and `Some(subform_name)` for scripts scoped to a named subform
    /// (accessible as `subform.variables.scriptName`). Empty in default mode.
    pub variables_scripts: Vec<(Option<String>, String, String)>,
    /// True when the merger bound at least one field value from the DataDom.
    /// False for forms whose datasets contain only server-infrastructure metadata
    /// with no template-field bindings.  Used by the flatten pipeline to gate
    /// data-empty page suppression: pages must not be suppressed when no data
    /// binding has occurred (all field values come from template defaults).
    pub any_data_bound: bool,
}

impl FormTree {
    /// Create a new form tree.
    pub fn new() -> Self {
        Self {
            nodes: Vec::new(),
            metadata: Vec::new(),
            node_ids: HashMap::new(),
            variables_scripts: Vec::new(),
            any_data_bound: false,
        }
    }

    /// Add a node to the form tree.
    pub fn add_node(&mut self, node: FormNode) -> FormNodeId {
        let id = FormNodeId(self.nodes.len());
        self.nodes.push(node);
        self.metadata.push(FormNodeMeta::default());
        id
    }

    /// Add a node together with its metadata. If the meta has an `xfa_id`,
    /// it is registered in the `node_ids` lookup table.
    pub fn add_node_with_meta(&mut self, node: FormNode, meta: FormNodeMeta) -> FormNodeId {
        let id = FormNodeId(self.nodes.len());
        if let Some(ref xfa_id) = meta.xfa_id {
            self.node_ids.insert(xfa_id.clone(), id);
        }
        self.nodes.push(node);
        self.metadata.push(meta);
        id
    }

    /// Get a node by ID.
    pub fn get(&self, id: FormNodeId) -> &FormNode {
        &self.nodes[id.0]
    }

    /// Get a mutable reference to a node by ID.
    pub fn get_mut(&mut self, id: FormNodeId) -> &mut FormNode {
        &mut self.nodes[id.0]
    }

    /// Access the metadata for a node.
    pub fn meta(&self, id: FormNodeId) -> &FormNodeMeta {
        &self.metadata[id.0]
    }

    /// Mutably access the metadata for a node.
    pub fn meta_mut(&mut self, id: FormNodeId) -> &mut FormNodeMeta {
        &mut self.metadata[id.0]
    }

    /// Look up a node by its XFA `id` attribute.
    pub fn find_by_xfa_id(&self, id: &str) -> Option<FormNodeId> {
        self.node_ids.get(id).copied()
    }
}

impl Default for FormTree {
    fn default() -> Self {
        Self::new()
    }
}

/// A single node in the Form DOM.
#[derive(Debug, Clone)]
pub struct FormNode {
    /// Node name.
    pub name: String,
    /// Node type.
    pub node_type: FormNodeType,
    /// Box model.
    pub box_model: BoxModel,
    /// Layout strategy.
    pub layout: LayoutStrategy,
    /// Child node IDs.
    pub children: Vec<FormNodeId>,
    /// Occurrence rules for repeating subforms.
    pub occur: Occur,
    /// Font metrics for text measurement (Draw/Field nodes).
    pub font: FontMetrics,
    /// FormCalc calculate script (XFA S14.3.2): runs to compute the field's value.
    pub calculate: Option<String>,
    /// FormCalc validate script: runs to validate the field's value, returns bool.
    pub validate: Option<String>,
    /// Column widths for table-layout subforms (XFA columnWidths attribute).
    /// Positive values are fixed widths in points; -1.0 means auto-size.
    /// Empty for non-table nodes.
    pub column_widths: Vec<f64>,
    /// Column span for cells inside a table row (XFA colSpan attribute).
    /// 1 = single column (default), N = span N columns, -1 = span remaining.
    pub col_span: i32,
}

/// The scripting language used by an XFA `<script>` element.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum ScriptLanguage {
    /// FormCalc is the XFA default when `contentType` is omitted.
    #[default]
    FormCalc,
    /// JavaScript event handlers and calculations.
    JavaScript,
    /// Any other declared script language (for example VBScript).
    Other,
}

/// Script metadata collected from `<event>` / `<calculate>` elements.
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct EventScript {
    /// Script source.
    pub script: String,
    /// Script language.
    pub language: ScriptLanguage,
    /// Activity event.
    pub activity: Option<String>,
    /// Event reference.
    pub event_ref: Option<String>,
    /// Run-at location.
    pub run_at: Option<String>,
}

impl EventScript {
    /// Create a new event script.
    pub fn new(
        script: String,
        language: ScriptLanguage,
        activity: Option<String>,
        event_ref: Option<String>,
        run_at: Option<String>,
    ) -> Self {
        Self {
            script,
            language,
            activity,
            event_ref,
            run_at,
        }
    }

    /// Create a FormCalc event script.
    pub fn formcalc(script: impl Into<String>, activity: Option<&str>) -> Self {
        Self::new(
            script.into(),
            ScriptLanguage::FormCalc,
            activity.map(str::to_string),
            None,
            None,
        )
    }

    /// Create a JavaScript event script.
    pub fn javascript(script: impl Into<String>, activity: Option<&str>) -> Self {
        Self::new(
            script.into(),
            ScriptLanguage::JavaScript,
            activity.map(str::to_string),
            None,
            None,
        )
    }
}

/// Content for draw nodes (static graphic elements).
///
/// XFA Spec 3.3 §2.1 (p24) — Draw element: fixed content (boilerplate).
/// Includes text, lines, rectangles, arcs. Images are handled separately
/// via `FormNodeType::Image`.
///
/// TODO(§2.3): `circle` draw content not implemented (spec allows via arc with
///   startAngle=0, sweepAngle=360).
#[derive(Debug, Clone)]
pub enum DrawContent {
    /// Text draw content.
    Text(String),
    /// Line draw content.
    Line {
        /// Start x coordinate.
        x1: f64,
        /// Start y coordinate.
        y1: f64,
        /// End x coordinate.
        x2: f64,
        /// End y coordinate.
        y2: f64,
    },
    /// Rectangle draw content.
    Rectangle {
        /// X coordinate.
        x: f64,
        /// Y coordinate.
        y: f64,
        /// Width.
        w: f64,
        /// Height.
        h: f64,
        /// Corner radius.
        radius: f64,
    },
    /// Arc draw content.
    Arc {
        /// X coordinate.
        x: f64,
        /// Y coordinate.
        y: f64,
        /// Width.
        w: f64,
        /// Height.
        h: f64,
        /// Start angle.
        start_angle: f64,
        /// Sweep angle.
        sweep_angle: f64,
    },
}

/// The type of form node.
#[derive(Debug, Clone)]
pub enum FormNodeType {
    /// Root subform.
    Root,
    /// A page set containing page areas.
    PageSet,
    /// A page area (page template) with content areas.
    PageArea {
        /// Content areas.
        content_areas: Vec<ContentArea>,
    },
    /// A generic subform container.
    Subform,
    /// XFA `<area>` — a positioned container (XFA 3.3 Appendix B).
    ///
    /// Semantically identical to a `Subform` with positioned layout: children
    /// have absolute positions within the area.  The layout engine treats this
    /// exactly like `Subform` for layout purposes.
    Area,
    /// XFA `<exclGroup>` — an exclusive (radio-button) group (XFA 3.3 §7.2).
    ///
    /// Contains multiple radio-button `<field>` children where exactly one can
    /// be selected.  In layout this behaves like a `Subform` with top-to-bottom
    /// flow; each child field is rendered normally.
    ExclGroup,
    /// XFA `<subformSet>` — a transparent set of subforms (XFA 3.3 §7.1).
    ///
    /// Used for conditional instantiation.  In layout the set is transparent:
    /// its children are processed as if they were direct children of the
    /// containing subform (same data context).
    SubformSet,
    /// A form field (text field, checkbox, etc.).
    Field {
        /// Field value.
        value: String,
    },
    /// A static draw element (text, image, line, etc.).
    Draw(DrawContent),
    /// A static image draw element.
    Image {
        /// Image data.
        data: Vec<u8>,
        /// Image MIME type.
        mime_type: String,
    },
}

/// Occurrence rules for repeating subforms (XFA S3.3 occur element).
///
/// Controls how many instances of a subform are created. The layout engine
/// expands templates based on the `initial` count, bounded by `min` and `max`.
#[derive(Debug, Clone)]
pub struct Occur {
    /// Minimum number of occurrences (default 1).
    pub min: u32,
    /// Maximum number of occurrences (-1 = unlimited). Default 1.
    /// Using `Option<u32>` where `None` means unlimited.
    pub max: Option<u32>,
    /// Initial number of occurrences (default = min).
    pub initial: u32,
}

impl Default for Occur {
    fn default() -> Self {
        Self {
            min: 1,
            max: Some(1),
            initial: 1,
        }
    }
}

impl Occur {
    /// Occur rule that means "exactly once" (the default).
    pub fn once() -> Self {
        Self::default()
    }

    /// Occur rule for a repeating subform.
    pub fn repeating(min: u32, max: Option<u32>, initial: u32) -> Self {
        let initial = initial.max(min);
        let initial = match max {
            Some(m) => initial.min(m),
            None => initial,
        };
        Self { min, max, initial }
    }

    /// How many instances should be created.
    pub fn count(&self) -> u32 {
        self.initial
    }

    /// Whether the subform can repeat (max > 1 or unlimited).
    pub fn is_repeating(&self) -> bool {
        match self.max {
            Some(m) => m > 1,
            None => true,
        }
    }
}

/// A content area within a page area.
#[derive(Debug, Clone)]
pub struct ContentArea {
    /// Content area name.
    pub name: String,
    /// X coordinate.
    pub x: f64,
    /// Y coordinate.
    pub y: f64,
    /// Width.
    pub width: f64,
    /// Height.
    pub height: f64,
    /// Leader (header) node placed at the top of each page's content area.
    pub leader: Option<FormNodeId>,
    /// Trailer (footer) node placed at the bottom of each page's content area.
    pub trailer: Option<FormNodeId>,
}

impl Default for ContentArea {
    fn default() -> Self {
        Self {
            name: String::new(),
            x: 0.0,
            y: 0.0,
            width: 612.0,  // US Letter width in points
            height: 792.0, // US Letter height in points
            leader: None,
            trailer: None,
        }
    }
}

// ---------------------------------------------------------------------------
// Metadata, style, and kind types
// ---------------------------------------------------------------------------

/// XFA `presence` attribute values (XFA 3.3 §2.6 p67-68).
///
/// Controls visibility and layout space allocation:
/// - `Visible` -- all phases: binding, automation, layout, rendering, interaction.
/// - `Hidden` -- binding + automation only; no layout space, no rendering.
/// - `Invisible` -- binding + automation + layout; takes up space but not visible.
/// - `Inactive` -- binding only; completely absent from form.
///
/// Note: spec defines `hidden` as "effectively absent" (no space) and `invisible`
/// as "takes space but not visible". Our `is_layout_hidden` implementation reflects this.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum Presence {
    #[default]
    /// Visible.
    Visible,
    /// Hidden.
    Hidden,
    /// Invisible.
    Invisible,
    /// Inactive.
    Inactive,
}

impl Presence {
    /// True when the element should not be rendered.
    pub fn is_not_visible(self) -> bool {
        !matches!(self, Presence::Visible)
    }

    /// True when the element should not occupy layout space.
    ///
    /// XFA Spec 3.3 §2.6 (p68):
    /// - `hidden`:   no layout space, no rendering (effectively absent)
    /// - `invisible`: no layout space in Adobe (spec says "takes space",
    ///   but empirical testing shows Adobe skips it)
    /// - `inactive`:  completely absent (no binding, no space)
    ///
    /// `Hidden` was previously excluded from this predicate based on an
    /// incorrect assumption that Adobe reserves space for hidden elements.
    /// GATE #27 testing proved this wrong: hidden subforms with `<break>`
    /// elements caused 2-23x overpagination in forms with many
    /// `presence="hidden"` subforms (fixes #806).
    pub fn is_layout_hidden(self) -> bool {
        matches!(
            self,
            Presence::Hidden | Presence::Invisible | Presence::Inactive
        )
    }
}

/// Extended metadata for a form node.
///
/// Carries XFA attributes that the layout engine and dynamic scripting
/// system need but that are not part of the core `FormNode` shape.
#[derive(Debug, Clone, Default)]
pub struct FormNodeMeta {
    /// Optional XFA `id` attribute.
    pub xfa_id: Option<String>,
    /// XFA presence attribute (visible/hidden/invisible/inactive).
    pub presence: Presence,
    /// Whether a page break should be inserted before this node.
    pub page_break_before: bool,
    /// Whether a page break should be inserted after this node.
    pub page_break_after: bool,
    /// Target page area name/id for the break (e.g. "MP3", "Page4_ID").
    pub break_target: Option<String>,
    /// Whether this node targets a specific content area via
    /// `breakBefore targetType="contentArea"`.  Such nodes should be
    /// excluded from the primary content flow (they go into small
    /// decorative areas like "flatten" or "eSign").
    pub content_area_break: bool,
    /// Overflow leader reference name.
    pub overflow_leader: Option<String>,
    /// Overflow trailer reference name.
    pub overflow_trailer: Option<String>,
    /// Keep with next content area.
    pub keep_next_content_area: bool,
    /// Keep with previous content area.
    pub keep_previous_content_area: bool,
    /// Keep intact within content area.
    pub keep_intact_content_area: bool,
    /// Layout-ready script (XFA S14.3).
    pub layout_ready_script: Option<String>,
    /// Event scripts collected from `<event>` and `<calculate>` children.
    pub event_scripts: Vec<EventScript>,
    /// Explicit XFA data binding ref from `<bind ref="...">`.
    pub data_bind_ref: Option<String>,
    /// Whether the node explicitly opts out of data binding via `<bind match="none">`.
    pub data_bind_none: bool,
    /// Visual style (font, colors, borders).
    pub style: FormNodeStyle,
    /// The kind of field (text, checkbox, radio, etc.).
    pub field_kind: FieldKind,
    /// The kind of group (none or exclusive choice).
    pub group_kind: GroupKind,
    /// Item value for fields inside an exclGroup.
    pub item_value: Option<String>,
    /// Check box / radio button size in points.
    pub check_size: Option<f64>,
    /// Display items for choice list fields (XFA 3.3 §7.7).
    pub display_items: Vec<String>,
    /// Save items for choice list fields (XFA 3.3 §7.7).
    pub save_items: Vec<String>,
    /// Runtime-populated choice list items from sandboxed script `addItem` calls.
    /// Each tuple is `(display_value, save_value)`. Phase D-β only; layout does
    /// not yet read this in default mode.
    pub runtime_listbox_items: Vec<(String, String)>,
    /// XFA anchorType for positioned layout (XFA 3.3 §2.6, App A p1510).
    pub anchor_type: AnchorType,
    /// Raw `DataDom` arena index of the data node this form node was bound to
    /// during the merge phase. `None` means unbound. Phase D-γ: populated by
    /// `FormMerger` and consumed by the JS runtime to resolve `$record`.
    pub bound_data_node: Option<usize>,
    /// True when this node is a synthetic prototype for a repeating subform
    /// whose live instance count is currently zero. Used by the JS runtime
    /// to expose an InstanceManager via `parent._child` even when no data
    /// bindings produced live rows. Layout treats this as `presence = Hidden`.
    pub is_zero_instance_prototype: bool,
}

/// XFA `anchorType` attribute (XFA 3.3 §2.6, Appendix A p1510).
///
/// Determines which point of an element is placed at the (x,y) coordinate
/// in positioned layout.  Default is `TopLeft`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum AnchorType {
    #[default]
    /// Top-left anchor.
    TopLeft,
    /// Top-center anchor.
    TopCenter,
    /// Top-right anchor.
    TopRight,
    /// Middle-left anchor.
    MiddleLeft,
    /// Middle-center anchor.
    MiddleCenter,
    /// Middle-right anchor.
    MiddleRight,
    /// Bottom-left anchor.
    BottomLeft,
    /// Bottom-center anchor.
    BottomCenter,
    /// Bottom-right anchor.
    BottomRight,
}

/// The kind of group container.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum GroupKind {
    #[default]
    /// No group.
    None,
    /// Exclusive choice group.
    ExclusiveChoice,
}

/// The kind of form field.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum FieldKind {
    #[default]
    /// Text field.
    Text,
    /// Checkbox field.
    Checkbox,
    /// Radio button field.
    Radio,
    /// Button field.
    Button,
    /// Dropdown field.
    Dropdown,
    /// Signature field.
    Signature,
    /// Date/time picker field.
    DateTimePicker,
    /// Numeric edit field.
    NumericEdit,
    /// Password edit field.
    PasswordEdit,
    /// Image edit field.
    ImageEdit,
    /// Barcode field.
    Barcode,
}

/// A span of rich text with per-span style overrides.
///
/// XFA Spec 3.3 §4.2.7 (p155) — `<exData contentType="text/html">` stores
/// XHTML content with inline CSS. Each span carries its own formatting
/// (font, color, weight, etc.) that overrides the node-level defaults.
#[derive(Debug, Clone, PartialEq)]
pub struct RichTextSpan {
    /// Text content.
    pub text: String,
    /// Font size.
    pub font_size: Option<f64>,
    /// Font family.
    pub font_family: Option<String>,
    /// Font weight.
    pub font_weight: Option<String>,
    /// Font style.
    pub font_style: Option<String>,
    /// Text color.
    pub text_color: Option<(u8, u8, u8)>,
    /// Underline flag.
    pub underline: bool,
    /// Line-through flag.
    pub line_through: bool,
}

/// Visual style properties for a form node.
#[derive(Debug, Clone, PartialEq)]
pub struct FormNodeStyle {
    /// Font family.
    pub font_family: Option<String>,
    /// Font size.
    pub font_size: Option<f64>,
    /// Font weight.
    pub font_weight: Option<String>,
    /// Font style.
    pub font_style: Option<String>,
    /// Text color.
    pub text_color: Option<(u8, u8, u8)>,
    /// Background color.
    pub bg_color: Option<(u8, u8, u8)>,
    /// Border color.
    pub border_color: Option<(u8, u8, u8)>,
    /// Per-edge border colors (top, right, bottom, left) in RGB 0-255.
    /// When set, overrides `border_color` for individual edges.
    pub border_colors: Option<[(u8, u8, u8); 4]>,
    /// Border width in points.
    pub border_width_pt: Option<f64>,
    /// Per-edge border widths (top, right, bottom, left) in points.
    /// When set, overrides `border_width_pt` for individual edges.
    pub border_widths: Option<[f64; 4]>,
    /// Paragraph space above in points (XFA `<para spaceAbove>`).
    pub space_above_pt: Option<f64>,
    /// Paragraph space below in points (XFA `<para spaceBelow>`).
    pub space_below_pt: Option<f64>,
    /// Paragraph left margin in points (XFA `<para marginLeft>`).
    pub margin_left_pt: Option<f64>,
    /// Paragraph right margin in points (XFA `<para marginRight>`).
    pub margin_right_pt: Option<f64>,
    /// XFA Spec 3.3 §17 "para" (p803) — lineHeight: baseline-to-baseline
    /// distance in points. When `None`, use font metrics.
    pub line_height_pt: Option<f64>,
    /// XFA Spec 3.3 §17 "para" (p803) — textIndent: indentation of the first
    /// line of each paragraph in points.
    pub text_indent_pt: Option<f64>,
    /// Margin top inset in points (XFA `<margin topInset>`).
    pub inset_top_pt: Option<f64>,
    /// Margin bottom inset in points (XFA `<margin bottomInset>`).
    pub inset_bottom_pt: Option<f64>,
    /// Margin left inset in points (XFA `<margin leftInset>`).
    pub inset_left_pt: Option<f64>,
    /// Margin right inset in points (XFA `<margin rightInset>`).
    pub inset_right_pt: Option<f64>,
    /// Vertical text alignment (XFA `<para vAlign>`).
    pub v_align: Option<VerticalAlign>,
    /// Horizontal alignment for layout positioning (XFA `<para hAlign>`, §8.3).
    pub h_align: Option<TextAlign>,
    /// Border corner radius in points (XFA `<border><corner radius>`).
    pub border_radius_pt: Option<f64>,
    /// Border edge stroke style (XFA `<border><edge stroke>`).
    pub border_style: Option<String>,
    /// Per-edge visibility: [top, right, bottom, left]. All true when absent.
    pub border_edges: [bool; 4],
    /// XFA Spec 3.3 §17 (p716) — genericFamily fallback hint.
    /// Values: serif, sansSerif, monospaced, decorative, fantasy, cursive.
    pub generic_family: Option<String>,
    /// Font horizontal scale factor (XFA `<font fontHorizontalScale>`).
    /// 1.0 = 100% (default), 0.96 = 96%, etc.
    pub font_horizontal_scale: Option<f64>,
    /// Letter spacing in points (XFA `<font letterSpacing>`).
    /// 0.0 = normal (default). Negative values tighten, positive widen.
    pub letter_spacing_pt: Option<f64>,
    /// Caption text (XFA `<caption><value><text>`).
    pub caption_text: Option<String>,
    /// Caption placement (left/right/top/bottom/inline).
    pub caption_placement: Option<String>,
    /// Caption reserve width/height in points.
    pub caption_reserve: Option<f64>,
    /// CheckButton mark style (XFA `<checkButton mark="...">`).
    /// Values: "check", "circle", "cross", "diamond", "square", "star".
    pub check_button_mark: Option<String>,
    /// CheckButton on-value (first `<items>` entry, XFA 3.3 §17.8).
    pub check_button_on_value: Option<String>,
    /// CheckButton off-value (second `<items>` entry). When omitted, the
    /// spec default is the null string.
    pub check_button_off_value: Option<String>,
    /// CheckButton neutral-value (third `<items>` entry, checkbox only).
    pub check_button_neutral_value: Option<String>,
    /// Rich text spans parsed from `<exData contentType="text/html">` XHTML.
    pub rich_text_spans: Option<Vec<RichTextSpan>>,
    /// Font underline (XFA `<font underline="1">`).
    pub underline: bool,
    /// Font line-through / strikethrough (XFA `<font lineThrough="1">`).
    pub line_through: bool,
    /// XFA format picture clause (e.g. `num{z,zzz.99}`).
    pub format_pattern: Option<String>,
}

impl Default for FormNodeStyle {
    fn default() -> Self {
        Self {
            font_family: None,
            font_size: None,
            font_weight: None,
            font_style: None,
            text_color: None,
            bg_color: None,
            border_color: None,
            border_colors: None,
            border_width_pt: None,
            border_widths: None,
            space_above_pt: None,
            space_below_pt: None,
            margin_left_pt: None,
            margin_right_pt: None,
            line_height_pt: None,
            text_indent_pt: None,
            inset_top_pt: None,
            inset_bottom_pt: None,
            inset_left_pt: None,
            inset_right_pt: None,
            v_align: None,
            h_align: None,
            border_radius_pt: None,
            border_style: None,
            border_edges: [true, true, true, true],
            generic_family: None,
            font_horizontal_scale: None,
            letter_spacing_pt: None,
            caption_text: None,
            caption_placement: None,
            caption_reserve: None,
            check_button_mark: None,
            check_button_on_value: None,
            check_button_off_value: None,
            check_button_neutral_value: None,
            rich_text_spans: None,
            underline: false,
            line_through: false,
            format_pattern: None,
        }
    }
}