The Twig engine for Pattern Lab / Node
npm install @pattern-lab/engine-twigTo install the Twig engine in your edition, npm install @pattern-lab/engine-twig should do the trick. This pattern engine uses the twing library.
Level of support for Twig constructs is on the level that the twing library supports. The following partial resolution schemes (includes, extends, import) are supported:
* relative file paths: standard by twing libary
* namespaces: standard by twing library, engine-twig only passes the configuration from patternlab-config.json
* Patternlab pattern names: integration between Patternlab and twing implemented by a custom loader
Now that this engine uses a better Twig Javascript library, the following issues are resolved:
* Pattern Lab does not support twig extends
* Verify maturity of Twig engine
See https://github.com/pattern-lab/the-spec/issues/37 for more info.
Create a JS file in Pattern Lab root directory (e.g. twingExtensions.js) and set
``javascript`
"engine": {
"twig": {
"loadExtensionFile": "twingExtensions.js"
}
}patternlab-config.json
in . See Editing the Configuration Options for more info.
- this JS file must export a Map for TwingEnvironment.addExtensions(extensions: Map
- Map will be added to the TwingEnvironment on startup
`javascript
// twingExtensions.js
const { TwingExtension, TwingFunction } = require('twing');
const extensionsMap = new Map();
class TestTwingExtension extends TwingExtension {
getFunctions() {
return [
new TwingFunction('foobar', function (foo) {
return Promise.resolve(function foobar called with param "${foo}");
}),
];
}
}
extensionsMap.set('TestTwingExtension', new TestTwingExtension());
module.exports = extensionsMap;
``
See https://nightlycommit.github.io/twing/advanced.html#creating-an-extension for more details on how to create extensions