node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

bondage

bondage.js Build Status

Yarn parser for Javascript, in the same vein as YarnSpinner.

Usage

As a Web Tool

To run through your yarn files in your browser, go to http://hayley.zone/bondage.js, paste your yarn data in the field, then hit "compile".

As a Command Line Tool

Installation: npm install -g bondage

Now you can use the bondage command to run through Yarn files from the command line. You can load one or multiple files at a time. If you load multiple files and a two nodes are encountered with the same name, the node will be overwritten.

Examples

  • Running a single file from the default start node (named "Start"): bondage run yarnfile.json
  • Running a single file from the specified node name: bondage run -s StartNode yarnfile.json
  • Running multiple files from the specified node name: bondage run -s StartNode yarnfile1.json yarnfile2.json ...
  • See the compiled ast: bondage compile --ast yarnfile.json
  • See the tokenized input: bondage compile --tokens yarnfile.json

As a Library

Web

Include dist/bondage.min.js somewhere in your html, and the bondage variable will be added to the global scope. You can then access everything in the example below (such as bondage.Runner) through that variable.

Node

Installation: npm install bondage

const fs = require('fs');
const bondage = require('bondage');
 
const runner = new bondage.Runner();
const yarnData = JSON.parse(fs.readFileSync('yarnFile.json'));
 
runner.load(yarnData);
 
runner.setCommandHandler((command) => {
  // Called whenever there is a <<command>>, the parameter being the text inside
});
 
// Register a function to be called from the dialog
runner.registerFunction('isEven', (args) => {
  // Used as <<if isEven($var)>>It is even<<endif>>
  return args[0] % 2;
});
 
// Loop over the dialogue from the node titled 'Start'
for (const result of runner.run('Start')) {
  // Do something else with the result
  if (result instanceof bondage.TextResult) {
    console.log(result.text);
  } else if (result instanceof bondage.OptionsResult) {
    // This works for both links between nodes and shortcut options
    console.log(result.options);
 
    // Select based on the option's index in the array (if you don't select an option, the dialog will continue past them)
    result.select(1);
  }
}
 
// Advance the dialogue manually from the node titled 'Start'
const d = runner.run('Start')
let result = d.next().value;
let nextResult = d.next().value;
// And so on

For usage of the yarn format itself, please see the YarnSpinner Documentation, everything there should carry here too (if something does not match up, please open an issue).