@crossberryweb/mozhi 0.0.0-stage → 3.1.1

package/LICENSE

@@ -0,0 +1,116 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2026 crossberry-in (https://github.com/crossberry-in)
+All rights reserved.
+
+1. DEFINITIONS
+
+   "Software" refers to the Mozhi programming language interpreter binary,
+   its source code, and any accompanying documentation.
+
+   "Source Code" refers to the human-readable C source files of the Mozhi
+   interpreter, including but not limited to files under the src/ and
+   include/ directories of the private source repository.
+
+   "Binary" refers to the compiled, executable form of the Software,
+   distributed via the public releases at
+   https://github.com/crossberry-in/mozhi-doc/releases.
+
+   "Licensee" refers to any individual or entity that downloads, installs,
+   or uses the Software.
+
+2. SOURCE CODE AVAILABILITY
+
+   The Source Code of the Software is CLOSED-SOURCE and PROPRIETARY.
+   The Source Code is maintained in a private repository and is NOT
+   distributed to the public. Licensees receive only the Binary form
+   of the Software.
+
+3. GRANT OF LICENSE
+
+   Subject to the terms and conditions of this License, the licensor
+   hereby grants to the Licensee a non-exclusive, non-transferable,
+   non-sublicensable, worldwide, royalty-free license to:
+
+   a) Download, install, and use the Binary of the Software for any
+      lawful purpose, including personal, educational, and commercial use.
+
+   b) Write, distribute, and publicly share Mozhi scripts (source files
+      with the .mz extension) that are executed by the Software.
+
+   c) Distribute verbatim copies of the unmodified Binary to third parties,
+      provided that this License is included with such copies.
+
+4. RESTRICTIONS
+
+   The Licensee shall NOT:
+
+   a) Reverse engineer, decompile, disassemble, or otherwise attempt to
+      derive the Source Code from the Binary, except to the extent that
+      such activity is expressly permitted by applicable law.
+
+   b) Modify, adapt, translate, or create derivative works based on the
+      Software, in whole or in part, in source or binary form.
+
+   c) Redistribute, sell, rent, lease, or sublicense the Software, in
+      whole or in part, for a fee, without prior written permission from
+      the licensor.
+
+   d) Remove or alter any copyright, trademark, or other proprietary
+      notices on or in the Software.
+
+   e) Use the Software in any manner that violates applicable laws or
+      regulations.
+
+5. OWNERSHIP
+
+   The Software is licensed, not sold. The licensor retains all right,
+   title, and interest in and to the Software, including all intellectual
+   property rights therein. This License does not grant the Licensee any
+   rights to the Source Code.
+
+6. DISCLAIMER OF WARRANTY
+
+   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 LICENSOR 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.
+
+7. LIMITATION OF LIABILITY
+
+   IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED
+   TO LOSS OF PROFITS, DATA, OR USE, ARISING OUT OF OR IN CONNECTION WITH
+   THIS LICENSE OR THE SOFTWARE, HOWEVER CAUSED AND UNDER ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE), EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY
+   OF SUCH DAMAGES.
+
+8. TERMINATION
+
+   This License is effective until terminated. The Licensee may terminate
+   this License at any time by ceasing all use of the Software and
+   destroying all copies in their possession. The licensor may terminate
+   this License immediately if the Licensee breaches any of its terms.
+   Upon termination, the Licensee must cease all use of the Software and
+   destroy all copies in their possession.
+
+9. GOVERNING LAW
+
+   This License shall be governed by and construed in accordance with the
+   laws of the jurisdiction in which the licensor resides, without regard
+   to its conflict of law provisions.
+
+10. ENTIRE AGREEMENT
+
+    This License constitutes the entire agreement between the licensor and
+    the Licensee with respect to the Software and supersedes all prior or
+    contemporaneous understandings regarding such subject matter.
+
+---
+
+For inquiries regarding licensing, source code access, or commercial use,
+please visit: https://github.com/crossberry-in/mozhi-doc/issues

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# Mozhi (official npm distribution)
 
-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.
+**Mozhi** (மொழி — "language" in Tamil) is a fast, beginner-friendly scripting language with a **native full-stack platform**: HTTP server, template engine, JSON stack, sandboxed filesystem and SQLite — all built into the interpreter, zero external runtimes.
+
+This package installs the official `mozhi` command with a **prebuilt, fully static Linux binary** bundled inside — no compilation, no postinstall downloads, works offline behind any proxy.
+
+## Install
+
+```bash
+npm install -g @crossberryweb/mozhi
+
+# then:
+mozhi --version
+```
+
+Bundled platforms (v3.1.1, static musl binaries with SQLite vendored):
+
+| Platform | Binary |
+|----------|--------|
+| Linux x86_64 | bundled |
+| Linux arm64 (aarch64, incl. Android/Termux chroots) | bundled |
+| macOS / Windows | use the [installer script](https://github.com/crossberry-in/mozhi-doc#installation) instead |
+
+The binaries are fully static, so one build serves glibc distros (Ubuntu/Debian/Fedora/Arch), Alpine/musl, and Termux alike.
+
+## Quick start
+
+`hello.mz`
+```mozhi
+let name = "Mozhi"
+echo("Hello from " + name + "!")
+
+fn fib(n) {
+    if n < 2 {
+        return n
+    }
+    return fib(n - 1) + fib(n - 2)
+}
+echo("fib(10) = " + string(fib(10)))
+```
+
+```bash
+mozhi run hello.mz      # or simply: mozhi hello.mz
+```
+
+**Full-stack web app** — `app.mz`:
+```mozhi
+import web
+
+let app = web.create({
+    log: true
+})
+
+app.get("/", fn(req, res) {
+    return res.html("<h1>Hello from Mozhi</h1>")
+})
+
+app.get("/api/health", fn(req, res) {
+    return res.json({
+        status: "ok",
+        language: "Mozhi",
+        version: web.version()
+    })
+})
+
+app.listen("127.0.0.1", 8080)
+```
+
+```bash
+mozhi run app.mz
+# then: curl http://127.0.0.1:8080/api/health
+```
+
+## What's inside
+
+- `bin/mozhi-linux-x86_64`, `bin/mozhi-linux-arm64` — official v3.1.1 interpreter binaries, sha256-verified against the [v3.1.1 release](https://github.com/crossberry-in/mozhi-doc/releases/tag/v3.1.1)
+- `bin/mozhi.js` — tiny launcher that picks the right binary and forwards arguments, stdio, exit codes and signals
+
+Versioning: the npm package version always matches the bundled interpreter release (package 3.1.1 = Mozhi v3.1.1).
+
+## Docs
+
+- [Documentation site](https://crossberry-in.github.io/mozhi-doc/)
+- [Web Server Guide](https://github.com/crossberry-in/mozhi-doc/blob/main/docs/WEB_GUIDE.md)
+- [Language Reference](https://github.com/crossberry-in/mozhi-doc/blob/main/LANGUAGE_REFERENCE.md)
+- [Examples](https://github.com/crossberry-in/mozhi-doc/tree/main/examples)
+
+## License
+
+Mozhi is proprietary (closed-source interpreter, publicly released binaries). This package redistributes **unmodified official release binaries** as permitted by the bundled [LICENSE](./LICENSE) (§3c "verbatim copies"). By installing you accept its terms.

package/bin/checksums-sha256.txt

@@ -0,0 +1,4 @@
+e67ef15909da90c07e39d9a6e79f5575c4ae49a866962c44f33e35815c2c8703  mozhi-interpreter-linux-x86_64
+266eebb0c330264018e52c7a4dac17ed1c811af5a8cc3bfeefa13299a8ca78c7  mozhi-interpreter-linux-arm64
+e67ef15909da90c07e39d9a6e79f5575c4ae49a866962c44f33e35815c2c8703  mozhi-interpreter-alpine-x86_64
+266eebb0c330264018e52c7a4dac17ed1c811af5a8cc3bfeefa13299a8ca78c7  mozhi-interpreter-alpine-arm64

package/bin/mozhi.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/*
+ * Mozhi interpreter launcher (npm distribution).
+ *
+ * The official prebuilt interpreter binaries ship inside this package
+ * under bin/. This launcher picks the right one for the current
+ * platform and hands over the process — arguments, stdio, exit codes
+ * and signals all pass through, so `mozhi` behaves exactly like a
+ * native binary.
+ *
+ * Bundled (v3.1.1, fully static musl builds with SQLite vendored):
+ *   bin/mozhi-linux-x86_64
+ *   bin/mozhi-linux-arm64
+ *
+ * macOS / Windows / other platforms:
+ *   see https://github.com/crossberry-in/mozhi-doc#installation
+ */
+'use strict';
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// npm's process.arch uses "x64"; our asset naming uses "x86_64".
+const arch = process.arch === 'x64' ? 'x86_64' : process.arch;
+const bin = path.join(__dirname, 'mozhi-' + process.platform + '-' + arch);
+
+if (!fs.existsSync(bin)) {
+  console.error('[mozhi] No bundled interpreter for ' + process.platform + '-' + process.arch + '.');
+  console.error('[mozhi] This package ships official v3.1.1 binaries for:');
+  console.error('[mozhi]   linux-x86_64, linux-arm64 (fully static — works on glibc, Alpine, Termux)');
+  console.error('[mozhi] For macOS, Windows and other platforms use the installer:');
+  console.error('[mozhi]   curl -fsSL https://github.com/crossberry-in/mozhi-doc/raw/main/install.sh | bash');
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  console.error('[mozhi] Failed to start interpreter: ' + err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    // propagate fatal signals (SIGINT/SIGTERM...) with the correct exit status
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code === null ? 0 : code);
+  }
+});

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@crossberryweb/mozhi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.1.1",
+  "description": "Mozhi programming language — official npm distribution. Fast, beginner-friendly scripting language with a native HTTP server, template engine, JSON stack, sandboxed filesystem and SQLite. Bundles the official static Linux x86_64/arm64 binaries and installs the `mozhi` command.",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "crossberry-in <crossberryweb@gmail.com> (https://github.com/crossberry-in)",
+  "bin": {
+    "mozhi": "bin/mozhi.js"
+  },
+  "files": [
+    "bin/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "mozhi",
+    "language",
+    "interpreter",
+    "scripting",
+    "web",
+    "webserver",
+    "http",
+    "json",
+    "sqlite",
+    "templates",
+    "fullstack"
+  ],
+  "homepage": "https://crossberry-in.github.io/mozhi-doc/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crossberry-in/mozhi-doc.git",
+    "directory": "npm"
+  },
+  "bugs": {
+    "url": "https://github.com/crossberry-in/mozhi-doc/issues"
+  },
+  "engines": {
+    "node": ">=14"
+  }
+}