yllaw 1.0.0

package/README.md

@@ -0,0 +1,121 @@
+# yllaw
+
+Roblox 包管理器 - 支持 Wally 包和私有 Git 仓库。
+
+> yllaw = wally 倒过来 🙃
+
+## 安装
+
+```bash
+npm install -g yllaw
+```
+
+## 使用
+
+```bash
+# 安装所有包（Wally + Git）
+yllaw install
+
+# 只安装 Git 包，跳过 Wally
+yllaw install --skip-wally
+yllaw install -s
+
+# 强制更新所有 Git 包
+yllaw update
+
+# 指定配置文件
+yllaw install --config my-wally.toml
+
+# 指定输出目录
+yllaw install --output Packages
+```
+
+## 配置
+
+在项目根目录创建 `wally.toml`：
+
+```toml
+[package]
+name = "your-scope/your-project"
+version = "0.1.0"
+realm = "shared"
+
+[dependencies]
+# Wally 公共包
+
+[server-dependencies]
+# Wally 服务端包
+
+[git-dependencies]
+# 私有 Git 包（共享）
+CommonLib = "https://gitlab.example.com/group/common-lib.git@1.0.0"
+
+[server-git-dependencies]
+# 私有 Git 包（服务端）
+MMS = "https://gitlab.example.com/group/mms.git@1.1.0"
+```
+
+## Git 包格式
+
+```
+包名 = "仓库地址.git@版本"
+```
+
+| 部分 | 说明 | 示例 |
+|------|------|------|
+| 仓库地址 | HTTPS Git URL | `https://gitlab.example.com/group/repo.git` |
+| 版本 | Git tag / 分支 / commit | `1.0.0`, `main`, `abc1234` |
+
+## 创建私有包
+
+你的 Git 仓库结构：
+
+```
+your-package/
+├── README.md
+├── wally.toml
+└── YourModule/
+    ├── init.luau    ← 必须有入口文件
+    ├── Foo.luau
+    └── Bar.luau
+```
+
+yllaw 会自动查找包含 `init.luau` 或 `init.lua` 的目录。
+
+### 发布版本
+
+```bash
+git tag 1.0.0
+git push origin 1.0.0
+```
+
+## 与 Wally 的关系
+
+yllaw **补充** Wally，而不是替代：
+
+- Wally 负责公共包和私有 Registry
+- yllaw 负责私有 Git 仓库的包
+
+运行 `yllaw install` 时：
+1. 先运行 `wally install`
+2. 再安装 `[git-dependencies]` 和 `[server-git-dependencies]`
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `yllaw install` | 安装所有包 |
+| `yllaw install -s` | 跳过 Wally，只安装 Git 包 |
+| `yllaw update` | 强制重新安装所有 Git 包 |
+
+## 选项
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-s, --skip-wally` | 跳过 Wally | false |
+| `-c, --config <path>` | 配置文件路径 | `wally.toml` |
+| `-o, --output <dir>` | 输出目录 | `Packages` |
+
+## License
+
+MIT

package/bin/yllaw.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const { version } = require('../package.json');
+const { install } = require('../src/installer');
+
+program
+  .name('yllaw')
+  .description('Package manager for Roblox - supports Wally and private Git repositories')
+  .version(version);
+
+program
+  .command('install')
+  .description('Install packages from wally.toml')
+  .option('-s, --skip-wally', 'Skip wally install, only install git packages')
+  .option('-c, --config <path>', 'Path to wally.toml', 'wally.toml')
+  .option('-o, --output <dir>', 'Output directory for packages', 'Packages')
+  .action(async (options) => {
+    try {
+      await install(options);
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('update')
+  .description('Update all git packages to latest version (re-clone)')
+  .option('-s, --skip-wally', 'Skip wally install')
+  .option('-c, --config <path>', 'Path to wally.toml', 'wally.toml')
+  .option('-o, --output <dir>', 'Output directory for packages', 'Packages')
+  .action(async (options) => {
+    try {
+      await install({ ...options, force: true });
+    } catch (err) {
+      console.error('Error:', err.message);
+      process.exit(1);
+    }
+  });
+
+// Default command: install
+if (process.argv.length === 2) {
+  process.argv.push('install');
+}
+
+program.parse();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "yllaw",
+  "version": "1.0.0",
+  "description": "Package manager for Roblox - supports Wally packages and private Git repositories",
+  "main": "src/index.js",
+  "bin": {
+    "yllaw": "./bin/yllaw.js"
+  },
+  "scripts": {
+    "test": "node bin/yllaw.js install"
+  },
+  "keywords": [
+    "roblox",
+    "wally",
+    "package-manager",
+    "luau",
+    "lua"
+  ],
+  "author": "Hauru",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "simple-git": "^3.22.0",
+    "toml": "^3.0.0",
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.2.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.showhand.win/game_develop/yllaw.git"
+  }
+}

package/src/installer.js

@@ -0,0 +1,206 @@
+const fs = require('fs-extra');
+const path = require('path');
+const toml = require('toml');
+const simpleGit = require('simple-git');
+const { spawn } = require('child_process');
+const chalk = require('chalk');
+
+const log = {
+  info: (msg) => console.log(chalk.blue('[INFO]'), msg),
+  ok: (msg) => console.log(chalk.green('[OK]'), msg),
+  warn: (msg) => console.log(chalk.yellow('[WARN]'), msg),
+  error: (msg) => console.log(chalk.red('[ERROR]'), msg),
+};
+
+/**
+ * Run wally install
+ */
+async function runWally() {
+  return new Promise((resolve) => {
+    const wally = spawn('wally', ['install'], {
+      stdio: 'inherit',
+      shell: true,
+    });
+
+    wally.on('close', (code) => {
+      resolve(code === 0);
+    });
+
+    wally.on('error', () => {
+      resolve(false);
+    });
+  });
+}
+
+/**
+ * Parse git spec: "https://example.com/repo.git@version"
+ * @returns {{ url: string, ref: string }}
+ */
+function parseGitSpec(spec) {
+  const gitAtIndex = spec.lastIndexOf('.git@');
+  if (gitAtIndex > 0) {
+    return {
+      url: spec.substring(0, gitAtIndex + 4),
+      ref: spec.substring(gitAtIndex + 5),
+    };
+  }
+  return {
+    url: spec,
+    ref: 'main',
+  };
+}
+
+/**
+ * Find module directory (containing init.luau or init.lua)
+ */
+async function findModuleDir(searchDir) {
+  // Check root
+  if (await fs.pathExists(path.join(searchDir, 'init.luau')) ||
+      await fs.pathExists(path.join(searchDir, 'init.lua'))) {
+    return searchDir;
+  }
+
+  // Check immediate subdirectories
+  const entries = await fs.readdir(searchDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const subDir = path.join(searchDir, entry.name);
+      if (await fs.pathExists(path.join(subDir, 'init.luau')) ||
+          await fs.pathExists(path.join(subDir, 'init.lua'))) {
+        return subDir;
+      }
+    }
+  }
+
+  // Deep search (fallback)
+  for (const entry of entries) {
+    if (entry.isDirectory() && !entry.name.startsWith('.')) {
+      const found = await findModuleDir(path.join(searchDir, entry.name));
+      if (found) return found;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Install a single git package
+ */
+async function installGitPackage(name, spec, outputDir, tempDir) {
+  const { url, ref } = parseGitSpec(spec);
+  const target = path.join(outputDir, name);
+  const repoDir = path.join(tempDir, 'repo');
+
+  log.info(`Installing ${name} @ ${ref}`);
+
+  // Clean temp dir
+  await fs.remove(tempDir);
+  await fs.ensureDir(tempDir);
+
+  // Clone
+  const git = simpleGit();
+  try {
+    await git.clone(url, repoDir, ['--depth', '1', '--branch', ref]);
+  } catch (err) {
+    // Fallback: clone default branch and checkout
+    try {
+      await git.clone(url, repoDir, ['--depth', '1']);
+      const repoGit = simpleGit(repoDir);
+      await repoGit.fetch(['origin', ref, '--depth', '1']);
+      await repoGit.checkout('FETCH_HEAD');
+    } catch (err2) {
+      log.error(`Clone failed: ${name} - ${err2.message}`);
+      return false;
+    }
+  }
+
+  // Find module directory
+  const moduleDir = await findModuleDir(repoDir);
+  if (!moduleDir) {
+    log.error(`No init.luau found in ${name}`);
+    return false;
+  }
+
+  // Copy to output
+  await fs.remove(target);
+  await fs.copy(moduleDir, target);
+
+  // Clean up .git if copied
+  await fs.remove(path.join(target, '.git'));
+
+  log.ok(`${name} -> ${target}`);
+  return true;
+}
+
+/**
+ * Main install function
+ */
+async function install(options) {
+  const { config, output, skipWally, force } = options;
+  const configPath = path.resolve(config);
+  const outputDir = path.resolve(output);
+  const tempDir = path.join(process.cwd(), '.yllaw_temp');
+
+  // Check config exists
+  if (!await fs.pathExists(configPath)) {
+    throw new Error(`Config not found: ${configPath}`);
+  }
+
+  log.info(`Config: ${configPath}`);
+  await fs.ensureDir(outputDir);
+
+  // Step 1: Wally install
+  if (skipWally) {
+    log.info('Skipping wally (--skip-wally)');
+  } else {
+    log.info('Running wally install...');
+    const wallyOk = await runWally();
+    if (wallyOk) {
+      log.ok('Wally done');
+    } else {
+      log.warn('Wally skipped or not found');
+    }
+  }
+
+  // Step 2: Parse config
+  const configContent = await fs.readFile(configPath, 'utf-8');
+  let parsed;
+  try {
+    parsed = toml.parse(configContent);
+  } catch (err) {
+    throw new Error(`Failed to parse ${config}: ${err.message}`);
+  }
+
+  // Step 3: Install git dependencies
+  const gitDeps = {
+    ...parsed['git-dependencies'],
+    ...parsed['server-git-dependencies'],
+  };
+
+  const packages = Object.entries(gitDeps);
+  if (packages.length === 0) {
+    log.info('No git dependencies found');
+  } else {
+    log.info(`Found ${packages.length} git package(s)`);
+
+    for (const [name, spec] of packages) {
+      const target = path.join(outputDir, name);
+
+      // Skip if exists and not forcing update
+      if (!force && await fs.pathExists(target)) {
+        log.info(`${name} already exists, skipping (use 'yllaw update' to force)`);
+        continue;
+      }
+
+      await installGitPackage(name, spec, outputDir, tempDir);
+    }
+  }
+
+  // Cleanup
+  await fs.remove(tempDir);
+
+  console.log('');
+  log.ok(`Done! Packages installed to ${outputDir}`);
+}
+
+module.exports = { install };