FED-178 Add Documentation for uiJsComponent

[joebingham-wk]

Motivation

The process for wrapping JS components in Dart is opaque despite us having the APIs available for it to be possible. We need a document that describes the process to make it feasible for consumers to adopt the pattern.

Changes

• Add a doc that describes wrapping JS components

Release Notes

Review

See CONTRIBUTING.md for more details on review types (+1 / QA +1 / +10) and code review process.

Please review:

QA Checklist

• Tests were updated and provide good coverage of the changeset and other affected code
• Manual testing was performed if needed
  • Steps from PR author:
    • Formatting is all correct
    • Links work as expected
  • Anything falling under manual testing criteria outlined in CONTRIBUTING.md

Merge Checklist

While we perform many automated checks before auto-merging, some manual checks are needed:

• A Client Platform member has reviewed these changes
• There are no unaddressed comments - this check can be automated if reviewers use the "Request Changes" feature
• For release PRs - Version metadata in Rosie comment is correct

[aviary3-wk]

Security Insights

No security relevant content was detected by automated scans.

Action Items

• Review PR for security impact; comment "security review required" if needed or unsure
• Verify aviary.yaml coverage of security relevant code

---

Questions or Comments? Reach out on Slack: #support-infosec.

[greglittlefield-wf]

Final pass, this is looking super close! Awesome stuff

[joebingham-wk]

Applied a hold because I'm going to pass this along to at least one consumer (after we're done reviewing it) to make sure it all makes sense for them!

[aaronlademann-wf]

This is an incredible level of detail @joebingham-wk ... nice work!

Just have a couple of suggestions.

[aaronlademann-wf]

+1

[greglittlefield-wf]

Just spotted two more tiny things! Other than those and the image optimizations, this looks good to go!

[greglittlefield-wf]

• Documentation looks awesome 🎉
• No broken links

+10

[kristinrichards-wk]

+10000
This was incredibly helpful for wrapping my JS components. The level of detail is great especially around the prop mapping for tricky types (like onChange), creating mixins for interfaces and testing. Thank you for writing this up!

[joebingham-wk]

@Workiva/release-management-p

[rmconsole-wf]

+1 from RM