Generate archetype field info (opt-in for a single type so far) and u…

…se it in blueprint property ui (#6413)

### What

* Part of  #6237
* I think the "only" part left now is to use this for all blueprint
properties
       *  the tricky bit here is that this is dependent on  #4194

This creates an tight nit & generic coupling from our type definitions
to the ui! This is to be used in all blueprint properties, so far used
on `PlotLegend` only.
<img width="320" alt="image"
src="https://github.com/rerun-io/rerun/assets/1220815/405b6ecc-2db1-4ad5-9b3c-aad96c8ad074">

Drawbacks:
* lower snake case because that's what our fields look like - we could
change that easily but there's some value to that because that's what
all SDKs use as field names. Very much open for discussion!
* some parts of the doc strings might be weird outside of the context of
the ui, but I can live with that

Future stuff:
* we could very very easily now also add reference doc links in there
via some linking mechanism (viewer could choose depending on preference
or source sdk)

### Checklist
* [x] I have read and agree to [Contributor
Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and
the [Code of
Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md)
* [x] I've included a screenshot or gif (if applicable)
* [x] I have tested the web demo (if applicable):
* Using examples from latest `main` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/6413?manifest_url=https://app.rerun.io/version/main/examples_manifest.json)
* Using full set of examples from `nightly` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/6413?manifest_url=https://app.rerun.io/version/nightly/examples_manifest.json)
* [x] The PR title and labels are set such as to maximize their
usefulness for the next release's CHANGELOG
* [x] If applicable, add a new check to the [release
checklist](https://github.com/rerun-io/rerun/blob/main/tests/python/release_checklist)!

- [PR Build Summary](https://build.rerun.io/pr/6413)
- [Recent benchmark results](https://build.rerun.io/graphs/crates.html)
- [Wasm size tracking](https://build.rerun.io/graphs/sizes.html)

To run all checks from `main`, comment on the PR with `@rerun-bot
full-check`.

Cargo.lock

@@ -4643,6 +4643,7 @@ dependencies = [
 name = "re_space_view"
 version = "0.17.0-alpha.2"
 dependencies = [
+ "ahash",
  "egui",
  "re_data_store",
  "re_entity_db",

crates/re_log_types/src/example_components.rs

@@ -20,6 +20,10 @@ impl re_types_core::Archetype for MyPoints {
  "example.MyPoints".into()
  }
 
+ fn display_name() -> &'static str {
+ "MyPoints"
+ }
+
  fn required_components() -> ::std::borrow::Cow<'static, [re_types_core::ComponentName]> {
  vec![MyPoint::name()].into()
  }

crates/re_space_view/Cargo.toml

@@ -31,4 +31,5 @@ re_ui.workspace = true
 re_viewer_context.workspace = true
 re_viewport_blueprint.workspace = true
 
+ahash.workspace = true
 egui.workspace = true

crates/re_space_view/src/view_property_ui.rs

@@ -1,3 +1,4 @@
+use ahash::HashMap;
 use re_types_core::Archetype;
 use re_ui::list_item;
 use re_viewer_context::{SpaceViewId, ViewerContext};
@@ -22,34 +23,49 @@ pub fn view_property_ui<A: Archetype>(
  component_names.iter().copied(),
  );
 
+ let field_info_per_component: HashMap<_, _> = A::field_infos()
+ .map(|field_infos| {
+ field_infos
+ .iter()
+ .cloned()
+ .map(|field_info| (field_info.component_name, field_info))
+ .collect()
+ })
+ .unwrap_or_default();
+
  let sub_prop_ui = |re_ui: &re_ui::ReUi, ui: &mut egui::Ui| {
  for component_name in component_names.as_ref() {
  if component_name.is_indicator_component() {
  continue;
  }
 
- list_item::ListItem::new(re_ui)
+ let field_info = field_info_per_component.get(component_name);
+ let display_name =
+ field_info.map_or_else(|| component_name.short_name(), |info| info.display_name);
+
+ let list_item_response = list_item::ListItem::new(re_ui)
  .interactive(false)
  .show_flat(
  ui,
- // TODO(andreas): Note that we loose the archetype's field name here, instead we label the item with the component name.
- list_item::PropertyContent::new(component_name.short_name()).value_fn(
- |_, ui, _| {
- ctx.component_ui_registry.edit_ui(
- ctx,
- ui,
- re_viewer_context::UiLayout::List,
- blueprint_query,
- blueprint_db,
- &blueprint_path,
- &blueprint_path,
- component_results.get_or_empty(*component_name),
- component_name,
- &0.into(),
- );
- },
- ),
+ list_item::PropertyContent::new(display_name).value_fn(|_, ui, _| {
+ ctx.component_ui_registry.edit_ui(
+ ctx,
+ ui,
+ re_viewer_context::UiLayout::List,
+ blueprint_query,
+ blueprint_db,
+ &blueprint_path,
+ &blueprint_path,
+ component_results.get_or_empty(*component_name),
+ component_name,
+ &0.into(),
+ );
+ }),
  );
+
+ if let Some(tooltip) = field_info.map(|info| info.documentation) {
+ list_item_response.on_hover_text(tooltip);
+ }
  }
  };
 
@@ -59,7 +75,7 @@ pub fn view_property_ui<A: Archetype>(
  ui,
  A::name().full_name(),
  true,
- list_item::LabelContent::new(A::name().short_name()),
+ list_item::LabelContent::new(A::display_name()),
  sub_prop_ui,
  );
 }

crates/re_types/definitions/rerun/blueprint/archetypes/plot_legend.fbs

@@ -14,6 +14,7 @@ namespace rerun.blueprint.archetypes;
 table PlotLegend (
  "attr.rerun.scope": "blueprint",
  "attr.rust.derive": "Default",
+ "attr.rust.generate_field_info",
  "attr.python.aliases": "blueprint_components.Corner2D"
 ) {
  // --- Optional ---

crates/re_types/definitions/rust/attributes.fbs

@@ -49,3 +49,6 @@ attribute "attr.rust.override_crate";
 /// an object of kind `Blueprint` with `attr.rust.override_crate=re_viewport`, the final
 /// object will be generated in `crates/re_viewport/src/blueprint`.
 attribute "attr.rust.serde_type";
+
+/// Specify on an archetype to opt-in into generating `ArchetypeFieldInfo` for all fields.
+attribute "attr.rust.generate_field_info";