Skip to content

polyfill to access the package `'@neos-project/neos-ui-guest-frame'` via the custom consumerApi.

License

Notifications You must be signed in to change notification settings

mhsdesign/MhsDesign.PolyfillNeosUiGuestFrameApi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Neos Ui

MhsDesign.PolyfillNeosUiGuestFrameApi

When Neos.Ui version greater or equal to 7.2 is installed, this package does 'nothing' ^^ (no js will be loaded)

Why do i need it

This package provides a polyfill to access the package '@neos-project/neos-ui-guest-frame' via the custom consumerApi solution of the Neos.Ui on earlier Ui versions.

Neos.Ui supports since FEATURE: Consumer Api for @neos-project/neos-ui-guest-frame #2945 the possibility to import from '@neos-project/neos-ui-guest-frame' in a custom extension.

The Feature was merged with https://github.com/neos/neos-ui/releases/tag/7.2.0 and can be used in a custom extension with "@neos-project/neos-ui-extensibility": "^7.2". But that will work only work when the extension is used with a Neos.Ui host with at least version 7.2 but not older.

This package serves as a polyfill for previous Neos.Ui Version (back to 5.3).

Implementation

The implementation is rather hacky as we need to implement in the Host Ui what will later be implemented here: https://github.com/neos/neos-ui/blob/master/packages/neos-ui/src/apiExposureMap.js#L148

So we intercept what is exported via the consumer API and add the exports of the '@neos-project/neos-ui-guest-frame' package.

Of course, this makes use of global javascript objects and functions internally used by the consumer api, but unless the implementation doesn't change (what is unlikely) for the past targeted Neos.Ui versions (5.3, 7.0, 7.1) that polyfill will continue to work. If something were to be changed, the javascript will tell you with nice crafted messages in the console ;)

When Neos.Ui version greater or equal to 7.2 is installed, this package does nothing ^^ (no js will be loaded)

Replace this package

If you dont want to include the polyfill, because you know you have at least ui 7.2 installed, then you can do a simple composer replace a la: https://github.com/neos/flow-development-collection/blob/d559aca053fd64a3b2d8ed3e3c19942f61f3b9ee/composer.json#L40

About

polyfill to access the package `'@neos-project/neos-ui-guest-frame'` via the custom consumerApi.

Resources

License

Stars

Watchers

Forks

Packages

No packages published