{"id":14706,"library":"milkdrop-eel-parser","title":"Milkdrop EEL2 Parser","description":"The `milkdrop-eel-parser` library provides a parser for the Nullsoft/Cockos EEL2 (Expression Evaluation Library 2) scripting language, primarily used in the Milkdrop music visualizer. It is designed to convert EEL2 equations into JavaScript, enabling their use in modern web-based visualizers like Butterchurn. Currently at version `0.0.4`, this project is predominantly written in ClojureScript and compiles to a JavaScript bundle. Its development appears to be in maintenance mode, with no significant updates in the last 7-8 years. Key differentiators include its niche focus on EEL2 parsing and its integration into the broader Butterchurn ecosystem, allowing developers to bring legacy Milkdrop preset logic to the browser environment.","status":"maintenance","version":"0.0.4","language":"javascript","source_language":"en","source_url":"https://github.com/jberg/milkdrop-eel-parser","tags":["javascript"],"install":[{"cmd":"npm install milkdrop-eel-parser","lang":"bash","label":"npm"},{"cmd":"yarn add milkdrop-eel-parser","lang":"bash","label":"yarn"},{"cmd":"pnpm add milkdrop-eel-parser","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This library is a ClojureScript compilation output, exposing a global `MilkdropEELParser` object. It is not designed for modern ES module `import` syntax. Direct script inclusion is the intended method for browser environments.","symbol":"MilkdropEELParser","correct":"\n\n"},{"note":"Access `parseExpression` as a method on the global `MilkdropEELParser` object after the script has loaded. It handles parsing the EEL2 syntax into an intermediate representation.","wrong":"import { parseExpression } from 'milkdrop-eel-parser';","symbol":"parseExpression","correct":"const parsed = window.MilkdropEELParser.parseExpression('x + y');"},{"note":"Access `convertExpression` as a method on the global `MilkdropEELParser` object. This function takes an EEL2 expression and translates it into an equivalent JavaScript string for execution.","wrong":"const convertExpression = require('milkdrop-eel-parser').convertExpression;","symbol":"convertExpression","correct":"const converted = window.MilkdropEELParser.convertExpression('x + y');"}],"quickstart":{"code":"\n\n\n\n \n \n Milkdrop EEL Parser Quickstart\n\n\n
Milkdrop EEL2 Parser Example
\n
Original EEL2 Expression: 'x = x + 0.1;'
\n
Parsed Output (console):
\n
Converted JavaScript (console):
\n\n \n \n\n \n\n","lang":"javascript","description":"This quickstart demonstrates how to include the `milkdrop-eel-parser` in an HTML page via a `` tag is included in your HTML before any code attempts to access `window.MilkdropEELParser`.","cause":"The `milkdrop-eel-parser` library was not loaded via a script tag, or the script tag was placed incorrectly (e.g., after attempting to use the object).","error":"ReferenceError: MilkdropEELParser is not defined"},{"fix":"Always pass a valid EEL2 expression as a string to the parsing and conversion functions, e.g., `window.MilkdropEELParser.parseExpression('vol = 0.5;')`.","cause":"The `parseExpression` or `convertExpression` function was called without a string argument, or with a non-string argument.","error":"Error: Must pass an expression string to parseExpression."}],"ecosystem":"npm"}