cloudspin 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# cloudspin
 
-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.
+A terminal music player under a living sky: a spinning record, real weather,
+and a sky that changes with the song.
+
+This npm package is a small launcher. Cloudspin itself is a Python app, so the
+launcher runs it through whichever of these it finds: an installed `cloudspin`,
+[`uv`](https://docs.astral.sh/uv/), or [`pipx`](https://pipx.pypa.io/).
+
+```sh
+npx cloudspin --demo
+npm install -g cloudspin
+```
+
+You need `mpv` for sound. Full documentation:
+https://github.com/itsHarshDabas/Cloudspin

package/bin/cloudspin.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+// Cloudspin is a Python app. This launcher finds a way to run it and hands
+// over the terminal: an installed `cloudspin`, then uv, then pipx.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+
+const args = process.argv.slice(2);
+const self = require("node:fs").realpathSync(__filename);
+
+function onPath(command) {
+  const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["-a", command], { encoding: "utf8" });
+  if (probe.status !== 0) return [];
+  return probe.stdout.split(/\r?\n/).filter(Boolean);
+}
+
+function run(command, commandArgs) {
+  const result = spawnSync(command, commandArgs, { stdio: "inherit" });
+  if (result.error) return null;
+  return result.status === null ? 1 : result.status;
+}
+
+// An already installed Python cloudspin, skipping this launcher itself.
+const installed = onPath("cloudspin").find((candidate) => {
+  try {
+    return require("node:fs").realpathSync(candidate) !== self;
+  } catch {
+    return false;
+  }
+});
+
+const attempts = [];
+if (installed) attempts.push([installed, args]);
+if (onPath("uvx").length) attempts.push(["uvx", ["cloudspin", ...args]]);
+if (onPath("pipx").length) attempts.push(["pipx", ["run", "cloudspin", ...args]]);
+
+for (const [command, commandArgs] of attempts) {
+  const status = run(command, commandArgs);
+  if (status !== null) process.exit(status);
+}
+
+console.error(
+  [
+    "cloudspin needs Python to run, and no way to start it was found.",
+    "Install one of these, then try again:",
+    "  uv    https://docs.astral.sh/uv/   (then: uvx cloudspin)",
+    "  pipx  https://pipx.pypa.io/        (then: pipx install cloudspin)",
+  ].join("\n")
+);
+process.exit(1);

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "cloudspin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Launcher for Cloudspin, a terminal music player under a living sky. Runs the Python app through uv or pipx.",
+  "bin": {
+    "cloudspin": "bin/cloudspin.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsHarshDabas/Cloudspin.git"
+  },
+  "keywords": [
+    "tui",
+    "music",
+    "player",
+    "weather",
+    "terminal"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}