Best headless browser for AI agents. Lite, Fast, High-Compatibility. Built in Rust
Rust ai-agentsai-toolsbrowserbrowser-automationcloud-browserheadlessheadless-browserkitesurfplaywrightpuppeteerrustservoweb-crawlerweb-crawlingweb-scraperweb-scraping
// SPDX-License-Identifier: MIT OR Apache-2.0
use std::{fmt::Debug, hash::Hash, sync::Arc};
use taffy::Size;
use crate::{
LayoutAnonymousReason, LayoutAnonymousStyleContext, LayoutBoxId, LayoutBoxKind, LayoutDisplay,
LayoutElementCategory, LayoutElementSemantics, LayoutError, LayoutFormControlKind,
LayoutInputControlKind, LayoutStyleResolver, LayoutWorld, ResolvedLayoutStyle,
replaced::ReplacedContext,
};
pub(crate) fn prepare_form_controls<N, R>(
world: &mut LayoutWorld<N>,
styles: &mut R,
) -> Result<(), LayoutError>
where
N: Copy + Debug + Eq + Hash,
R: LayoutStyleResolver<N>,
{
let controls = (0..world.boxes.len())
.map(LayoutBoxId::from_index)
.filter_map(|id| {
form_control_texts(&world.boxes[id.index()].element_semantics)
.map(|(texts, placeholder)| (id, texts, placeholder))
})
.filter(|(id, texts, _)| {
!texts.is_empty() || world.boxes[id.index()].text_selection.is_some()
})
.collect::<Vec<_>>();
for (control, mut texts, placeholder) in controls {
let Some(owner) = world.boxes[control.index()].source else {
continue;
};
if world.boxes[control.index()]
.element_semantics
.as_ref()
.is_some_and(LayoutElementSemantics::is_select_listbox)
{
world.boxes[control.index()]
.style
.clip_form_control_contents();
}
let owner_label = world.boxes[control.index()].source_label.clone();
let placeholder_style = if placeholder {
styles.placeholder_style(owner)?.map(|style| {
let mut style = style.into_style();
style.force_layout_display(LayoutDisplay::Block);
style
})
} else {
None
};
let editor_style = styles.anonymous_style(
LayoutAnonymousStyleContext::from_parent(&world.boxes[control.index()])
.expect("form control has a source owner"),
LayoutDisplay::Block,
)?;
let selection = world.boxes[control.index()].text_selection;
if texts.is_empty() && selection.is_some() {
texts.push(Arc::from(""));
}
// Blink keeps the placeholder and inner editor as siblings. The
// placeholder precedes the empty editor, which retains its own
// font metrics and selection outside the placeholder's effect layers.
// Both remain descendants of the control's effects and clipping.
let contents = texts
.into_iter()
.map(|text| (text, placeholder))
.chain(placeholder.then(|| (Arc::from(""), false)));
for (row, (text, is_placeholder)) in contents.enumerate() {
let wrapper_style = if is_placeholder {
placeholder_style.as_ref().unwrap_or(&editor_style)
} else {
&editor_style
};
let text_style = ResolvedLayoutStyle::text_leaf_from(wrapper_style);
let selection = if is_placeholder { None } else { selection };
let mut wrapper = LayoutWorld::new_box(
None,
Some(owner),
None,
format!("form-content({owner_label})[{row}]"),
Some(owner_label.clone()),
None,
Some(LayoutAnonymousReason::FormControlContent),
LayoutBoxKind::AnonymousBlock,
wrapper_style.clone(),
None,
);
wrapper.inline_formatting_context = true;
wrapper.text_selection = selection;
let wrapper_id = world.allocate(wrapper);
let text_id = world.allocate(LayoutWorld::new_box(
None,
Some(owner),
None,
format!("form-content({owner_label})[{row}]::text"),
Some(owner_label.clone()),
None,
Some(LayoutAnonymousReason::FormControlContent),
LayoutBoxKind::Text,
text_style.clone(),
Some(text),
));
world.boxes[text_id.index()].text_selection = selection;
world.append_synthesized_child(wrapper_id, text_id)?;
world.append_synthesized_child(control, wrapper_id)?;
}
}
Ok(())
}
fn form_control_texts(semantics: &Option<LayoutElementSemantics>) -> Option<(Vec<Arc<str>>, bool)> {
let semantics = semantics.as_ref()?;
let LayoutElementCategory::FormControl(kind) = semantics.category else {
return None;
};
if !semantics.is_replaced() {
return None;
}
let data = semantics
.metadata
.form_control
.as_ref()
.cloned()
.unwrap_or_default();
if semantics.is_select_listbox() {
return Some((data.option_labels, false));
}
let placeholder = data.value.is_empty()
&& !data.placeholder.is_empty()
&& matches!(
kind,
LayoutFormControlKind::TextArea
| LayoutFormControlKind::Input(
LayoutInputControlKind::Text
| LayoutInputControlKind::Search
| LayoutInputControlKind::Email
| LayoutInputControlKind::Telephone
| LayoutInputControlKind::Password
| LayoutInputControlKind::Url
| LayoutInputControlKind::Number
)
);
let text = match kind {
LayoutFormControlKind::Input(input) => match input {
LayoutInputControlKind::Button => data.value.to_string(),
LayoutInputControlKind::Reset => {
if data.value.is_empty() {
"Reset".to_owned()
} else {
data.value.to_string()
}
}
LayoutInputControlKind::Submit => {
if data.value.is_empty() {
"Submit".to_owned()
} else {
data.value.to_string()
}
}
LayoutInputControlKind::File => {
if data.value.is_empty() {
"Choose File".to_owned()
} else {
data.value.to_string()
}
}
LayoutInputControlKind::Checkbox
| LayoutInputControlKind::Color
| LayoutInputControlKind::Hidden
| LayoutInputControlKind::Image
| LayoutInputControlKind::Radio
| LayoutInputControlKind::Range => String::new(),
LayoutInputControlKind::Date
| LayoutInputControlKind::DateTimeLocal
| LayoutInputControlKind::Email
| LayoutInputControlKind::Month
| LayoutInputControlKind::Number
| LayoutInputControlKind::Password
| LayoutInputControlKind::Search
| LayoutInputControlKind::Telephone
| LayoutInputControlKind::Text
| LayoutInputControlKind::Time
| LayoutInputControlKind::Url
| LayoutInputControlKind::Week => {
if data.value.is_empty() {
data.placeholder.to_string()
} else {
data.value.to_string()
}
}
},
LayoutFormControlKind::TextArea | LayoutFormControlKind::Select => {
if data.value.is_empty() {
data.placeholder.to_string()
} else {
data.value.to_string()
}
}
LayoutFormControlKind::Button
| LayoutFormControlKind::Option
| LayoutFormControlKind::OptionGroup
| LayoutFormControlKind::FieldSet
| LayoutFormControlKind::Legend
| LayoutFormControlKind::Output
| LayoutFormControlKind::Progress
| LayoutFormControlKind::Meter => String::new(),
};
Some((
if text.is_empty() {
Vec::new()
} else {
vec![text.into()]
},
placeholder,
))
}
pub(crate) fn select_row_height(font_size: f32, line_height: f32) -> f32 {
line_height.max(font_size) + 5.0
}
pub(crate) fn form_control_context(
semantics: &LayoutElementSemantics,
font_size: f32,
line_height: f32,
) -> Option<ReplacedContext> {
let LayoutElementCategory::FormControl(kind) = semantics.category else {
return None;
};
let data = semantics
.metadata
.form_control
.as_ref()
.cloned()
.unwrap_or_default();
let character_width = (font_size * 0.6).max(1.0);
let single_line_height = line_height.max(font_size);
let text_width = |characters: usize| characters as f32 * character_width;
let value_characters = data.value.chars().count();
let size = match kind {
LayoutFormControlKind::Input(input) => match input {
LayoutInputControlKind::Checkbox | LayoutInputControlKind::Radio => Size {
width: 13.0,
height: 13.0,
},
LayoutInputControlKind::Color => Size {
width: 44.0,
height: 23.0,
},
LayoutInputControlKind::Range => Size {
width: 129.0,
height: 20.0,
},
LayoutInputControlKind::Button
| LayoutInputControlKind::Reset
| LayoutInputControlKind::Submit => {
let default_label = match input {
LayoutInputControlKind::Reset => "Reset",
LayoutInputControlKind::Submit => "Submit",
LayoutInputControlKind::Button => "",
_ => unreachable!(),
};
Size {
width: text_width(value_characters.max(default_label.len())).max(40.0),
height: single_line_height,
}
}
LayoutInputControlKind::Image => Size {
width: 300.0,
height: 150.0,
},
LayoutInputControlKind::Hidden => Size::ZERO,
LayoutInputControlKind::Date
| LayoutInputControlKind::DateTimeLocal
| LayoutInputControlKind::Month
| LayoutInputControlKind::Time
| LayoutInputControlKind::Week => Size {
width: text_width(data.size.unwrap_or(14) as usize),
height: single_line_height,
},
LayoutInputControlKind::File => Size {
width: text_width(data.size.unwrap_or(20) as usize) + 72.0,
height: single_line_height,
},
LayoutInputControlKind::Number => Size {
width: text_width(data.size.unwrap_or(20) as usize) + 16.0,
height: single_line_height,
},
LayoutInputControlKind::Email
| LayoutInputControlKind::Password
| LayoutInputControlKind::Search
| LayoutInputControlKind::Telephone
| LayoutInputControlKind::Text
| LayoutInputControlKind::Url => Size {
width: text_width(data.size.unwrap_or(20) as usize),
height: single_line_height,
},
},
LayoutFormControlKind::TextArea => Size {
// Blink reserves a narrow editing/scrollbar gutter even when
// author CSS removes the physical border and padding.
width: text_width(usize::from(data.columns)) + 15.0,
height: f32::from(data.rows) * line_height.max(font_size),
},
LayoutFormControlKind::Select => {
let rows = data.select_rows();
let listbox = rows > 1;
let characters = data
.maximum_option_characters
.max(u16::try_from(data.value.chars().count()).unwrap_or(u16::MAX))
.max(1);
Size {
width: text_width(usize::from(characters)) + if listbox { 4.0 } else { 18.0 },
height: f32::from(rows)
* if listbox {
select_row_height(font_size, line_height)
} else {
single_line_height
},
}
}
LayoutFormControlKind::Progress | LayoutFormControlKind::Meter => Size {
width: 160.0,
height: 16.0,
},
// These controls retain normal-flow children and are not replaced
// leaves. Returning a context is harmless for callers that ask but
// construction will not route them through replaced measurement.
LayoutFormControlKind::Button
| LayoutFormControlKind::Option
| LayoutFormControlKind::OptionGroup
| LayoutFormControlKind::FieldSet
| LayoutFormControlKind::Legend
| LayoutFormControlKind::Output => Size {
width: text_width(value_characters).max(40.0),
height: single_line_height,
},
};
Some(ReplacedContext::form_control(size))
}