[39] [57] Move features package to named exports, preventing "ssr" package dependency. Firefox compatibility.

[TomStrepsil]

Issue

resolves #39
resolves #57

Details

• Modify the "features" package to used named exports; independent bundles per features store factory, thus ensuring the "ssr" package is not a dependency of the single export, effectively rendering it a fixed requirement at build time (despite tree shaking removing if not used)
• Should also allow react "server components" to import feature stores that don't rely on React context, which it otherwise complains about having spotted an import in the bundle:

Error: × You're importing a component that needs `createContext`. This React hook only works in a client component. To fix, mark the file (or its parent) with the `"use client"` directive.

• Added note regarding incompatibility with eslint-plugin-import, due to long standing issue - with options on how to mitigate.
• renamed useValue from SingletonFeaturesStore interface to setValue, to avoid React rules-of-hooks errors
• support FireFox in the globalFeaturesStoreFactory (issue WeakMap with Symbol key used in "global" features store is incompatible with FireFox #57)

Scout Rule

• rename isClient to isBrowser in the build setup & package.json script input, to better describe the intended audience of the browser bundles
• change the order/nature of the exports on all packages to better support typescript module resolution

all examples

• moved to import typescript types explicitly (as type) after unexpected pipeline failure

ssr package

• support de-structuring of the output from the serialisation factory

Upgrade guide

• imports of

import { ssrBackedReactContextFeaturesStoreFactory as featuresStoreFactory } from "@asos/web-toggle-point-features";

...should become:

import featuresStoreFactory from "@asos/web-toggle-point-features/storeFactories/ssrBackedReactContextFeaturesStoreFactory";

...with the same format applying to globalFeaturesStoreFactory, reactContextFeaturesStoreFactory and nodeRequestScopedFeaturesStoreFactory

CheckList

• PR starts with [ISSUE_ID].
• Has been tested (where required) before merge to main.

[TomStrepsil]

N.B. For posterity, I believe the change in the Windows Emoji that caused a pipeline failure and resulted in a new image being uploaded here was due to this: