@slugbugblue/trax-tty 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @slugbugblue/trax-tty
 
+## 1.3.0 - 2026-02-22
+
+- Update Trax Engine to v1.1
+- Allow special character override via environment variables
+
 ## 1.2.0 - 2025-11-07
 
 - Update Trax Engine to v1.0

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright © 2021-2023 Chad Transtrum
+   Copyright © 2021-2026 Chad Transtrum
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -14,4 +14,24 @@ const players = ['first player', 'player 2']
 tty.display(game, players)
 ```
 
+## Environment variables
+
+The tty display can use fancy characters to separate the player names and moves,
+and tries to determine characters automatically from the environment.
+
+It prefers a rounded bubble look, using characters available from the
+[nerdfonts][nerdfonts] collection, and will default to that if it detects either
+`NERDFONT` or `NERDFONTS` set in the environment.
+
+If that is not found, it will next choose an angled look using characters from
+[powerline][powerline], and will default to that if it detects any of
+`POWERLINE`, `P9K_TTY`, or `P9K_SSH` set in the environment.
+
+Lacking either of those, it will then choose a block look using characters
+available in all terminals.
+
+However, if you want to override any of these defaults, you can choose to set
+`TRAX_TTY_LEFT` and `TRAX_TTY_RIGHT` to set the left and right characters. To
+completely disable the fancy printouts, set `TRAX_TTY_PLAIN=true`.
+
 See the [source](tty.js) for more details.

package/RELEASE.v1.3.0.md

@@ -0,0 +1,5 @@
+## 1.3.0 - 2026-02-22
+
+- Update Trax Engine to v1.1
+- Allow special character override via environment variables
+

package/gl-sast-report.json

@@ -0,0 +1 @@
+{"version":"15.2.2","vulnerabilities":[],"scan":{"analyzer":{"id":"semgrep","name":"Semgrep","url":"https://gitlab.com/gitlab-org/security-products/analyzers/semgrep","vendor":{"name":"GitLab"},"version":"6.15.0"},"scanner":{"id":"semgrep","name":"Semgrep","url":"https://github.com/returntocorp/semgrep","vendor":{"name":"GitLab"},"version":"1.127.0"},"type":"sast","start_time":"2026-02-23T01:20:46","end_time":"2026-02-23T01:20:58","status":"success","observability":{"events":[{"event":"collect_sast_scan_metrics_from_pipeline","property":"7dbad01a-500b-462c-ad2c-e4f802a3eb7f","label":"semgrep","value":0,"version":"6.15.0","exit_code":0,"override_count":0,"passthrough_count":0,"custom_exclude_path_count":0,"time_s":11,"file_count":3}]}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slugbugblue/trax-tty",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Simple tty graphics for displaying trax games",
   "keywords": [
     "trax",
@@ -13,11 +13,15 @@
   "exports": {
     ".": "./tty.js"
   },
-  "repository": "gitlab:slugbugblue/trax-tty",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/slugbugblue/trax-tty.git"
+  },
   "scripts": {
     "genversion": "genversion --esm version.js",
     "git-add": "git add version.js",
     "test": "xo",
+    "prepare": "[ -n \"$CI\" ] || husky",
     "preversion": "npm test",
     "version": "npm run genversion ; npm run git-add",
     "postversion": "git push && git push --tags && npm publish"

package/tty.js

@@ -1,16 +1,7 @@
-/* Copyright 2021-2022 Chad Transtrum
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+/** Trax tty display.
+ * @copyright 2021-2026
+ * @author Chad Transtrum <chad@transtrum.net>
+ * @license Apache-2.0
  */
 
 // Ever wanted to draw Trax boards on the console? I have.
@@ -22,11 +13,19 @@ export { version } from './version.js'
 
 const esc = '\u001B[' // Start of console color escape code
 const off = esc + 'm' // Color reset code
+
+// Set up the bubble characters automatically, with override of
+// TRAX_TTY_LEFT, TRAX_TTY_RIGHT, or set TRAX_TTY_PLAIN=true to disable
 const ENV = process.env
-const NERD = ENV.NERDFONT || ENV.NERDFONTS
-const POWER = ENV.POWERLINE || ENV.P9K_TTY || ENV.P9K_SSH
-const leftBubble = NERD ? '' : POWER ? '' : '▐'
-const rightBubble = NERD ? '' : POWER ? '' : '▌'
+const NERDVAR = ENV.NERDFONT || ENV.NERDFONTS
+const NERD = NERDVAR && NERDVAR !== '0' && NERDVAR.toLowerCase() !== 'false'
+const POWERVAR = ENV.POWERLINE || ENV.P9K_TTY || ENV.P9K_SSH
+const POWER = POWERVAR && POWERVAR !== '0' && POWERVAR.toLowerCase() !== 'false'
+const PLAIN = (ENV.TRAX_TTY_PLAIN || '').toLowerCase() === 'true'
+const LEFT = ENV.TRAX_TTY_LEFT || (NERD ? '' : POWER ? '' : '▐')
+const RIGHT = ENV.TRAX_TTY_RIGHT || (NERD ? '' : POWER ? '' : '▌')
+const leftBubble = PLAIN ? '' : LEFT
+const rightBubble = PLAIN ? '' : RIGHT
 
 /** Colorize a string.
  * @arg {string} contents

package/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '1.2.0'
+export const version = '1.3.0'