jssm 5.104.2 → 5.112.3

package/log-progress.data.json

@@ -0,0 +1,28 @@
+{
+  "projectTitle": "jssm Progress Log",
+  "titleUrl": "https://stonecypher.github.io/jssm/",
+  "weeks": [
+    {
+      "sundayDate": "2026-05-10",
+      "label": "Week of May 10, 2026",
+      "entries": [
+        {
+          "title": "Tougher tests",
+          "body": "Began a serious upgrade in how the parser is tested: it now faces hundreds of randomly generated inputs per run, hunting for edge cases that fixed tests can never reach. This approach has already turned up real bugs that earlier coverage missed, and it lays the groundwork for an even more aggressive testing tier planned next."
+        },
+        {
+          "title": "Diagram polish",
+          "body": "State diagrams now adapt automatically to light and dark themes, classify each kind of state more accurately, and render noticeably faster. The result is sharper, more readable visuals out of the box with no extra configuration on the user's part."
+        },
+        {
+          "title": "Pattern cookbook",
+          "body": "Published an online cookbook of state-machine patterns and recipes that users can browse, learn from, and copy directly into their projects. This makes the library substantially easier to adopt for newcomers who would otherwise face a blank page."
+        },
+        {
+          "title": "Hardened releases",
+          "body": "Modernized how the project publishes new versions so the process no longer relies on stored credentials that could be stolen or misused. Releases are now verified cryptographically at the source, reducing tampering risk and bringing the project in line with current industry security practices."
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,23 +1,39 @@
 {
   "name": "jssm",
-  "version": "5.104.2",
+  "version": "5.112.3",
   "engines": {
     "node": ">=10.0.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
-    "require": {
-      "types": "./jssm.es5.d.cts",
-      "default": "./dist/jssm.es5.cjs"
-    },
-    "import": {
-      "types": "./jssm.es6.d.ts",
-      "default": "./dist/jssm.es6.mjs"
+    ".": {
+      "require": {
+        "types": "./jssm.es5.d.cts",
+        "default": "./dist/jssm.es5.cjs"
+      },
+      "import": {
+        "types": "./jssm.es6.d.ts",
+        "default": "./dist/jssm.es6.mjs"
+      },
+      "default": {
+        "types": "./jssm.es5.d.cts",
+        "default": "./dist/jssm.es5.cjs"
+      },
+      "browser": "./dist/jssm.es5.iife.js"
     },
-    "default": {
-      "types": "./jssm.es5.d.cts",
-      "default": "./dist/jssm.es5.cjs"
-    },
-    "browser": "dist/jssm.es5.iife.cjs"
+    "./viz": {
+      "require": {
+        "types": "./jssm_viz.es5.d.cts",
+        "default": "./dist/jssm_viz.cjs"
+      },
+      "import": {
+        "types": "./jssm_viz.es6.d.ts",
+        "default": "./dist/jssm_viz.mjs"
+      },
+      "browser": "./dist/jssm_viz.iife.cjs"
+    }
   },
   "autoupdate": {
     "source": "git",
@@ -35,8 +51,8 @@
   "description": "A Javascript finite state machine (FSM) with a terse DSL and a simple API.  Most FSMs are one-liners.  Fast, easy, powerful, well tested, typed with TypeScript, and visualizations. MIT License.",
   "main": "dist/jssm.es5.cjs",
   "module": "dist/jssm.es6.js",
-  "browser": "dist/jssm.es5.iife.cjs",
-  "types": "./jssm.d.ts",
+  "browser": "dist/jssm.es5.iife.js",
+  "types": "./jssm.es5.d.cts",
   "scripts": {
     "jest-unicode-action": "jest unicode-actions.uspec.ts -c jest-unicode.config.cjs --color --verbose",
     "jest-unicode-string": "jest unicode-strings.uspec.ts -c jest-unicode.config.cjs --color --verbose",
@@ -49,30 +65,39 @@
     "jest-spec": "jest -c jest-spec.config.cjs --color --verbose",
     "jest": "npm run jest-stoch && npm run jest-spec",
     "test": "npm run make && npm run jest",
-    "clean": "rm -rf dist && rm -rf docs && cd coverage && rm -rf cloc && cd .. && rm -f src/ts/fsl_parser.ts && rm -f src/ts/version.ts && rm -f *.d.ts && mkdir dist && mkdir docs && cd coverage && mkdir cloc && cd .. && rm -f ./src/tools/jssm.es5.iife.nonmin.cjs",
+    "clean": "rm -rf dist && rm -rf docs && cd coverage && rm -rf cloc && cd .. && rm -f src/ts/fsl_parser.ts && rm -f src/ts/version.ts && rm -f *.d.ts && mkdir dist && mkdir docs && cd coverage && mkdir cloc && cd .. && rm -f ./src/tools/jssm.es5.iife.nonmin.js",
     "peg": "rm -f src/ts/fsl_parser.js && pegjs src/ts/fsl_parser.peg && node src/buildjs/fixparser.cjs",
     "make_cjs": "rollup -c rollup.config.es5.js",
     "make_es6": "rollup -c rollup.config.es6.js",
     "make_iife": "rollup -c rollup.config.iife.js",
     "make_deno": "rollup -c rollup.config.deno.js && cp dist/es6/*.d.ts dist/deno",
-    "typescript": "tsc --build tsconfig.json && cp dist/es6/*.d.ts .",
+    "make_viz_cjs": "rollup -c rollup.config.viz.es5.js",
+    "make_viz_es6": "rollup -c rollup.config.viz.es6.js",
+    "make_viz_iife": "rollup -c rollup.config.viz.iife.js",
+    "typescript": "tsc --build tsconfig.json",
     "makever": "node src/buildjs/makever.cjs",
-    "make": "npm run clean && npm run makever && npm run peg && npm run typescript && npm run make_iife && npm run make_es6 && npm run make_deno && npm run make_cjs && npm run minify && npm run min_iife && npm run min_es6 && npm run min_cjs && npm run min_deno && rm ./dist/es6/*.nonmin.js",
+    "make": "npm run clean && npm run makever && npm run peg && npm run typescript && npm run make_iife && npm run make_es6 && npm run make_deno && npm run make_cjs && npm run make_viz_iife && npm run make_viz_es6 && npm run make_viz_cjs && npm run minify && npm run min_iife && npm run min_es6 && npm run min_cjs && npm run min_deno && npm run min_viz_iife && npm run min_viz_es6 && npm run min_viz_cjs && rm ./dist/es6/*.nonmin.js",
     "eslint": "eslint --color src/ts/jssm.ts src/ts/jssm_types.ts src/ts/tests/*.ts",
     "audit": "text_audit -r -t major MAJOR wasteful WASTEFUL any mixed fixme FIXME checkme CHECKME testme TESTME stochable STOCHABLE todo TODO comeback COMEBACK whargarbl WHARGARBL -g ./src/ts/**/*.{js,ts}",
     "vet": "npm run eslint && npm run audit",
     "benny": "node ./src/buildjs/benchmark.cjs",
-    "build": "npm run vet && npm run test && npm run site && npm run changelog && npm run docs && npm run cloc && npm run readme",
+    "ci_profile": "node ./src/buildjs/ci_profile.cjs",
+    "build": "npm run vet && npm run test && npm run site && npm run make_cookbook && npm run site_fsl_tools && npm run changelog && npm run docs && npm run cloc && npm run readme",
     "clean_bench": "npm run test && npm run benny",
     "qbuild": "npm run test",
     "ci_build": "npm run vet && npm run test",
     "minify": "mv dist/es6/fsl_parser.js dist/es6/fsl_parser.nonmin.js && terser dist/es6/fsl_parser.nonmin.js > dist/es6/fsl_parser.js",
-    "min_iife": "mv dist/jssm.es5.iife.js dist/jssm.es5.iife.nonmin.cjs && terser dist/jssm.es5.iife.nonmin.cjs > dist/jssm.es5.iife.cjs && cp dist/jssm.es5.iife.nonmin.cjs ./src/tools/",
+    "min_iife": "mv dist/jssm.es5.iife.js dist/jssm.es5.iife.nonmin.js && terser dist/jssm.es5.iife.nonmin.js > dist/jssm.es5.iife.js && cp dist/jssm.es5.iife.nonmin.js ./src/tools/",
     "min_cjs": "mv dist/jssm.es5.cjs.js dist/jssm.es5.nonmin.cjs && terser dist/jssm.es5.nonmin.cjs > dist/jssm.es5.cjs",
     "min_es6": "mv dist/jssm.es6.js dist/jssm.es6.nonmin.cjs && terser dist/jssm.es6.nonmin.cjs > dist/jssm.es6.mjs",
     "min_deno": "terser dist/deno/jssm.deno-esm.nonmin.js > dist/deno/jssm.js",
-    "site": "cp src/site/* docs/ && cp -r src/assets docs/assets/",
-    "docs": "typedoc src/ts/jssm.ts src/ts/jssm_types.ts src/ts/jssm_constants.ts src/ts/jssm_error.ts src/ts/jssm_util.ts src/ts/version.ts --options typedoc-options.cjs",
+    "min_viz_iife": "mv dist/jssm_viz.es5.iife.js dist/jssm_viz.es5.iife.nonmin.cjs && terser dist/jssm_viz.es5.iife.nonmin.cjs > dist/jssm_viz.iife.cjs",
+    "min_viz_cjs": "mv dist/jssm_viz.es5.cjs.js dist/jssm_viz.es5.nonmin.cjs && terser dist/jssm_viz.es5.nonmin.cjs > dist/jssm_viz.cjs",
+    "min_viz_es6": "mv dist/jssm_viz.es6.js dist/jssm_viz.es6.nonmin.cjs && terser dist/jssm_viz.es6.nonmin.cjs > dist/jssm_viz.mjs",
+    "site": "cp src/site/* docs/ && cp -r src/assets docs/assets/ && cp -r src/demo docs/ && cp dist/jssm.es5.iife.js docs/demo",
+    "make_cookbook": "node src/fsl.tools/site/scripts/build.cjs",
+    "site_fsl_tools": "cd docs && mkdir fsl.tools && cd .. && cp -r src/fsl.tools/site/* docs/fsl.tools/ && rm -rf docs/fsl.tools/recipes docs/fsl.tools/scripts",
+    "docs": "typedoc src/ts/jssm.ts src/ts/jssm_viz.ts src/ts/jssm_types.ts src/ts/jssm_constants.ts src/ts/jssm_error.ts src/ts/jssm_util.ts src/ts/version.ts --options typedoc-options.cjs",
     "cloc": "cloc --quiet ./src/** --exclude-list-file=./.clocignore --3 --json --out=./coverage/cloc/report_wt.json && cloc --quiet ./src/** --exclude-list-file=./.clocignore --exclude-dir=tests --3 --json --out=./coverage/cloc/report_nt.json && node ./src/buildjs/cloc_report.cjs",
     "readme": "rm -f ./README.md && node ./src/buildjs/make_readme.cjs && cp README.md dist/deno",
     "changelog": "rm -f CHANGELOG.md && rm -f ./src/doc_md/CHANGELOG.md && better_git_changelog -b && cp CHANGELOG.* ./src/doc_md/"
@@ -124,10 +149,14 @@
     "@rollup/plugin-commonjs": "^28.0.1",
     "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-replace": "^6.0.1",
+    "@swc/core": "^1.15.33",
+    "@swc/jest": "^0.2.39",
     "@types/chalk": "^2.2.0",
     "@types/jest": "^29.5.12",
+    "@types/jsdom": "^21.1.7",
     "@typescript-eslint/eslint-plugin": "^5.30.4",
     "@typescript-eslint/parser": "^5.30.4",
+    "@viz-js/viz": "^3.26.0",
     "benny": "^3.7.1",
     "cloc": "^2.10.0",
     "eslint": "^7.32.0",
@@ -139,7 +168,9 @@
     "fast-check": "^2.12.0",
     "glob": "^7.1.6",
     "jest": "^29.7.0",
+    "jest-environment-jsdom": "^30.3.0",
     "jest-json-reporter2": "^1.1.0",
+    "jsdom": "^24.1.0",
     "pegjs": "^0.10.0",
     "picocolors": "^1.0.0",
     "rollup": "^4.24.0",
@@ -147,7 +178,6 @@
     "semver": "^7.5.4",
     "terser": "^5.14.2",
     "text_audit": "^0.9.3",
-    "ts-jest": "^29.1.5",
     "twitter-api-client": "^1.6.0",
     "typedoc": "^0.22.18",
     "typedoc-plugin-missing-exports": "^0.23.0",
@@ -158,5 +188,8 @@
     "better_git_changelog": "^1.6.1",
     "circular_buffer_js": "^1.10.0",
     "reduce-to-639-1": "^1.1.0"
+  },
+  "optionalDependencies": {
+    "@viz-js/viz": "^3.26.0"
   }
 }

package/rollup.config.viz.es5.js

@@ -0,0 +1,46 @@
+
+import nodeResolve from '@rollup/plugin-node-resolve';
+import commonjs    from '@rollup/plugin-commonjs';
+import replace     from '@rollup/plugin-replace';
+import dts         from "rollup-plugin-dts";
+
+
+const config = [{
+
+  input: 'dist/es6/jssm_viz.js',
+
+  output: {
+    file   : 'dist/jssm_viz.es5.cjs.js',
+    format : 'cjs',
+    name   : 'jssm_viz'
+  },
+
+  external : ['@viz-js/viz'],
+
+  plugins : [
+    nodeResolve({
+      mainFields     : ['module', 'main'],
+      browser        : false,
+      extensions     : ['.js', '.json', '.ts', '.tsx'],
+      preferBuiltins : false
+    }),
+    commonjs(),
+    replace({
+      preventAssignment      : true,
+      'process.env.NODE_ENV' : JSON.stringify('production')
+    })
+  ]
+}, {
+
+  input: 'dist/es6/jssm_viz.d.ts',
+
+  output: {
+    file   : './jssm_viz.es5.d.cts',
+    format : 'es'
+  },
+
+  plugins : [dts()]
+}];
+
+
+export default config;

package/rollup.config.viz.es6.js

@@ -0,0 +1,46 @@
+
+import nodeResolve from '@rollup/plugin-node-resolve';
+import commonjs    from '@rollup/plugin-commonjs';
+import replace     from '@rollup/plugin-replace';
+import dts         from "rollup-plugin-dts";
+
+
+const config = [{
+
+  input: 'dist/es6/jssm_viz.js',
+
+  output: {
+    file   : 'dist/jssm_viz.es6.js',
+    format : 'es',
+    name   : 'jssm_viz'
+  },
+
+  external : ['@viz-js/viz'],
+
+  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')
+    })
+  ]
+}, {
+
+  input: 'dist/es6/jssm_viz.d.ts',
+
+  output: {
+    file   : './jssm_viz.es6.d.ts',
+    format : 'es'
+  },
+
+  plugins : [dts()]
+}];
+
+
+export default config;

package/rollup.config.viz.iife.js

@@ -0,0 +1,36 @@
+
+import nodeResolve from '@rollup/plugin-node-resolve';
+import commonjs    from '@rollup/plugin-commonjs';
+import replace     from '@rollup/plugin-replace';
+
+
+const config = [{
+
+  input: 'dist/es6/jssm_viz.js',
+
+  output: {
+    file                : 'dist/jssm_viz.es5.iife.js',
+    format              : 'iife',
+    name                : 'jssm_viz',
+    inlineDynamicImports: false
+  },
+
+  external : ['@viz-js/viz'],
+
+  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.cjs

@@ -47,9 +47,10 @@ module.exports = {
         ] },
       ] },
       { title: 'Tools', childrenDir: './', children: [
-        { title: 'Live Editor',   source: 'live_editor.md' },
-        { title: 'Github Action', source: 'todo.md' },
-        { title: 'CLI',           source: 'todo.md' },
+        { title: 'Live Editor',    source: 'live_editor.md' },
+        { title: 'Visualization',  source: 'Visualization.md' },
+        { title: 'Github Action',  source: 'todo.md' },
+        { title: 'CLI',            source: 'todo.md' },
       ] },
       { title: 'VIRTUAL', childrenDir: './', children: [
         { title: 'Community', source: 'community.md' }