Dynamic label field upgrades

[benjaminpkane]

Resolves #3157
Resolves #3183
Resolves #3178

Upgrades the SDK to fully support label fields stored as embedded document fields.

Change log

• Methods like tag_labels(), select_labels(), export(), and draw_labels() automatically detect and properly handle label fields stored within embedded documents
• All Document objects now support doc["nested.field"] key access, which ensures that methods that accept label fields as parameters will gracefully support nested label fields
• Fixes some bugs related to dynamic field expansion:
  • [BUG] Dynamic field detection doesn't handle list fields with inhomogeneous values #3157
  • [BUG] Dynamic field schema methods erroneously declare subfields of Polyline points #3183
  • [BUG] with dynamic sample field and keypoints #3178

Example usage

import fiftyone as fo
import fiftyone.zoo as foz
import fiftyone.utils.annotations as foua

dataset = (
    foz.load_zoo_dataset("quickstart", max_samples=10)
    .select_fields("ground_truth")
    .limit(10)
    .clone()
)

# Move labels to an embedded document field
dataset.add_sample_field(
    "dynamic",
    fo.EmbeddedDocumentField,
    embedded_doc_type=fo.DynamicEmbeddedDocument,
)
dataset.rename_sample_field("ground_truth", "dynamic.ground_truth")

# Automatically locates labels in `dynamic.ground_truth` field
dataset.export(
    export_dir="/tmp/coco",
    dataset_type=fo.types.COCODetectionDataset,
)

# Automatically locates labels in `dynamic.ground_truth` field
dataset.draw_labels("/tmp/anno")

[codecov]

Codecov Report

Patch coverage: 6.66% and project coverage change: -34.07 ⚠️

Comparison is base (19b434f) 49.18% compared to head (104c2c1) 15.12%.

Additional details and impacted files

@@             Coverage Diff              @@
##           develop    #3152       +/-   ##
============================================
- Coverage    49.18%   15.12%   -34.07%     
============================================
  Files          230      560      +330     
  Lines        34478    68959    +34481     
  Branches       325      597      +272     
============================================
- Hits         16957    10428     -6529     
- Misses       17521    58531    +41010     

Flag	Coverage Δ
app	15.12% <6.66%> (-34.07%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ges/core/src/components/ColorModal/SidebarList.tsx	0.00% <0.00%> (ø)
...p/packages/core/src/components/ColorModal/utils.ts	0.00% <0.00%> (ø)
...es/core/src/components/FieldLabelAndInfo/index.tsx	0.00% <0.00%> (ø)
app/packages/looker/src/elements/common/tags.ts	11.19% <0.00%> (-3.49%)	⬇️
app/packages/looker/src/elements/common/util.ts	22.66% <21.42%> (-0.99%)	⬇️

... and 473 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[brimoor]

We discussed offline and I'll be adding some follow-up changes to this PR to omit label fields nested within other label fields.

[brimoor]

LGTM