jssm 5.76.0 → 5.77.1

package/jssm.d.ts

@@ -665,7 +665,7 @@ declare class Machine<mDT> {
     set history_length(to: number);
     /********
      *
-     *  Instruct the machine to complete an action.
+     *  Instruct the machine to complete an action.  Synonym for {@link do}.
      *
      *  ```typescript
      *  const light = sm`red 'next' -> green 'next' -> yellow 'next' -> red; [red yellow green] 'shutdown' ~> off 'start' -> red;`;
@@ -685,7 +685,27 @@ declare class Machine<mDT> {
     action(actionName: StateType, newData?: mDT): boolean;
     /********
      *
-     *  Instruct the machine to complete a transition.
+     *  Instruct the machine to complete an action.  Synonym for {@link action}.
+     *
+     *  ```typescript
+     *  const light = sm`red 'next' -> green 'next' -> yellow 'next' -> red; [red yellow green] 'shutdown' ~> off 'start' -> red;`;
+     *
+     *  light.state();           // 'red'
+     *  light.do('next');        // true
+     *  light.state();           // 'green'
+     *  ```
+     *
+     *  @typeparam mDT The type of the machine data member; usually omitted
+     *
+     *  @param actionName The action to engage
+     *
+     *  @param newData The data change to insert during the action
+     *
+     */
+    do(actionName: StateType, newData?: mDT): boolean;
+    /********
+     *
+     *  Instruct the machine to complete a transition.  Synonym for {@link go}.
      *
      *  ```typescript
      *  const light = sm`red -> green -> yellow -> red; [red yellow green] 'shutdown' ~> off 'start' -> red;`;
@@ -703,6 +723,26 @@ declare class Machine<mDT> {
      *
      */
     transition(newState: StateType, newData?: mDT): boolean;
+    /********
+     *
+     *  Instruct the machine to complete a transition.  Synonym for {@link transition}.
+     *
+     *  ```typescript
+     *  const light = sm`red -> green -> yellow -> red; [red yellow green] 'shutdown' ~> off 'start' -> red;`;
+     *
+     *  light.state();       // 'red'
+     *  light.go('green');   // true
+     *  light.state();       // 'green'
+     *  ```
+     *
+     *  @typeparam mDT The type of the machine data member; usually omitted
+     *
+     *  @param newState The state to switch to
+     *
+     *  @param newData The data change to insert during the transition
+     *
+     */
+    go(newState: StateType, newData?: mDT): boolean;
     /********
      *
      *  Instruct the machine to complete a forced transition (which will reject if

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jssm",
-  "version": "5.76.0",
+  "version": "5.77.1",
   "engines": {
     "node": ">=10.0.0"
   },
@@ -108,7 +108,7 @@
     "@typescript-eslint/eslint-plugin": "^5.30.4",
     "@typescript-eslint/parser": "^5.30.4",
     "benny": "^3.7.1",
-    "cloc": "^2.9.0",
+    "cloc": "^2.10.0",
     "coveralls": "^3.0.11",
     "eslint": "^7.32.0",
     "eslint-plugin-fp": "^2.3.0",

package/rollup.config.deno.js

@@ -0,0 +1,45 @@
+
+import nodeResolve from '@rollup/plugin-node-resolve';
+import commonjs    from '@rollup/plugin-commonjs';
+import replace     from '@rollup/plugin-replace';
+
+const pkg = require('./package.json');
+
+
+
+
+const config = {
+
+  input: 'dist/es6/jssm.js',
+
+  output: {
+    file   : 'dist/deno/jssm.deno-esm.js',
+    format : 'esm',
+    name   : 'jssm'
+  },
+
+  plugins : [
+
+    nodeResolve({
+      mainFields     : ['module', 'main'],
+      browser        : true,
+      extensions     : [ '.js', '.json', '.ts', '.tsx' ],
+      preferBuiltins : false
+    }),
+
+    commonjs(),
+
+    replace({
+      preventAssignment      : true,
+      'process.env.NODE_ENV' : JSON.stringify( 'production' )
+    })
+
+  ]
+
+};
+
+
+
+
+
+export default config;

package/typedoc-options.js

@@ -27,7 +27,7 @@ module.exports = {
             { title: 'Node',        source: 'todo.md' },
             { title: 'Typescript',  source: 'todo.md' },
             { title: 'The browser', source: 'todo.md' },
-            { title: 'Deno',        source: 'todo.md' },
+//          { title: 'Deno',        source: 'todo.md' },
             { title: 'AWS Lambda',  source: 'todo.md' },
             { title: 'SQL',         source: 'todo.md' },
           ] },