gemshell 0.0.0-stage → 1.2.1

package/LICENSE.md

@@ -0,0 +1,44 @@
+# GemShell License
+
+Copyright (c) 2026 Edgar Metzler. All rights reserved.
+
+GemShell is proprietary software. It is not open source. By installing or
+using it you agree to these terms.
+
+## 1. Using GemShell
+
+You may download, install and use GemShell free of charge, including to make
+and sell commercial games, with the features of GemShell Lite.
+
+## 2. GemShell Pro
+
+The features of GemShell Pro are unlocked by a purchase at
+https://l0om.itch.io/gemshell. A purchase is a licence for the person who
+bought it, to use on their own computers. It may not be shared, lent, resold
+or transferred.
+
+## 3. Your games
+
+The games you build with GemShell are yours, and you may distribute and sell
+them. The parts of GemShell that a build puts into a game may be distributed
+only as part of that game.
+
+## 4. What you may not do
+
+Except where the law allows it regardless of these terms, you may not:
+
+- decompile, disassemble or otherwise reverse engineer GemShell;
+- remove, disable or get around its licence checks;
+- copy GemShell's code into other software;
+- distribute GemShell itself, other than through the channels it is
+  published on.
+
+## 5. No warranty
+
+GemShell is provided as it is, without warranty of any kind. To the extent
+the law allows, the author is not liable for any damage arising from its use.
+
+## 6. End
+
+These terms end automatically if you break them. You then have to stop using
+GemShell and remove it.

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.1",
+  "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": "SEE LICENSE IN LICENSE.md",
+  "keywords": [
+    "html5",
+    "game",
+    "electron",
+    "steam",
+    "itch.io",
+    "desktop",
+    "packager",
+    "cli"
+  ],
+  "bin": {
+    "gemshell": "bin/gemshell.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "optionalDependencies": {
+    "@gemshell/darwin-arm64": "1.2.1",
+    "@gemshell/darwin-x64": "1.2.1",
+    "@gemshell/win32-x64": "1.2.1",
+    "@gemshell/linux-x64": "1.2.1",
+    "@gemshell/linux-arm64": "1.2.1"
+  }
+}