@titanpl/cli 7.0.0-beta → 7.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/cli",
-  "version": "7.0.0-beta",
+  "version": "7.0.1",
   "description": "The unified CLI for Titan Planet. Use it to create, manage, build, and deploy high-performance backend projects.",
   "keywords": [
     "titanpl",
@@ -29,11 +29,11 @@
     "tit": "./index.js"
   },
   "optionalDependencies": {
-    "@titanpl/engine-win32-x64": "7.0.0-beta",
-    "@titanpl/engine-linux-x64": "7.0.0-beta"
+    "@titanpl/engine-win32-x64": "7.0.1",
+    "@titanpl/engine-linux-x64": "7.0.1"
   },
   "dependencies": {
-    "@titanpl/packet": "7.0.0-beta",
+    "@titanpl/packet": "7.0.1",
     "prompts": "^2.4.2",
     "commander": "^11.0.0",
     "chalk": "^4.1.2"

package/src/commands/build-ext.js

@@ -38,10 +38,23 @@ async function buildWasmExtension(titanJson) {
     try {
         // We assume wasm-pack or similar is used, or just bare cargo with wasm32 target
         // The spec mentions: native/pkg/my_ext.wasm, which is wasm-pack's default
-        execSync('wasm-pack build --target web', { cwd: nativeDir, stdio: 'inherit' });
+        console.log(chalk.gray("  Running wasm-pack..."));
+        execSync('wasm-pack build --target web --no-typescript', { cwd: nativeDir, stdio: 'ignore' });
     } catch (err) {
-        console.log(chalk.red("✖ Wasm compilation failed. Make sure 'wasm-pack' is installed."));
-        return;
+        console.log(chalk.yellow("! wasm-pack failed, attempting raw cargo build..."));
+        try {
+            execSync('cargo build --target wasm32-unknown-unknown --release', { cwd: nativeDir, stdio: 'ignore' });
+            const pkgDir = path.join(nativeDir, 'pkg');
+            if (!fs.existsSync(pkgDir)) fs.mkdirSync(pkgDir);
+            
+            const targetWasm = path.join(nativeDir, `target/wasm32-unknown-unknown/release/${crateName}.wasm`);
+            const destWasm = path.join(pkgDir, `${crateName}_bg.wasm`);
+            fs.copyFileSync(targetWasm, destWasm);
+            console.log(chalk.green("✔ Raw Wasm compilation successful."));
+        } catch (cargoErr) {
+            console.log(chalk.red("✖ Wasm compilation failed. Make sure Rust and wasm32-unknown-unknown target are installed."));
+            return;
+        }
     }
 
     console.log(chalk.gray("  Generating bindings..."));
@@ -95,7 +108,7 @@ async function buildNativeExtension(titanJson) {
 
     console.log(chalk.gray("  Compiling Rust native library..."));
     try {
-        execSync('cargo build --release', { cwd: nativeDir, stdio: 'inherit' });
+        execSync('cargo build --release', { cwd: nativeDir, stdio: 'ignore' });
     } catch (err) {
         console.log(chalk.red("✖ Native compilation failed."));
         return;

package/templates/common/_tanfig.json

@@ -3,8 +3,10 @@
   "description": "A powerful TitanPL project",
   "version": "1.0.0",
   "extensions": {
-    "allowWasm": false,
-    "allowNative": []
+    "allowWasm": true,
+    "allowNative": [
+      "@titanpl/core"
+    ]
   },
   "build": {
     "purpose": "test",

package/templates/extension/README_WASM.md

@@ -0,0 +1,38 @@
+# TitanPL Native & WebAssembly Extensions
+
+One of the definitive features of TitanPL v7+ is its dynamic, zero-configuration native extension bridge. You no longer have to manually define function signatures or types within `titan.json`.
+
+## The Hybrid IPC Native Bridge
+
+The `NativeHost` bridge natively detects argument types over IPC at runtime. Whether you pass floating-point numbers (`f64`), complex strings, or JSON-stringified objects:
+
+1. **Dynamic C-ABI Interop:** The host inspects the payload dynamically and generates the correct C-struct register combinations on-the-fly (`f64`, `*const c_char`, combinations).
+2. **Safe Void execution:** Memory protections natively peek at returned pointer segments, preventing SEGFAULT crashes. `void` returns are safely handled transparently.
+   
+### Writing WebAssembly (WASM) 
+
+Because Titan CLI utilizes `wasm-pack` without unnecessary logs, compiling WebAssembly plugins from Rust is completely silent and incredibly robust.
+
+To build a fresh, silent WASM extension:
+```bash
+titan build ext
+```
+The CLI suppresses stdout output (`stdio: 'ignore'`) allowing clean build processes unless a fatal compiler failure occurs.
+
+### Best Practices: The `@titanpl/native` Namespace
+
+Never use the globally injected `t.*` prefixes in Modern TitanPL scripts (unless deploying backward-compatible code). Instead, simply use the modular native imports:
+
+```js
+// BEFORE (Not Recommended)
+const data = t.fs.readFile("example.txt");
+const hash = t.crypto.hash("sha256", "test");
+
+// AFTER (Recommended)
+import { fs, crypto, drift } from "@titanpl/native";
+
+const data = fs.readFile("example.txt");
+const hash = crypto.hash("sha256", "test");
+```
+
+By transitioning to `@titanpl/native`, you gain absolute Type Completion (via the newly restructured `d.ts` declaration maps) explicitly tailored to ESM semantics.

package/templates/extension/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-extension",
-  "version": "7.0.0-beta",
+  "version": "7.0.1",
   "description": "A high-performance TitanPL extension.",
   "type": "module",
   "main": "index.js",
@@ -11,6 +11,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@titanpl/sdk": "7.0.0-beta"
+    "@titanpl/sdk": "7.0.1"
   }
 }

package/templates/js/package.json

@@ -6,16 +6,16 @@
     "template": "js"
   },
   "dependencies": {
-    "@titanpl/cli": "7.0.0-beta",
-    "@titanpl/route": "7.0.0-beta",
-    "@titanpl/native": "7.0.0-beta",
-    "@titanpl/core": "latest",
+    "@titanpl/cli": "7.0.1",
+    "@titanpl/route": "7.0.1",
+    "@titanpl/native": "7.0.1",
+    "@titanpl/core": "7.0.0",
     "@titanpl/node": "latest",
-    "@titanpl/packet": "7.0.0-beta"
+    "@titanpl/packet": "7.0.1"
   },
   "optionalDependencies": {
-    "@titanpl/engine-linux-x64": "7.0.0-beta",
-    "@titanpl/engine-win32-x64": "7.0.0-beta"
+    "@titanpl/engine-linux-x64": "7.0.1",
+    "@titanpl/engine-win32-x64": "7.0.1"
   },
   "scripts": {
     "build": "titan build",
@@ -28,5 +28,5 @@
     "eslint": "^9.39.2",
     "eslint-plugin-titanpl": "latest"
   },
-  "version": "7.0.0-beta"
+  "version": "7.0.1"
 }

package/templates/rust-js/package.json

@@ -1,16 +1,16 @@
 {
   "name": "titanpl",
-  "version": "7.0.0-beta",
+  "version": "7.0.1",
   "description": "A Titan Planet server",
   "type": "module",
   "titan": {
     "template": "rust-js"
   },
   "dependencies": {
-    "@titanpl/cli": "7.0.0-beta",
-    "@titanpl/route": "7.0.0-beta",
-    "@titanpl/native": "7.0.0-beta",
-    "@titanpl/core": "latest",
+    "@titanpl/cli": "7.0.1",
+    "@titanpl/route": "7.0.1",
+    "@titanpl/native": "7.0.1",
+    "@titanpl/core": "7.0.0",
     "@titanpl/node": "latest"
   },
   "scripts": {

package/templates/rust-ts/package.json

@@ -1,16 +1,16 @@
 {
   "name": "titanpl",
-  "version": "7.0.0-beta",
+  "version": "7.0.1",
   "description": "A Titan Planet server (Rust + TypeScript)",
   "type": "module",
   "titan": {
     "template": "rust-ts"
   },
   "dependencies": {
-    "@titanpl/cli": "7.0.0-beta",
-    "@titanpl/route": "7.0.0-beta",
-    "@titanpl/native": "7.0.0-beta",
-    "@titanpl/core": "latest",
+    "@titanpl/cli": "7.0.1",
+    "@titanpl/route": "7.0.1",
+    "@titanpl/native": "7.0.1",
+    "@titanpl/core": "7.0.0",
     "@titanpl/node": "latest",
     "typescript": "^5.0.0"
   },

package/templates/ts/package.json

@@ -6,18 +6,18 @@
     "template": "ts"
   },
   "dependencies": {
-    "@titanpl/cli": "7.0.0-beta",
-    "@titanpl/route": "7.0.0-beta",
-    "@titanpl/native": "7.0.0-beta",
-    "@titanpl/core": "latest",
+    "@titanpl/cli": "7.0.1",
+    "@titanpl/route": "7.0.1",
+    "@titanpl/native": "7.0.1",
+    "@titanpl/core": "7.0.0",
     "@titanpl/node": "latest",
-    "@titanpl/packet": "7.0.0-beta",
+    "@titanpl/packet": "7.0.1",
     "typescript": "^5.0.0"
   },
   "optionalDependencies": {
     "@titanpl/engine-linux-arm64": "2.0.5",
-    "@titanpl/engine-linux-x64": "7.0.0-beta",
-    "@titanpl/engine-win32-x64": "7.0.0-beta"
+    "@titanpl/engine-linux-x64": "7.0.1",
+    "@titanpl/engine-win32-x64": "7.0.1"
   },
   "scripts": {
     "build": "titan build",
@@ -31,5 +31,5 @@
     "eslint-plugin-titanpl": "latest",
     "@typescript-eslint/parser": "^8.54.0"
   },
-  "version": "7.0.0-beta"
+  "version": "7.0.1"
 }

package/templates/extension/README.md

@@ -1,69 +0,0 @@
-# Titan Extension Template
-
-This template provides a starting point for building native extensions for Titan.
-
-## Directory Structure
-
-- `index.js`: The JavaScript entry point for your extension. It runs within the Titan runtime.
-- `index.d.ts`: TypeScript definitions for your extension. This ensures users get autocompletion when using your extension.
-- `native/`: (Optional) Rust source code for native high-performance logic.
-- `titan.json`: Configuration file defining your extension's native ABI (if using Rust).
-
-## Type Definitions (`index.d.ts`)
-
-The `index.d.ts` file is crucial for Developer Experience (DX). It allows Titan projects to "see" your extension's API on the global `t` object.
-
-### How it works
-
-Titan uses **Declaration Merging** to extend the global `Titan.Runtime` interface. When a user installs your extension, this file acts as a plugin to their TypeScript environment.
-
-### Customizing Types
-
-Edit `index.d.ts` to match the API you expose in `index.js`.
-
-**Example:**
-
-If your `index.js` looks like this:
-
-```javascript
-// index.js
-t.ext.my_cool_ext = {
-    greet: (name) => `Hello, ${name}!`,
-    compute: (x) => x * 2
-};
-```
-
-Your `index.d.ts` should look like this:
-
-```typescript
-// index.d.ts
-declare global {
-    namespace Titan {
-        interface Runtime {
-            "my-cool-ext": {
-                /**
-                 * Sends a greeting.
-                 */
-                greet(name: string): string;
-
-                /**
-                 * Computes a value.
-                 */
-                compute(x: number): number;
-            }
-        }
-    }
-}
-export { };
-```
-
-## Native Bindings (Rust)
-
-If your extension requires native performance or system access, use the `native/` directory.
-1. Define functions in `native/src/lib.rs`.
-2. Map them in `titan.json`.
-3. Call them from `index.js` using `Titan.native.invoke(...)` (or the helper provided in the template).
-
----
-
-**Important Note:** Currently, Titan Planet and its entire package ecosystem are only for Windows. The Linux version is in development (dev only) for the new architecture and will be launched later.