gemshell 0.0.0-stage → 1.2.0

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# GemShell
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Package HTML5 games as desktop apps for Windows, macOS and Linux, and ship them to Steam, itch.io and GitHub, from a terminal or a CI pipeline.
+
+```bash
+npm install -g gemshell
+gemshell new mygame
+cd mygame
+gemshell build
+```
+
+Or without installing anything: `npx gemshell build`.
+
+A game you already have is set up with `gemshell init`. `gemshell help` lists every command, and `gemshell help <command>` explains one.
+
+Everything else is in the docs: **https://gemshell.dev/guide/command-line**
+
+Deploying, mobile builds and plugins are GemShell Pro: **https://l0om.itch.io/gemshell**

package/bin/gemshell.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// The gemshell command, from npm.
+//
+// GemShell is one native program per system. npm installs only the package
+// that fits this machine, through optionalDependencies that each name an os
+// and a cpu, and this starts the program out of it with everything passed
+// through: the arguments, the terminal, the exit code.
+'use strict';
+
+const { spawn } = require('child_process');
+
+const pkg = `@gemshell/${process.platform}-${process.arch}`;
+const exe = process.platform === 'win32' ? 'gemshell.exe' : 'gemshell';
+
+let bin;
+try {
+  bin = require.resolve(`${pkg}/bin/${exe}`);
+} catch {
+  const known = ['darwin-arm64', 'darwin-x64', 'win32-x64', 'linux-x64', 'linux-arm64'];
+  if (known.includes(`${process.platform}-${process.arch}`)) {
+    console.error(`gemshell: ${pkg} is missing, which happens when optional packages are ` +
+      `left out. Install again without --no-optional or --omit=optional.`);
+  } else {
+    console.error(`gemshell: there is no GemShell for ${process.platform} ${process.arch}. ` +
+      `It runs on macOS, Windows x64 and Linux x64 and arm64.`);
+  }
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+// Ctrl-C reaches GemShell itself, which stops a build or a deploy cleanly;
+// this waits for it rather than leaving it running behind the prompt.
+for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+  process.on(sig, () => {});
+}
+child.on('error', (err) => {
+  console.error(`gemshell: ${err.message}`);
+  process.exit(1);
+});
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "gemshell",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Package HTML5 games as desktop apps for Windows, macOS and Linux, and ship them to Steam, itch.io and GitHub.",
+  "homepage": "https://gemshell.dev/guide/command-line",
+  "license": "UNLICENSED",
+  "keywords": [
+    "html5",
+    "game",
+    "electron",
+    "steam",
+    "itch.io",
+    "desktop",
+    "packager",
+    "cli"
+  ],
+  "bin": {
+    "gemshell": "bin/gemshell.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "optionalDependencies": {
+    "@gemshell/darwin-arm64": "1.2.0",
+    "@gemshell/darwin-x64": "1.2.0",
+    "@gemshell/win32-x64": "1.2.0",
+    "@gemshell/linux-x64": "1.2.0",
+    "@gemshell/linux-arm64": "1.2.0"
+  }
+}