html360-gen 2.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 html360
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# html360-gen
+
+**Standalone, zero-dependency binaries** for the original [Pannellum](https://github.com/mpetroff/pannellum/blob/a5e2f25d960270b6cdd6136d2c18c21f745bba0e/utils/multires/generate.py) multiresolution generator.
+
+## Overview
+
+The original Pannellum processing script `generate.py` is powerful but requires a Python environment with `Pillow` and depends on `nona` (from Hugin). 
+
+This project provides a **pre-compiled, portable version** of that script. It includes all necessary C++ dependencies (`nona`, `zlib`, etc.) inside a single executable for **Windows**, **Linux**, and **macOS**.
+
+## Installation
+
+```bash
+npm install html360-gen
+```
+
+## Usage
+### Node.js 
+```javascript
+import { html360Gen } from 'html360-gen';
+import { execFile } from 'child_process';
+
+const genPath = html360Gen.getBinaryPath();
+
+// Example: Slice a 360° panorama into tiles
+const args = ['input.jpg', '--output', './tiles_output'];
+
+execFile(genPath, args, (error, stdout, stderr) => {
+    if (error) {
+        console.error(`Error: ${error.message}`);
+        return;
+    }
+    console.log('✅ Success! Tiles generated.');
+});
+```
+
+### Command Line Interface (CLI)
+If installed locally, run via npx:
+
+```
+npx html360-gen input.jpg
+```
+If installed globally, run directly:
+```
+html360-gen input.jpg
+```
+### Note
+The binary supports all original Pannellum flags like --bin, --levels, etc. Run with --help to see all options.
+
+## Technical Details
+- **Core**: Fork of the official Pannellum generate.py.
+- **Engine**: Bundled nona utility for mathematically accurate cube projection.
+- **Packaging**: Compiled using PyInstaller with custom library path patching for macOS portability.
+
+### Versioning Policy
+This project follows a **mirror versioning** strategy relative to the official [Pannellum](https://www.npmjs.com/package/pannellum) releases:
+- The **Major** and **Minor** versions match the corresponding Pannellum version (e.g., `2.5.x`).
+- The **Patch** version reflects updates, bug fixes, or binary improvements specific to this generator project.
+
+
+## Credits
+- **Pannellum** — the core 360° viewer engine by Matthew Petroff.
+- **Hugin** — for the nona stitching engine.
+- **Google Gemini** — for co-authoring the entire project architecture and CI/CD pipelines.

package/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { execFileSync } from 'child_process';
+import { html360Gen } from './index.js';
+
+try {
+  const bin = html360Gen.getBinaryPath();
+  execFileSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+} catch (err) {
+  // Если ошибка пришла от самого бинарника (у него есть код выхода status)
+  if (err.status) {
+    process.exit(err.status);
+  }
+  
+  // Если это системная ошибка Node.js (например, файл не найден или ОС не та)
+  console.error(err);
+  process.exit(1);
+}

package/index.js

@@ -0,0 +1,32 @@
+import path from 'path';
+import fs from 'node:fs';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function getBinaryPath() {
+    const platform = process.platform;
+
+    let binaryName;
+    if (platform === 'win32') binaryName = 'html360-gen.exe';
+    if (platform === 'darwin') binaryName = 'html360-gen';
+    if (platform === "linux") binaryName = 'html360-gen';
+    if (!binaryName){
+      throw new Error(`[html360-gen] Platform ${process.platform} is not supported.`);
+    }
+
+    const result = path.join(__dirname, 'bin', binaryName);
+
+    if (!fs.existsSync(result)) {
+      throw new Error(
+        `[html360-gen] Binary not found! Try reinstalling the package.`,
+      );
+    }    
+
+    return result;
+}
+
+export const html360Gen = {
+  getBinaryPath
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "html360-gen",
+  "version": "2.5.0",
+  "description": "Standalone, zero-dependency binaries for the original Pannellum `generate.py` script.",
+  "keywords": [
+    "pannellum",
+    "generate.py",
+    "multiresolution",
+    "tiles-generator",
+    "binaries",
+    "panorama",
+    "html360",
+    "360"
+  ],
+  "homepage": "https://github.com/html360/html360-gen",
+  "bugs": {
+    "url": "https://github.com/html360/html360-gen/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/html360/html360-gen.git"
+  },
+  "license": "MIT",
+  "author": "d_hand",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "html360-gen": "cli.js"
+  },
+  "files": [
+    "postinstall.cjs",
+    "index.js",
+    "cli.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.cjs"
+  },
+  "engines": {
+    "node": ">=20.10.0"
+  }
+}

package/postinstall.cjs

@@ -0,0 +1,70 @@
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const pkg = require("./package.json");
+
+const platform = os.platform();
+
+let binaryName;
+if (platform === "win32") binaryName = "html360-gen-win.exe";
+if (platform === "linux") binaryName = "html360-gen-linux";
+if (platform === "darwin") binaryName = "html360-gen-macos";
+
+if (!binaryName) {
+  console.error("❌ Error: Your operating system is not supported.");
+  process.exit(0); // Завершаем без ошибки, чтобы не ломать npm install (сломает установку html360)
+}
+
+const binDir = path.join(__dirname, "bin");
+const dest = path.join(
+  binDir,
+  platform === "win32" ? "html360-gen.exe" : "html360-gen",
+);
+
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+const url = `https://github.com/html360/html360-gen/releases/download/v${pkg.version}/${binaryName}`;
+
+function download(fileUrl) {
+  console.log(`Downloading binary for ${platform}...`);
+
+  https
+    .get(fileUrl, (res) => {
+      // Handle GitHub Redirects (301 or 302)
+      if (res.statusCode === 301 || res.statusCode === 302) {
+        return download(res.headers.location);
+      }
+
+      if (res.statusCode !== 200) {
+        console.error(`❌ Download failed: Server returned ${res.statusCode}`);
+        process.exit(1);
+      }
+
+      const file = fs.createWriteStream(dest);
+      res.pipe(file);
+
+      file.on("finish", () => {
+        file.close();
+        // Grant execution permissions for Linux/Mac
+        if (platform !== "win32") {
+          fs.chmodSync(dest, 0o755);
+        }
+        console.log("✅ Binary downloaded and ready to use!");
+        process.exit(0);
+      });
+      file.on("error", () => {
+        console.error("❌ Write file error:", err.message);
+        if (fs.existsSync(dest)) fs.unlinkSync(dest);
+        process.exit(1);
+      });
+    })
+    .on("error", (err) => {
+      console.error("❌ Network error:", err.message);
+      process.exit(1);
+    });
+}
+
+download(url);