blitz-pdf 0.1.2 → 0.1.4

package/vendor/blitz-dom/src/accessibility.rs

@@ -0,0 +1,255 @@
+use crate::{BaseDocument, ElementData, Node as BlitzDomNode, local_name};
+use accesskit::{Node as AccessKitNode, NodeId, Role, TreeId, TreeInfo, TreeUpdate};
+use style::properties::longhands::visibility;
+
+impl BaseDocument {
+    pub fn build_accessibility_tree(&self) -> TreeUpdate {
+        let mut nodes = std::collections::HashMap::new();
+        let mut window = AccessKitNode::new(Role::Window);
+        let mut hidden_nodes = std::collections::HashSet::new();
+
+        self.visit(|node_id, node| {
+            if node.is_hidden_from_accessibility_tree()
+                || node
+                    .parent
+                    .map(|p| hidden_nodes.contains(&p))
+                    .unwrap_or(false)
+            {
+                hidden_nodes.insert(node_id);
+                return;
+            }
+            let parent = node
+                .parent
+                .and_then(|parent_id| nodes.get_mut(&parent_id))
+                .map(|(_, parent)| parent)
+                .unwrap_or(&mut window);
+            let (id, builder) = self.build_accessibility_node(node, parent);
+
+            nodes.insert(node_id, (id, builder));
+        });
+
+        let mut nodes: Vec<_> = nodes
+            .into_iter()
+            .map(|(_, (id, node))| (id, node))
+            .collect();
+        nodes.push((NodeId(u64::MAX), window));
+
+        let tree = TreeInfo::new(NodeId(u64::MAX));
+        TreeUpdate {
+            tree_id: TreeId::ROOT,
+            nodes,
+            tree: Some(tree),
+            focus: NodeId(self.focus_node_id.map(|id| id.as_u64()).unwrap_or(u64::MAX)),
+        }
+    }
+
+    fn build_accessibility_node(
+        &self,
+        node: &BlitzDomNode,
+        parent: &mut AccessKitNode,
+    ) -> (NodeId, AccessKitNode) {
+        let id = NodeId(node.id.as_u64());
+
+        let mut builder = AccessKitNode::default();
+        if node.parent.is_none() {
+            builder.set_role(Role::Window)
+        } else if let Some(element_data) = node.element_data() {
+            let name = element_data.name.local.to_string();
+            let role_attr = element_data.attr(local_name!("role"));
+
+            // TODO: The roles of elements with strong native semantics cannot be overridden; see
+            // https://www.w3.org/TR/wai-aria-1.2/#host_general_conflict.
+            let role = role_attr
+                .and_then(role_from_name)
+                .or_else(|| role_from_element_data(element_data))
+                .unwrap_or(Role::Unknown);
+
+            builder.set_role(role);
+            builder.set_html_tag(name);
+
+            // https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion
+            if element_data.attr(local_name!("aria-hidden")) == Some("true") {
+                builder.set_hidden();
+            }
+        } else if node.is_text_node() {
+            builder.set_role(Role::TextRun);
+            builder.set_value(node.text_content());
+            parent.push_labelled_by(id)
+        }
+
+        parent.push_child(id);
+
+        (id, builder)
+    }
+}
+
+impl BlitzDomNode {
+    // https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion
+    fn is_hidden_from_accessibility_tree(&self) -> bool {
+        self.try_stylo_element_data()
+            .as_ref()
+            .and_then(|s| s.get())
+            .map(|s| {
+                s.styles.is_display_none()
+                    || s.styles.primary().clone_visibility()
+                        == visibility::computed_value::T::Hidden
+            })
+            .unwrap_or(false)
+    }
+}
+
+fn role_from_name(name: &str) -> Option<Role> {
+    match name {
+        "alert" => Some(Role::Alert),
+        "alertdialog" => Some(Role::AlertDialog),
+        "button" => Some(Role::Button),
+        "checkbox" => Some(Role::CheckBox),
+        "dialog" => Some(Role::Dialog),
+        "gridcell" => Some(Role::GridCell),
+        "link" => Some(Role::Link),
+        "log" => Some(Role::Log),
+        "marquee" => Some(Role::Marquee),
+        "menuitem" => Some(Role::MenuItem),
+        "menuitemcheckbox" => Some(Role::MenuItemCheckBox),
+        "menuitemradio" => Some(Role::MenuItemRadio),
+        "option" => Some(Role::ListBoxOption),
+        "progressbar" => Some(Role::ProgressIndicator),
+        "radio" => Some(Role::RadioButton),
+        "scrollbar" => Some(Role::ScrollBar),
+        "slider" => Some(Role::Slider),
+        "spinbutton" => Some(Role::SpinButton),
+        "status" => Some(Role::Status),
+        "tab" => Some(Role::Tab),
+        "tabpanel" => Some(Role::TabPanel),
+        "textbox" => Some(Role::TextInput),
+        "timer" => Some(Role::Timer),
+        "tooltip" => Some(Role::Tooltip),
+        "treeitem" => Some(Role::TreeItem),
+        "combobox" => Some(Role::ComboBox),
+        "grid" => Some(Role::Grid),
+        "listbox" => Some(Role::ListBox),
+        "menu" => Some(Role::Menu),
+        "menubar" => Some(Role::MenuBar),
+        "radiogroup" => Some(Role::RadioGroup),
+        "tablist" => Some(Role::TabList),
+        "tree" => Some(Role::Tree),
+        "treegrid" => Some(Role::TreeGrid),
+        "article" => Some(Role::Article),
+        "columnheader" => Some(Role::ColumnHeader),
+        "definition" => Some(Role::Definition),
+        "document" => Some(Role::Document),
+        "group" => Some(Role::Group),
+        "heading" => Some(Role::Heading),
+        "img" => Some(Role::Image),
+        "list" => Some(Role::List),
+        "listitem" => Some(Role::ListItem),
+        "math" => Some(Role::Math),
+        "note" => Some(Role::Note),
+        "region" => Some(Role::Region),
+        "row" => Some(Role::Row),
+        "rowgroup" => Some(Role::RowGroup),
+        "rowheader" => Some(Role::RowHeader),
+        "toolbar" => Some(Role::Toolbar),
+        "application" => Some(Role::Application),
+        "banner" => Some(Role::Banner),
+        "complementary" => Some(Role::Complementary),
+        "contentinfo" => Some(Role::ContentInfo),
+        "form" => Some(Role::Form),
+        "main" => Some(Role::Main),
+        "navigation" => Some(Role::Navigation),
+        "search" => Some(Role::Search),
+        _ => None,
+    }
+}
+
+fn role_from_element_data(element_data: &ElementData) -> Option<Role> {
+    // <https://www.w3.org/TR/html-aam-1.0/>
+    match &*element_data.name.local {
+        // Document structure
+        "article" => Some(Role::Article),
+        "aside" => Some(Role::Complementary),
+        "footer" => Some(Role::Footer),
+        "header" => Some(Role::Header),
+        "main" => Some(Role::Main),
+        "nav" => Some(Role::Navigation),
+        "search" => Some(Role::Search),
+        "section" => Some(Role::Section),
+        "h1" | "h2" | "h3" | "h4" | "h5" | "h6" => Some(Role::Heading),
+        "p" => Some(Role::Paragraph),
+        "blockquote" => Some(Role::Blockquote),
+        "figure" => Some(Role::Figure),
+        "figcaption" | "caption" => Some(Role::Caption),
+        "hr" => Some(Role::Splitter),
+
+        // Grouping
+        "ul" | "ol" | "menu" => Some(Role::List),
+        "li" => Some(Role::ListItem),
+        "dl" => Some(Role::DescriptionList),
+        "dt" => Some(Role::Term),
+        "dd" => Some(Role::Definition),
+        "dialog" => Some(Role::Dialog),
+        "fieldset" => Some(Role::Group),
+        "form" => Some(Role::Form),
+        "div" => Some(Role::GenericContainer),
+
+        // Tables
+        "table" => Some(Role::Table),
+        "thead" | "tbody" | "tfoot" => Some(Role::RowGroup),
+        "tr" => Some(Role::Row),
+        "td" => Some(Role::Cell),
+        "th" => match element_data.attr(local_name!("scope")) {
+            Some("row") | Some("rowgroup") => Some(Role::RowHeader),
+            _ => Some(Role::ColumnHeader),
+        },
+
+        // Interactive
+        // An <a> is only a link when it has an href.
+        "a" => match element_data.attr(local_name!("href")) {
+            Some(_) => Some(Role::Link),
+            None => Some(Role::GenericContainer),
+        },
+        "button" => Some(Role::Button),
+        "label" => Some(Role::Label),
+        "legend" => Some(Role::Label),
+        "select" => match element_data.attr(local_name!("multiple")) {
+            Some(_) => Some(Role::ListBox),
+            None => Some(Role::ComboBox),
+        },
+        "option" => Some(Role::ListBoxOption),
+        "textarea" => Some(Role::MultilineTextInput),
+        "progress" => Some(Role::ProgressIndicator),
+        "meter" => Some(Role::Meter),
+        "output" => Some(Role::Status),
+        "summary" => Some(Role::DisclosureTriangle),
+
+        // Inline semantics
+        "code" => Some(Role::Code),
+        "em" => Some(Role::Emphasis),
+        "strong" => Some(Role::Strong),
+        "mark" => Some(Role::Mark),
+        "time" => Some(Role::Time),
+        "img" => Some(Role::Image),
+        "iframe" => Some(Role::Iframe),
+
+        "input" => {
+            let ty = element_data.attr(local_name!("type")).unwrap_or("text");
+            match ty {
+                "button" | "submit" | "reset" => Some(Role::Button),
+                "checkbox" => Some(Role::CheckBox),
+                "color" => Some(Role::ColorWell),
+                "date" => Some(Role::DateInput),
+                "datetime-local" => Some(Role::DateTimeInput),
+                "email" => Some(Role::EmailInput),
+                "number" => Some(Role::NumberInput),
+                "password" => Some(Role::PasswordInput),
+                "radio" => Some(Role::RadioButton),
+                "range" => Some(Role::Slider),
+                "search" => Some(Role::SearchInput),
+                "tel" => Some(Role::PhoneNumberInput),
+                "time" => Some(Role::TimeInput),
+                _ => Some(Role::TextInput),
+            }
+        }
+        _ => None,
+    }
+}

package/vendor/blitz-dom/src/config.rs

@@ -0,0 +1,97 @@
+use crate::{HtmlParserProvider, UserAgentStylesheet};
+use blitz_traits::{
+    navigation::NavigationProvider,
+    net::{AbortSignal, NetProvider},
+    shell::{ShellProvider, Viewport},
+};
+use parley::FontContext;
+use std::sync::Arc;
+use style::media_queries::MediaType;
+
+/// Strategy for Stylo's style traversal during `resolve`.
+///
+/// Two `Document`s resolving on [`StyleThreading::Parallel`] concurrently
+/// share Stylo's global thread pool and can panic with
+/// `already mutably borrowed` — see
+/// <https://github.com/DioxusLabs/blitz/issues/430>. Set
+/// [`StyleThreading::Sequential`] on documents that may resolve from a
+/// user thread while another `Parallel` resolve is in flight.
+#[derive(Default, Clone, Copy, PartialEq, Eq, Debug)]
+pub enum StyleThreading {
+    /// Use Stylo's parallel traversal via its global rayon thread pool.
+    /// Fastest for a single document; panics if another `Parallel` resolve
+    /// is in flight on a different thread.
+    Parallel,
+    /// Run style traversal sequentially on the calling thread, bypassing
+    /// the global pool. Safe to use from many user threads concurrently.
+    #[default]
+    Sequential,
+}
+
+/// Options used when constructing a [`BaseDocument`](crate::BaseDocument)
+pub struct DocumentConfig {
+    /// The initial `Viewport`
+    pub viewport: Option<Viewport>,
+    /// Exact CSS viewport dimensions, independent of the integer window size.
+    pub layout_viewport: Option<(f32, f32)>,
+    /// Snap box edges to whole CSS pixels. Disable for vector output.
+    pub round_layout: bool,
+    /// The base url which relative URLs are resolved against
+    pub base_url: Option<String>,
+    /// User Agent stylesheets, in cascade order. Defaults to `vec![UserAgentStylesheet::default_sheet()]`.
+    ///
+    /// The list is used as given, so replacing it removes the default sheet unless it is
+    /// included, e.g. `vec![UserAgentStylesheet::default_sheet(), custom]`.
+    pub ua_stylesheets: Vec<UserAgentStylesheet>,
+    /// Net provider to handle network requests for resources
+    pub net_provider: Option<Arc<dyn NetProvider>>,
+    /// Navigation provider to handle link clicks and form submissions
+    pub navigation_provider: Option<Arc<dyn NavigationProvider>>,
+    /// Shell provider to redraw requests, clipboard, etc
+    pub shell_provider: Option<Arc<dyn ShellProvider>>,
+    /// HTML parser provider. Used to parse HTML for setInnerHTML
+    pub html_parser_provider: Option<Arc<dyn HtmlParserProvider>>,
+    /// Parley `FontContext`
+    pub font_ctx: Option<FontContext>,
+    /// The CSS media type used to evaluate `@media` rules.
+    /// Defaults to [`MediaType::screen`].
+    pub media_type: Option<MediaType>,
+    /// Strategy for Stylo's style traversal.
+    /// Defaults to [`StyleThreading::Parallel`].
+    pub style_threading: StyleThreading,
+    /// Whether incremental layout is enabled. Defaults to `true`.
+    ///
+    /// When disabled, every node is treated as damaged on each `resolve` and the
+    /// whole tree is reconstructed and laid out from scratch through the same
+    /// damage-driven pipeline used by incremental mode.
+    pub incremental: Option<bool>,
+    /// If set, every sub-resource `Request` blitz-dom creates for this
+    /// document will carry this signal. Aborting it cancels every in-flight
+    /// fetch tied to this document.
+    pub abort_signal: Option<AbortSignal>,
+    /// How deeply this document is nested within other documents
+    /// (0 for a root document). Used to limit `<iframe>` nesting depth.
+    pub subdocument_depth: usize,
+}
+
+impl Default for DocumentConfig {
+    fn default() -> Self {
+        Self {
+            viewport: None,
+            layout_viewport: None,
+            round_layout: true,
+            base_url: None,
+            ua_stylesheets: vec![UserAgentStylesheet::default_sheet()],
+            net_provider: None,
+            navigation_provider: None,
+            shell_provider: None,
+            html_parser_provider: None,
+            font_ctx: None,
+            media_type: None,
+            style_threading: StyleThreading::default(),
+            incremental: None,
+            abort_signal: None,
+            subdocument_depth: 0,
+        }
+    }
+}