@xaidenlabs/uso 1.0.2 → 1.1.0

package/my-test-project/package.json

@@ -0,0 +1,17 @@
+{
+    "scripts": {
+        "lint:fix": "prettier */*.js \"*/**/*{.js,.ts}\" -w",
+        "lint": "prettier */*.js \"*/**/*{.js,.ts}\" --check"
+    },
+    "dependencies": {
+        "@coral-xyz/anchor": "^0.30.1"
+    },
+    "devDependencies": {
+        "chai": "^4.3.7",
+        "mocha": "^9.0.3",
+        "ts-mocha": "^10.0.0",
+        "@types/mocha": "^9.0.0",
+        "typescript": "^4.3.5",
+        "prettier": "^2.6.2"
+    }
+}

package/my-test-project/programs/my_test_project/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "my-test-project"
+version = "0.1.0"
+description = "Created with USO"
+edition = "2021"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+name = "my_test_project"
+
+[features]
+no-entrypoint = []
+no-idl = []
+no-log-ix-name = []
+cpi = ["no-entrypoint"]
+default = []
+
+[dependencies]
+anchor-lang = "0.30.1"

package/my-test-project/programs/my_test_project/src/lib.rs

@@ -0,0 +1,16 @@
+use anchor_lang::prelude::*;
+
+declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
+
+#[program]
+pub mod my_test_project {
+    use super::*;
+
+    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
+        msg!("Greetings from USO! Your project is initialized.");
+        Ok(())
+    }
+}
+
+#[derive(Accounts)]
+pub struct Initialize {}

package/my-test-project/tests/my-test-project.ts

@@ -0,0 +1,16 @@
+import * as anchor from "@coral-xyz/anchor";
+import { Program } from "@coral-xyz/anchor";
+import { MyTestProject } from "../target/types/my_test_project";
+
+describe("my-test-project", () => {
+    // Configure the client to use the local cluster.
+    anchor.setProvider(anchor.AnchorProvider.env());
+
+    const program = anchor.workspace.MyTestProject as Program<MyTestProject>;
+
+    it("Is initialized!", async () => {
+        // Add your test here.
+        const tx = await program.methods.initialize().rpc();
+        console.log("Your transaction signature", tx);
+    });
+});

package/my-test-project/tsconfig.json

@@ -0,0 +1,17 @@
+{
+    "compilerOptions": {
+        "types": [
+            "mocha",
+            "chai"
+        ],
+        "typeRoots": [
+            "./node_modules/@types"
+        ],
+        "lib": [
+            "es2015"
+        ],
+        "module": "commonjs",
+        "target": "es6",
+        "esModuleInterop": true
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaidenlabs/uso",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Universal Solana Orchestrator - A one-command setup tool for Solana and Anchor development environments on Windows, macOS, and Linux.",
   "bin": {
     "uso": "bin/index.js"

package/src/commands/create.js

@@ -0,0 +1,115 @@
+const fs = require('fs');
+const path = require('path');
+const shell = require('shelljs');
+const { log, spinner } = require('../utils/logger');
+const { getCargoBinPath } = require('../utils/paths');
+
+const create = async (projectName) => {
+    if (!projectName) {
+        log.error("❌ Please provide a project name: uso create <project-name>");
+        return;
+    }
+
+    // Validate project name (basic check for valid folder name)
+    if (!/^[a-z0-9-_]+$/.test(projectName)) {
+        log.error("❌ Project name can only contain lowercase letters, numbers, hyphens, and underscores.");
+        return;
+    }
+
+    const targetDir = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(targetDir)) {
+        log.error(`❌ Directory '${projectName}' already exists.`);
+        return;
+    }
+
+    log.header(`🏗️  Scaffolding new project: ${projectName}`);
+
+    // 1. Copy Template
+    const templateDir = path.resolve(__dirname, '../../templates/default');
+    const spin = spinner('Copying template files...').start();
+
+    try {
+        shell.cp('-R', templateDir, targetDir);
+        spin.succeed('Template copied.');
+    } catch (e) {
+        spin.fail('Failed to copy template.');
+        log.error(e.message);
+        return;
+    }
+
+    // 2. Customize Project (Rename files and content)
+    log.info("✏️  Customizing project details...");
+
+    // Rename programs/my-project to programs/<project-name>
+    // Note: Rust crate names typically use underscores, not hyphens.
+    const crateName = projectName.replace(/-/g, '_');
+
+    const oldProgramDir = path.join(targetDir, 'programs', 'my-project');
+    const newProgramDir = path.join(targetDir, 'programs', crateName);
+
+    // Rename tests/my-project.ts to tests/<project-name>.ts
+    const oldTestFile = path.join(targetDir, 'tests', 'my-project.ts');
+    const newTestFile = path.join(targetDir, 'tests', `${projectName}.ts`);
+
+    try {
+        if (fs.existsSync(oldProgramDir)) {
+            fs.renameSync(oldProgramDir, newProgramDir);
+        }
+        if (fs.existsSync(oldTestFile)) {
+            fs.renameSync(oldTestFile, newTestFile);
+        }
+
+        // Replace placeholders in files
+        const replaceInFile = (filePath, searchValue, replaceValue) => {
+            if (fs.existsSync(filePath)) {
+                let content = fs.readFileSync(filePath, 'utf8');
+                // Global replace
+                const regex = new RegExp(searchValue, 'g');
+                content = content.replace(regex, replaceValue);
+                fs.writeFileSync(filePath, content, 'utf8');
+            }
+        };
+
+        // Update Anchor.toml
+        replaceInFile(path.join(targetDir, 'Anchor.toml'), 'my_project', crateName);
+
+        // Update Cargo.toml
+        replaceInFile(path.join(newProgramDir, 'Cargo.toml'), 'my-project', projectName);
+        replaceInFile(path.join(newProgramDir, 'Cargo.toml'), 'my_project', crateName);
+
+        // Update lib.rs (if specific project name usage exists beyond mod name which is file-based in lib.rs typically, but here we defined inside lib.rs)
+        // Actually, in lib.rs: pub mod my_project -> pub mod crate_name
+        replaceInFile(path.join(newProgramDir, 'src', 'lib.rs'), 'my_project', crateName);
+
+        // Update test file
+        replaceInFile(newTestFile, 'my-project', projectName); // describe("my-project")
+        replaceInFile(newTestFile, 'my_project', crateName); // import ... "../target/types/my_project"
+
+        // Update class name in test file (MyProject -> ProjectNamePascalCase)
+        const toPascalCase = (str) => {
+            return str.match(/[a-z0-9]+/gi)
+                .map(word => word.charAt(0).toUpperCase() + word.substr(1).toLowerCase())
+                .join('');
+        };
+        const pascalName = toPascalCase(projectName);
+        replaceInFile(newTestFile, 'MyProject', pascalName);
+
+    } catch (e) {
+        log.error(`❌ Failed during customization: ${e.message}`);
+        // clean up? maybe not, let user see what happened
+        return;
+    }
+
+    // 4. Generate Keypair if needed? 
+    // Anchor usually handles this on first build, but let's check if they have a wallet.
+    // We won't force it here, "uso init" or "uso verify" handles wallet creation.
+
+    log.header("\n🎉 Project Created Successfully!");
+    log.info(`\n👉 Next steps:\n`);
+    log.info(`   cd ${projectName}`);
+    log.info(`   npm install`);
+    log.info(`   uso test`);
+    log.info(`\nHappy building! 🚀`);
+};
+
+module.exports = { create };

package/templates/default/Anchor.toml

@@ -0,0 +1,18 @@
+[toolchain]
+
+[features]
+seeds = false
+skip-lint = false
+
+[programs.localnet]
+my_project = "Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "Localnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

package/templates/default/README.md

@@ -0,0 +1,36 @@
+# Welcome to Your USO Project 🚀
+
+Congratulations! You've just scaffolded a professional Solana workspace using the **Universal Solana Orchestrator (USO)**.
+
+This isn't just a folder with files. It's a battle-tested setup ready for serious development.
+
+## 📂 Structure
+- `programs/`: Your Rust smart contracts live here.
+- `tests/`: Robust TypeScript tests using Anchor.
+- `Anchor.toml`: Your project configuration.
+
+## ⚡ Quick Start
+
+### 1. Build
+Compile your smart contract:
+```bash
+uso build
+```
+
+### 2. Test
+Run your test suite against a local validator:
+```bash
+uso test
+```
+*Note: This automatically spins up a local validator, deploys your program, runs tests, and shuts down.*
+
+### 3. Deploy (Devnet)
+When you're ready to go public:
+1. Switch to devnet: `solana config set --url devnet`
+2. Airdrop SOL: `solana airdrop 2`
+3. Deploy: `uso deploy`
+
+## 🧠 Need Help?
+Run `uso doctor` if your environment feels weird. Usage instructions are also available via `uso help`.
+
+Happy coding!

package/templates/default/package.json

@@ -0,0 +1,19 @@
+{
+    "scripts": {
+        "lint:fix": "prettier */*.js \"*/**/*{.js,.ts}\" -w",
+        "lint": "prettier */*.js \"*/**/*{.js,.ts}\" --check"
+    },
+    "dependencies": {
+        "@coral-xyz/anchor": "^0.32.1"
+    },
+    "devDependencies": {
+        "chai": "^4.3.7",
+        "mocha": "^9.0.3",
+        "ts-mocha": "^10.0.0",
+        "@types/mocha": "^9.0.0",
+        "@types/chai": "^4.3.0",
+        "@types/node": "^16.0.0",
+        "typescript": "^4.3.5",
+        "prettier": "^2.6.2"
+    }
+}