style: cargo fmt with the workspace tab policy (hard_tabs)

Whitespace only; the fork has no own rustfmt.toml so the Oak root
policy applies.
This commit is contained in:
2026-08-11 23:06:13 +08:00
parent 507d7e6e8d
commit af5482d774
318 changed files with 132564 additions and 132170 deletions
+117 -117
View File
@@ -34,12 +34,12 @@ pub struct EdgeId(pub u64);
/// Whether a port accepts incoming connections or produces outgoing ones.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum PortKind {
/// A port that consumes data; conventionally drawn on the left side of a
/// node and accepts connections *from* an [`PortKind::Output`] port.
Input,
/// A port that produces data; conventionally drawn on the right side of a
/// node and connects *to* an [`PortKind::Input`] port.
Output,
/// A port that consumes data; conventionally drawn on the left side of a
/// node and accepts connections *from* an [`PortKind::Output`] port.
Input,
/// A port that produces data; conventionally drawn on the right side of a
/// node and connects *to* an [`PortKind::Input`] port.
Output,
}
/// A lightweight, app-defined descriptor of the data flowing through a port.
@@ -59,28 +59,28 @@ pub enum PortKind {
/// distinct types sharing a name should disambiguate the name.
#[derive(Clone, Debug)]
pub struct PortDataType {
/// Human-readable type name, e.g. `"video"`, `"audio"`, `"matte"`.
/// Also used as the identity of the type (see type-level docs).
pub name: SharedString,
/// Color used to tint port dots and wires carrying this type.
pub color: Hsla,
/// Human-readable type name, e.g. `"video"`, `"audio"`, `"matte"`.
/// Also used as the identity of the type (see type-level docs).
pub name: SharedString,
/// Color used to tint port dots and wires carrying this type.
pub color: Hsla,
}
impl PortDataType {
/// Creates a new data-type descriptor with the given display name and
/// tint color.
pub fn new(name: impl Into<SharedString>, color: Hsla) -> Self {
Self {
name: name.into(),
color,
}
}
/// Creates a new data-type descriptor with the given display name and
/// tint color.
pub fn new(name: impl Into<SharedString>, color: Hsla) -> Self {
Self {
name: name.into(),
color,
}
}
}
impl PartialEq for PortDataType {
fn eq(&self, other: &Self) -> bool {
self.name == other.name
}
fn eq(&self, other: &Self) -> bool {
self.name == other.name
}
}
impl Eq for PortDataType {}
@@ -91,27 +91,27 @@ impl Eq for PortDataType {}
/// [`PortId`], a direction ([`PortKind`]) and a [`PortDataType`] used for
/// tinting.
pub trait PortData {
/// Returns the globally unique identifier of this port.
fn id(&self) -> PortId;
/// Returns the globally unique identifier of this port.
fn id(&self) -> PortId;
/// Returns whether this is an input or an output port.
fn kind(&self) -> PortKind;
/// Returns whether this is an input or an output port.
fn kind(&self) -> PortKind;
/// Returns the short label drawn next to the port dot (e.g. `"in"`,
/// `"mask"`). May be empty, in which case only the dot is drawn.
fn label(&self) -> SharedString;
/// Returns the short label drawn next to the port dot (e.g. `"in"`,
/// `"mask"`). May be empty, in which case only the dot is drawn.
fn label(&self) -> SharedString;
/// Returns the data type of this port, used to tint the port dot and any
/// wires connected to it.
fn data_type(&self) -> PortDataType;
/// Returns the data type of this port, used to tint the port dot and any
/// wires connected to it.
fn data_type(&self) -> PortDataType;
/// Returns whether this port currently has at least one edge attached.
///
/// Used only for rendering (connected dots are filled, unconnected dots
/// are hollow) and for styling during wire drags; the widget does not
/// enforce any cardinality rules from it — that is the job of
/// [`NodeGraphDataSource::can_connect`].
fn is_connected(&self) -> bool;
/// Returns whether this port currently has at least one edge attached.
///
/// Used only for rendering (connected dots are filled, unconnected dots
/// are hollow) and for styling during wire drags; the widget does not
/// enforce any cardinality rules from it — that is the job of
/// [`NodeGraphDataSource::can_connect`].
fn is_connected(&self) -> bool;
}
/// A single node in the graph.
@@ -120,67 +120,67 @@ pub trait PortData {
/// left and a column of output ports on the right (see
/// [`NodeElement`](crate::node_graph::NodeElement)).
pub trait NodeData {
/// The port type used by this node's inputs and outputs.
type Port: PortData;
/// The port type used by this node's inputs and outputs.
type Port: PortData;
/// Returns the unique identifier of this node.
fn id(&self) -> NodeId;
/// Returns the unique identifier of this node.
fn id(&self) -> NodeId;
/// Returns the title drawn in the node's header.
fn title(&self) -> SharedString;
/// Returns the title drawn in the node's header.
fn title(&self) -> SharedString;
/// Returns the position of the node's top-left corner in *graph space*
/// (the document coordinate system).
///
/// Graph space is an unbounded, zoom-independent coordinate system: a
/// node at `point(px(100.), px(40.))` stays attached to that document
/// location regardless of pan and zoom. The view converts to screen
/// coordinates with
/// [`GraphViewState::graph_to_screen`](crate::node_graph::GraphViewState::graph_to_screen).
fn position(&self) -> Point<Pixels>;
/// Returns the position of the node's top-left corner in *graph space*
/// (the document coordinate system).
///
/// Graph space is an unbounded, zoom-independent coordinate system: a
/// node at `point(px(100.), px(40.))` stays attached to that document
/// location regardless of pan and zoom. The view converts to screen
/// coordinates with
/// [`GraphViewState::graph_to_screen`](crate::node_graph::GraphViewState::graph_to_screen).
fn position(&self) -> Point<Pixels>;
/// Returns the input ports of this node, in top-to-bottom draw order.
fn inputs(&self) -> Vec<Self::Port>;
/// Returns the input ports of this node, in top-to-bottom draw order.
fn inputs(&self) -> Vec<Self::Port>;
/// Returns the output ports of this node, in top-to-bottom draw order.
fn outputs(&self) -> Vec<Self::Port>;
/// Returns the output ports of this node, in top-to-bottom draw order.
fn outputs(&self) -> Vec<Self::Port>;
/// Returns an optional accent color for the node header, or `None` to use
/// the theme default. Apps typically use this to group nodes by category
/// (inputs, transforms, color management, outputs, …).
fn header_color(&self) -> Option<Hsla>;
/// Returns an optional accent color for the node header, or `None` to use
/// the theme default. Apps typically use this to group nodes by category
/// (inputs, transforms, color management, outputs, …).
fn header_color(&self) -> Option<Hsla>;
/// Returns whether the node is collapsed to just its header.
///
/// Collapsed nodes draw no ports and cannot be connection targets. The
/// collapsed state itself belongs to the app's model (or view state); the
/// widget only reflects it.
fn is_collapsed(&self) -> bool;
/// Returns whether the node is collapsed to just its header.
///
/// Collapsed nodes draw no ports and cannot be connection targets. The
/// collapsed state itself belongs to the app's model (or view state); the
/// widget only reflects it.
fn is_collapsed(&self) -> bool;
/// Returns whether the node is enabled.
///
/// Disabled nodes (e.g. a bypassed effect) are drawn dimmed. This is a
/// purely visual hint; the widget does not change interaction behavior
/// for disabled nodes.
fn is_enabled(&self) -> bool;
/// Returns whether the node is enabled.
///
/// Disabled nodes (e.g. a bypassed effect) are drawn dimmed. This is a
/// purely visual hint; the widget does not change interaction behavior
/// for disabled nodes.
fn is_enabled(&self) -> bool;
}
/// A single directed connection from an output port to an input port.
pub trait EdgeData {
/// Returns the unique identifier of this edge.
fn id(&self) -> EdgeId;
/// Returns the unique identifier of this edge.
fn id(&self) -> EdgeId;
/// Returns the id of the node the connection starts at.
fn from_node(&self) -> NodeId;
/// Returns the id of the node the connection starts at.
fn from_node(&self) -> NodeId;
/// Returns the id of the output port the connection starts at.
fn from_port(&self) -> PortId;
/// Returns the id of the output port the connection starts at.
fn from_port(&self) -> PortId;
/// Returns the id of the node the connection ends at.
fn to_node(&self) -> NodeId;
/// Returns the id of the node the connection ends at.
fn to_node(&self) -> NodeId;
/// Returns the id of the input port the connection ends at.
fn to_port(&self) -> PortId;
/// Returns the id of the input port the connection ends at.
fn to_port(&self) -> PortId;
}
/// The data source backing a [`NodeGraphView`](crate::node_graph::NodeGraphView).
@@ -195,40 +195,40 @@ pub trait EdgeData {
///
/// [`NodeGraphEvent`]: crate::node_graph::NodeGraphEvent
pub trait NodeGraphDataSource {
/// The node type returned by [`nodes()`](Self::nodes).
type Node: NodeData;
/// The edge type returned by [`edges()`](Self::edges).
type Edge: EdgeData;
/// The node type returned by [`nodes()`](Self::nodes).
type Node: NodeData;
/// The edge type returned by [`edges()`](Self::edges).
type Edge: EdgeData;
/// Returns all nodes to display, in no required order (the view sorts for
/// painting; selection order is unaffected).
fn nodes(&self) -> Vec<Self::Node>;
/// Returns all nodes to display, in no required order (the view sorts for
/// painting; selection order is unaffected).
fn nodes(&self) -> Vec<Self::Node>;
/// Returns all edges to display. Edges referencing ports or nodes that
/// are not part of [`nodes()`](Self::nodes) are ignored by the view.
fn edges(&self) -> Vec<Self::Edge>;
/// Returns all edges to display. Edges referencing ports or nodes that
/// are not part of [`nodes()`](Self::nodes) are ignored by the view.
fn edges(&self) -> Vec<Self::Edge>;
/// Returns whether connecting output port `from` to input port `to`
/// would be valid.
///
/// This is the single place where the app enforces its connection rules:
/// data-type compatibility (including implicit conversions), cycle
/// prevention, port cardinality, node enablement, and so on. The view
/// calls this:
///
/// - *continuously during a wire drag* to highlight compatible target
/// ports and to mark the ghost wire as valid/invalid, and
/// - *once on drop* before emitting
/// [`NodeGraphEvent::ConnectionRequested`](crate::node_graph::NodeGraphEvent::ConnectionRequested)
/// — a drop on a port for which this returns `false` cancels the drag
/// silently.
///
/// It must be cheap, pure, and consistent: the same arguments must yield
/// the same answer within a frame. The view passes output port first,
/// input port second, regardless of which end the user started the drag
/// from. Returning `true` here does not commit the app to accepting the
/// connection; the engine may still reject it when the event arrives
/// (e.g. it raced with another edit), in which case the app simply does
/// not apply it.
fn can_connect(&self, from: PortId, to: PortId) -> bool;
/// Returns whether connecting output port `from` to input port `to`
/// would be valid.
///
/// This is the single place where the app enforces its connection rules:
/// data-type compatibility (including implicit conversions), cycle
/// prevention, port cardinality, node enablement, and so on. The view
/// calls this:
///
/// - *continuously during a wire drag* to highlight compatible target
/// ports and to mark the ghost wire as valid/invalid, and
/// - *once on drop* before emitting
/// [`NodeGraphEvent::ConnectionRequested`](crate::node_graph::NodeGraphEvent::ConnectionRequested)
/// — a drop on a port for which this returns `false` cancels the drag
/// silently.
///
/// It must be cheap, pure, and consistent: the same arguments must yield
/// the same answer within a frame. The view passes output port first,
/// input port second, regardless of which end the user started the drag
/// from. Returning `true` here does not commit the app to accepting the
/// connection; the engine may still reject it when the event arrives
/// (e.g. it raced with another edit), in which case the app simply does
/// not apply it.
fn can_connect(&self, from: PortId, to: PortId) -> bool;
}