⚡ maintenance update (dev dependencies, ci refact)

Author: jaandrle

.github/workflows/npm-publish.yml

@@ -6,10 +6,10 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
+    environment: default
     steps:
-      - uses: actions/checkout@9bb56186c3b09b4f86b1c65136769dd318469633 # v4.1.2
-      # Setup .npmrc file to publish to npm
-      - uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4.0.2
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1 
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
         with:
           node-version: '16.x'
           registry-url: 'https://registry.npmjs.org'

.npmrc

@@ -1,3 +1,2 @@
 //registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}
 registry=https://registry.npmjs.org/
-always-auth=true

README.md

@@ -25,7 +25,7 @@ pipe( $.xdg.temp, s.mkdir )("foo bar");
 Open ‘▸’ sections for quick overview and/or navigate to link(s) for more detailed
 information and documentation.
 
-<!-- #region --><details> <summary><a href="./docs/namespaces/s/README.md">s #shelljs</a> namespace <em>(unix shell-like commands in JavaScript)</em></summary>
+<!-- #region --><details> <summary><a href="./docs/nodejsscript/namespaces/s/README.md">s #shelljs</a> namespace <em>(unix shell-like commands in JavaScript)</em></summary>
 
 ```js
 s.ls().forEach(echo); // ShellArray
@@ -41,7 +41,7 @@ and some additional added by nodejsscript. Typically `s.cat`/`s.grep`/…,
 to run other than builtin commands use `s.run`/`s.runA`.
 
 These functions returns `ShellArray`/`ShellString`/`Promise<ShellString>`,
-these types are union types of `string[]`/`string` with [`ShellReturnValueNJS`](./docs/namespaces/s/interfaces/ShellReturnValueNJS.md).
+these types are union types of `string[]`/`string` with [`ShellReturnValueNJS`](./docs/nodejsscript/namespaces/s/interfaces/ShellReturnValueNJS.md).
 In simple terms, you can use it as `string[]`/`string`/`Promise<string>` or
 read the commad exit `code` and `stdout`/`stderr`. If it makes sence, you can
 pipe output to other shelljs commands. Special pipeing is `to`/`toEnd` for
@@ -53,9 +53,9 @@ s.echo("Hello World!").to("hello.txt");
 
 <!-- #endregion -->
 </details>
-<!-- #region --><details> <summary><a href="./docs/namespaces/$/README.md">$</a> (
-		<a href="./docs/namespaces/$/functions/api.md">$.api() #sade</a>,
-		<a href="./docs/namespaces/xdg/namespaces/xdg/README.md">$.xdg</a>,
+<!-- #region --><details> <summary><a href="./docs/nodejsscript/namespaces/$/README.md">$</a> (
+		<a href="./docs/nodejsscript/namespaces/$/functions/api.md">$.api() #sade</a>,
+		<a href="./docs/nodejsscript/namespaces/xdg/namespaces/xdg/README.md">$.xdg</a>,
 		…
 	)
 	namespace <em>(nodejsscript/cli related functions/variables)</em></summary>
@@ -93,11 +93,11 @@ $.api()
   (home, temp, config, … directory)
 - `$.stdin`: handles standard input when the script is run in shell pipe (can be
   helpful for `nodejsscript --eval`/`nodejsscript --print` bellow)
-- …for more see [related section in docs](./docs/namespaces/$/README.md)
+- …for more see [related section in docs](./docs/nodejsscript/namespaces/$/README.md)
 
 <!-- #endregion -->
 </details>
-<!-- #region --><details> <summary><a href="./docs/functions/echo.md">echo() #css-in-console</a> function/namespace</summary>
+<!-- #region --><details> <summary><a href="./docs/variables/echo.md">echo() #css-in-console</a> function/namespace</summary>
 
 ```js
 const css= echo.css`
@@ -293,9 +293,7 @@ You don’t need this hack if you use `nodejsscript` in your project locally.
 </details>
 
 ## Quick links/info
-- migration from *0.9.\**: see [API changes 0.9 → 1.0](https://github.com/jaandrle/nodejsscript/pull/32)
-- migration from *0.8.\**: see [API changes 0.8 → 0.9](https://github.com/jaandrle/nodejsscript/blob/e9c4d9d/README.md#api-changes-08--09)
-- [migration from `zx`](#migration-from-zx)
+- changelogs and migrations info: see [Release notes](https://github.com/jaandrle/nodejsscript/releases)
 - [**You (may) not need to use `nodejsscript`**](./examples/no-nodejsscript.md)
 - [Ideas (for new features)](https://github.com/jaandrle/nodejsscript/discussions/categories/ideas)
 - Examples: [examples folder](./examples) or [Show And Tell · Discussions](https://github.com/jaandrle/nodejsscript/discussions/categories/show-and-tell)

bs/README.md

@@ -1 +1,10 @@
-[jaandrle/bs: The simplest possible build system using executables](https://github.com/jaandrle/bs)
+# bs: Build system based on executables
+This project uses [jaandrle/bs: The simplest possible build system using executable/bash scripts](https://github.com/jaandrle/bs).
+
+## Available executables
+
+### bs/build.mjs
+This lints code an run all build tasks
+
+### bs/build/doc.mjs
+### bs/dev/lint.mjs

bs/build.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env -S npx nodejsscript
 /* jshint esversion: 11,-W097, -W040, module: true, node: true, expr: true, undef: true *//* global $ */
 $.configAssign({ fatal: true });
-import "./build:lint.mjs";
-import "./build:doc.mjs";
+import "./dev/lint.mjs";
+import "./build/doc.mjs";

bs/build:doc.mjs bs/build/doc.mjsbs/build:doc.mjs renamed to bs/build/doc.mjs

@@ -69,11 +69,12 @@ await section("Cleanup documentation...", ()=> {
 await section("Generating tldr pages...", async ()=> {
 	const path_tldr= "tldr.md";
 	// shelljs original
-	await fetch("https://github.com/shelljs/shelljs/raw/master/README.md")
+	await fetch("https://github.com/shelljs/shelljs/raw/main/README.md")
 		.then(res=> res.text())
 		.then(pipe(
 			md=> md.slice(md.indexOf("### "), md.indexOf("\n### ShellString(str)")),
 			pipe(
+				cutOut("cmd"),
 				cutOut("echo"),
 				cutOut("exec"),
 				cutOut("set"),

bs/build:lint.mjs bs/dev/lint.mjsbs/build:lint.mjs renamed to bs/dev/lint.mjs

@@ -4,9 +4,9 @@
 ## Public
 - [pipe](functions/pipe.md)
 - [fetch](functions/fetch.md)
-- [echo](functions/echo.md)
-- [$](namespaces/$/README.md)
-- [s](namespaces/s/README.md)
+- [echo](variables/echo.md)
+- [$](nodejsscript/namespaces/$/README.md)
+- [s](nodejsscript/namespaces/s/README.md)
 ## Internal
 
 ## Public Functions

docs/README.md

@@ -1,26 +1,26 @@
-[**nodejsscript**](../../../../README.md) • **Docs**
+[**nodejsscript**](../README.md)
 
 ***
 
-[nodejsscript](../../../../README.md) / [s](../../README.md) / child
+[nodejsscript](../README.md) / [s](../nodejsscript/namespaces/s/README.md) / child\_process
 
-# child
+# child\_process
 
-## Index
-
-### Namespaces
+## Namespaces
 
 - [exec](namespaces/exec/README.md)
 - [execFile](namespaces/execFile/README.md)
 
-### Classes
+## Classes
 
 - [ChildProcess](classes/ChildProcess.md)
 
-### Interfaces
+## Interfaces
 
+- [ChildProcessEventMap](interfaces/ChildProcessEventMap.md)
 - [ChildProcessWithoutNullStreams](interfaces/ChildProcessWithoutNullStreams.md)
 - [ChildProcessByStdio](interfaces/ChildProcessByStdio.md)
+- [Control](interfaces/Control.md)
 - [MessageOptions](interfaces/MessageOptions.md)
 - [MessagingOptions](interfaces/MessagingOptions.md)
 - [ProcessEnvOptions](interfaces/ProcessEnvOptions.md)
@@ -37,7 +37,7 @@
 - [ExecFileOptions](interfaces/ExecFileOptions.md)
 - [ExecFileOptionsWithStringEncoding](interfaces/ExecFileOptionsWithStringEncoding.md)
 - [ExecFileOptionsWithBufferEncoding](interfaces/ExecFileOptionsWithBufferEncoding.md)
-- [ExecFileOptionsWithOtherEncoding](interfaces/ExecFileOptionsWithOtherEncoding.md)
+- [~~ExecFileOptionsWithOtherEncoding~~](interfaces/ExecFileOptionsWithOtherEncoding.md)
 - [ForkOptions](interfaces/ForkOptions.md)
 - [SpawnSyncOptions](interfaces/SpawnSyncOptions.md)
 - [SpawnSyncOptionsWithStringEncoding](interfaces/SpawnSyncOptionsWithStringEncoding.md)
@@ -51,7 +51,7 @@
 - [ExecFileSyncOptionsWithStringEncoding](interfaces/ExecFileSyncOptionsWithStringEncoding.md)
 - [ExecFileSyncOptionsWithBufferEncoding](interfaces/ExecFileSyncOptionsWithBufferEncoding.md)
 
-### Type Aliases
+## Type Aliases
 
 - [Serializable](type-aliases/Serializable.md)
 - [SendHandle](type-aliases/SendHandle.md)
@@ -63,7 +63,7 @@
 - [StdioPipe](type-aliases/StdioPipe.md)
 - [ExecFileException](type-aliases/ExecFileException.md)
 
-### Functions
+## Functions
 
 - [spawn](functions/spawn.md)
 - [exec](functions/exec.md)