Node API

[mitra42]

• [x] What is needed in package.json for NPM
• [x] Make version number in Forth align
• [x] Think thru how to require etc, should it export one word "forth" and can functions have properties ?
• [ ] Edit README.md

[mitra42]

Possible node design .... In parent package:

require 'webforth'; // defines a "forth" global
require 'foo' // where foo is defined in package.json to be a .js file
forth.load('https://bar.com/foo.f') // Load a forth file. Relative to current URL (e.g. could be a file or HTTP etc)

In forth package something like

forth = { m, c, x, load } 
export forth

[mitra42]

Alternative API

const Forth = require('webforth'); // The class or obj with functions
Forth.load('foo.f'); // Load it into the class
const forth = new Forth({ CELLL: 3, xxxMemSize: 1000000}) // Parameterized instance 
forth.load('https://....'); // Load it into the instance
forth.interpret("1 2 DUP .S"); 
boo = forth.rot([1,2,3]);  // Returns [2,3,1] - will depend what can do with JS API
forth.console(); // Go interactive

[mitra42]

• [x] localize IP, SP, RP, UP
• [x] check how threadtoken will work with this may need this.call or something like that
  • [x] Adjust tokenfunction to results
  • [x] Rething tokenDoList etc
• [ ] Add "load" - see #34 (I/O from files)

[mitra42]

Actual API - for now - in sandbox/test_node_api.mjs

import Forth from '../index.js';
// Normally this would be: import Forth from 'webforth';

const CELLL=3
const MEM=8
const EM=0x2000 * CELLL; // default is 0x2000 * CELLL
const foo = new Forth({CELLL, EM, memClass: `${MEM}_${CELLL*8}`});
foo.compileForthInForth()
  .then(() => console.log('===forthInForth compiled'))
  //.then(() => foo.cleanupBootstrap()).then(() => console.log('===forthInForth cleaned up'))
  //.then(() => foo.interpret("WARM"));
  .then(() => foo.console()) // Interactive console
  .then(() => console.log('console exited'));

[mitra42]

This is done - check the README