mirror of
https://codeberg.org/uzu/strudel
synced 2026-08-14 17:27:14 -04:00
Felix Roos
47 lines
1.2 KiB
Markdown
47 lines
1.2 KiB
Markdown
# @strudel/transpiler
|
|
|
|
This package contains a JS code transpiler with a plugin system that can be used to transform the code.
|
|
|
|
A plugin can be registered via a `registerTranspilerPlugin` call :
|
|
|
|
```js
|
|
registerTranspilerPlugin({
|
|
walk: (context) => ({
|
|
enter: function(node, parent, prop, index) {},
|
|
leave: function(node, parent, prop, index) {}
|
|
})
|
|
})
|
|
```
|
|
|
|
where the enter/leave functions (both optional) follow the `estree-walker` walk API.
|
|
|
|
4 plugins are currently hosted inside `@strudel/transpiler`
|
|
|
|
- mini: add locations of mini notation strings (double quoted or backticked) for highlighting
|
|
- widgets: add handling of sliders & draw widgets
|
|
- sample: make it possible to call a sample without await
|
|
- kabelsalat: transform the code to handle the `K(..)` kabelsalat notation
|
|
|
|
it also
|
|
|
|
- adds return statement to the last expression
|
|
- handles label capturing for block-based eval
|
|
|
|
## Install
|
|
|
|
```sh
|
|
npm i @strudel/transpiler
|
|
```
|
|
|
|
## Use
|
|
|
|
```js
|
|
import { transpiler } from '@strudel/core';
|
|
import { evaluate } from '@strudel/core';
|
|
|
|
transpiler('note("c3 [e3,g3]")', { wrapAsync: false, addReturn: false, simpleLocs: true });
|
|
/* mini('c3 [e3,g3]').withMiniLocation(7,17) */
|
|
|
|
evaluate(note('c3 [e3,g3]'), transpiler); // returns pattern of above code
|
|
```
|