osfile: add backward-compatibility with TB 102

This commit reintroduces OS.File into the osfile experiment on
older versions of Thunderbird, that do not yet include IOUtils.

Bump copyright information

osfile: switch to IOUtils, move to parent

For some reasons, beta versions of Thunderbird 115 seem to have dropped
OS.File; this commit thus switches the osfile experiment to use the
successor API IOUtils. As Mozilla seems to tighten restrictions on child
processes and we don't care about performance at this point, this commit
furthermore moves the osfile experiment out of the child scope to prevent
future incompatibilities.

customui/cachingfix: Services.jsm deprecation

Accessing the Services object through Services.jsm might stop working in
future releases of Thunderbird. This commit alters the experiments to
access the Services object through the more modern globalThis, if possible.

customui: Basic support for Thunderbird Supernova

This commit introduces very basic support for changes in Thunderbird
leading up to the new UI "Supernova", scheduled to be released with
Thunderbird 115.

As of this commit, the experiment is operational with the new version;
some features like sidebar resizing are however not available when
running in a recent version of Thunderbird. Furthermore, there are a few
visual glitches regarding the locations using sidebar code changing
their desired size.

tcp: Move sockets into parent process (API change)

This commit moves sockets from the extension content process into the
parent process, which is necessary for upcoming versions of Thunderbird.
To reduce the performance impact, it also changes the API to no longer
permit unbounded read operations: read now takes a length and returns an
ArrayBuffer, readFully was removed.

customui: partial compatibility with TB 102

This commit fixes the generic address book location, working around the
issue of the address book tab not being capable of hosting remote
browsers by adding the frame outside of the actual tab browser.

Other address book locations remain broken in Thunderbird 102, but this
commit does add documentation to describe them as such.

Add gitignore

This commit adds a minimal ignore file to exclude temporary files
generated by common tools.

tcp: Fix reading into large buffers

Recent versions of Thunderbird limit the amount of data cached in a
socket for reading. Waiting until enough data is available to fill a
large buffer thus might cause the application to hang.

This commit thus alters the behavior of readFully to read out all
available data from the socket immediately, filling the given buffer in
multiple steps if required.

customui: dynamic sidebar width

This commit expands on customUI sidebar locations, adding the option to
control visibility and width with options. As part of these changes, it
furthermore makes handling of local options more generic to simplify
adding similar features and more complex locations in the future.

Co-authored-by: Dirk Steinmetz <ds@generalsync.com>

customui: add actions to "all locations" example

To simplify testing customUI frame behavior, this commit adds various
actions to each frame registered by the "all locations" example.

implementationprovider: minor fixes

This commit addresses three minor issues in the implementationprovider
experiment:
- Improved support for privileged use from other experiments
- Fixed the child JSMs not loading properly from a packed add-on
- Minor typo

runtime: dirty hack for TB91

This commit replaces the runtime API extension with a dirty hack as
drop-in solution for TB91. Fixing it properly is likely not feasible.

tcp: update for TB91

This commit updates the tcp experiment with API changes in TB91.

customui: fix calendar locations on TB91

This commit fixes compatibility issues with calendar locations
introduced between TB 78 and 91.

customui: E10S fixes for recent versions

This commit fixes an issue where Webextension APIs are unavailable in
custom UI frames in very recent versions of Thunderbird. Furthermore, it
implements some additional E10S lifecycle things that seem to be
recommended to work around potential issues with framing.

implementationprovider: add example to readme

This commit introduces a very dense example of the basic API usage into
the readme, to give a first glimpse in the API without opening the code.

implementationprovider-aggregators: fix readme

This commit fixes a copy-paste error.

Add example for ImplementationProvider

This commit introduces an example add-on using the
ImplementationProvider API: a background page provides two ways of
aggregating numbers, and an experiment script running in the parent
process instantiates the classes and plays around with them.

Add new experiment: ImplementationProvider

This commit introduces a new experiment: the ImplementationProvider API
permits to use pure WebExtension class declarations from parent
experiment code. As a proof of concept, it both demonstrates feasibility
and provides a playground for experiments with that idea.

Remove manifest.json

The central manifest is redundant, as there are manifest snippet files
for each individual experiment. Furthermore, having a complete example
is no longer necessary as there is now a separate example folder with
better examples. For these reasons, this commit removes manifest.json
from the reporitory root.

customui: fix sidebar element name

As the convention of the customui API is to use a lowercase 'customui'
in identifiers, this commit updates the id used for sidebar elements.

Update LICENSE/NOTICE

This commit updates the legal stuff: bump year and add John.

Add all location example for customui

This commit adds an runnable add-on that uses the customui API to bind
to all available locations, primarily useful for testing.

customui: refactor sidebars

This commit fixes the codestyle for sidebar locations in the customui
API.

customui: make sidebar locations generic

This commit alters names and description of customui's sidebar locations
to be more generic; after all, future versions of Thunderbird might use
different concepts than a sidebar to realize the same feature.

customui: add sidebar

This commit extends the customui API with support for a sidebar location
in the main window. It also updates the existing sidebar location to use a
more suitable id.

customui: add sidebar for composer

This commit adds a new location to customui, permitting to inject UI into
the composer's sidebar. For now, no options are supported in that location.

customui: E10S support

This commit adds the necessary metadata to load frames in the correct
child process for the add-on.

customui: fix contextId in browser id

This commit fixes the capitalization of contextId, so we actually
include the id of the context in the inserted browser's id now.

customui: codestyle for unknown file action

This commit makes code and documentation of customui's unknown file
action location more consistent with their surroundings (fit code to 80
chars, alphabetical order, add documentation about context).

customui: add LOCATION_UNKNOWN_FILE_ACTION

This commit expands the customui experiment with a location at the bottom
of the dialog asking the user which action to complete when opening a file
with an unknown content type.

Add readme for cachingfix and customui

This commit introduces some more additional documentation for the
cachingfix and customui experiments.

customui: event edit location, local options

This commit adds a location in the event editing window/tab to the
customui experiment, as well as support for altering local options from
a custom ui frame. This permits the frame to dynamically adjust its size
and display status (visible / hidden).

Replace fixCaching.jsm with experiment

It is actually possible to create an experiment handling add-on lifetime
and doing all the things fixCaching.jsm is doing, without having to call
any API from within the experiments or the webextension. This commit
implements that.

It also includes manifest examples for each individual experiment, to
simplify copy-pasting.

Experiments from 2.0.0.0

This commit features all open-source experiments from the 2.0.0.0
version of the GeneralSync integration add-on.