Selection updates for parallel APIs ff125

[hamishwillee]

FF126 adds Selection.getComposedRanges() in nightly, but it also adds some updates to existing APIs:

• Selection.getComposedRanges()
  • can return multiple ranges, but only in firefox. Spec expects returning 1 range at the moment.
  • Added an URL to docs (still being written)
• Selection.setBaseAndExtent() - this will now accept anchorNode and focusNode arguments that reside in different shadow trees, which will set the selection accordingly.
• Selection.collapse() - can now accept a node in any tree, and will collapse the range to that Node.
• extend() - This should work as-expected, even if the new focusNode is in a different shadow tree.

There are other features coming but that is what is in now (according to https://bugzilla.mozilla.org/show_bug.cgi?id=1867058#c31)

FYI another thing that I don't know how to capture in BCD. I don' think I will:

User selection via mouse, keyboard, etc. - The selection generated by this activity should be allowed to start and end anywhere in the document, including inside any open or closed shadow trees. The behavior should be equivalent to calls to setBaseAndExtent(), modulo canonicalization behavior.

Related work can be tracked in mdn/content#33180

[hamishwillee]

FYI, spec only requires returning one range.

[dipikabh]

Hi @queengooborg, would it be possible for you to review this PR?

[queengooborg]

Hi @dipikabh, this is on my review queue already. No need to ping me after marking me for review. :)

[Elchi3]

Thanks @hamishwillee, looks reasonable to me. 👍