Support for a docked sheet

[HadrienGardeur]

This component will look almost exactly like the popover sheet described in #41, but rather than appearing on top of the content, it'll be displayed next to it, pushing things to the side in doing so.

If the affordance allows it, this component should also be resizable, allowing the user to control the width, as constrained by a minimum and maximum width.

[JayPanoz]

Question: what happens to Arrows when a sheet is docked?

Is it grouped with the iframe’s container and displayed next to it? Or is it its own separate element that is always displayed at the edge of the screen/window?

For instance:

1. Docked Toc | Arrow Left | iframe | Arrow Right
2. Arrow Left | Docked Toc | iframe | Arrow Right

Edit: Answer 2.

Basically we have docked left | arrow left | iframe | arrow right | docked right

[JayPanoz]

Detailing what has to be handled after the initial implementation on commit 33fc3d8d deployment – not using the alias to pinpoint the state at the time of writing.

• add aria labels to docking elements
• display based on preference (Sheets.dockedLeft + Sheets.dockedRight)
• make panel draggable, with preferences
• handle edge cases of dockable and sheet: Sheets.docked{Side} preferences since on smaller breakpoints, it makes sense panels are not dockable but fullscreen – and the sheet should therefore not display the docking options in that case
• clicking on the action icon should close the docked panel
• there’s a bug the first time you dock the panel – autoPagination doesn’t update as it should, which may either be a stale state, or a wrong clientWidth when constraining the container’s width
• there’s a rendering issue with the container’s width not being correct, with the panel being cut off
• add the logic for FXL – unlike reflow, the navigator’s container is not constrained at the moment, as it created issues with the FXLFramePoolManager’s resize handler that we didn’t need to address at that time, but we now do and it seems likely it will impact the ts-toolkit
• define focus and keyboard handling