yllaw 1.0.0 → 1.2.0

package/README.md

@@ -15,10 +15,15 @@ npm install -g yllaw
 ```bash
 # 安装所有包（Wally + Git）
 yllaw install
+yllaw            # install 是默认命令，可省略
 
 # 只安装 Git 包，跳过 Wally
-yllaw install --skip-wally
 yllaw install -s
+yllaw -s         # 等同于 yllaw install -s
+
+# 开发模式：从同级目录安装（用于本地开发测试）
+yllaw install -d
+yllaw -d -s      # 等同于 yllaw install -d -s
 
 # 强制更新所有 Git 包
 yllaw update
@@ -30,6 +35,32 @@ yllaw install --config my-wally.toml
 yllaw install --output Packages
 ```
 
+> **提示**: `install` 是默认命令，直接使用 `yllaw -s -d` 等同于 `yllaw install -s -d`
+
+## 开发模式 (--dev)
+
+当你在本地开发一个包，想要在另一个项目中测试时，使用 `--dev` 模式：
+
+```
+C:\Workspace\
+├── my-game/              ← 当前项目
+│   └── wally.toml        ← MMS = "...mms-matchmaking.git@1.1.0"
+└── mms-matchmaking/      ← 同级目录
+    └── MMS/
+```
+
+```bash
+cd my-game
+yllaw install -d -s
+```
+
+yllaw 会自动检测 `mms-matchmaking` 在同级目录存在，直接从本地复制，而不是从 Git 克隆。
+
+这样你可以：
+1. 修改 `mms-matchmaking` 中的代码
+2. 运行 `yllaw install -d -s` 快速同步到测试项目
+3. 无需提交、推送、更新版本号
+
 ## 配置
 
 在项目根目录创建 `wally.toml`：
@@ -113,6 +144,7 @@ yllaw **补充** Wally，而不是替代：
 | 选项 | 说明 | 默认值 |
 |------|------|--------|
 | `-s, --skip-wally` | 跳过 Wally | false |
+| `-d, --dev` | 开发模式：优先从同级目录安装 | false |
 | `-c, --config <path>` | 配置文件路径 | `wally.toml` |
 | `-o, --output <dir>` | 输出目录 | `Packages` |
 

package/bin/yllaw.js

@@ -13,6 +13,7 @@ program
   .command('install')
   .description('Install packages from wally.toml')
   .option('-s, --skip-wally', 'Skip wally install, only install git packages')
+  .option('-d, --dev', 'Dev mode: install from local sibling directories if available')
   .option('-c, --config <path>', 'Path to wally.toml', 'wally.toml')
   .option('-o, --output <dir>', 'Output directory for packages', 'Packages')
   .action(async (options) => {
@@ -28,6 +29,7 @@ program
   .command('update')
   .description('Update all git packages to latest version (re-clone)')
   .option('-s, --skip-wally', 'Skip wally install')
+  .option('-d, --dev', 'Dev mode: install from local sibling directories if available')
   .option('-c, --config <path>', 'Path to wally.toml', 'wally.toml')
   .option('-o, --output <dir>', 'Output directory for packages', 'Packages')
   .action(async (options) => {
@@ -40,8 +42,14 @@ program
   });
 
 // Default command: install
-if (process.argv.length === 2) {
-  process.argv.push('install');
+// If no known command is provided, insert 'install' as the default
+const knownCommands = ['install', 'update', 'help', '-h', '--help', '-V', '--version'];
+const args = process.argv.slice(2);
+const firstNonOption = args.find(arg => !arg.startsWith('-'));
+
+if (!firstNonOption || !knownCommands.includes(firstNonOption)) {
+  // Insert 'install' after 'node' and 'yllaw'
+  process.argv.splice(2, 0, 'install');
 }
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yllaw",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Package manager for Roblox - supports Wally packages and private Git repositories",
   "main": "src/index.js",
   "bin": {

package/src/installer.js

@@ -34,20 +34,26 @@ async function runWally() {
 
 /**
  * Parse git spec: "https://example.com/repo.git@version"
- * @returns {{ url: string, ref: string }}
+ * @returns {{ url: string, ref: string, repoName: string }}
  */
 function parseGitSpec(spec) {
   const gitAtIndex = spec.lastIndexOf('.git@');
+  let url, ref;
+
   if (gitAtIndex > 0) {
-    return {
-      url: spec.substring(0, gitAtIndex + 4),
-      ref: spec.substring(gitAtIndex + 5),
-    };
+    url = spec.substring(0, gitAtIndex + 4);
+    ref = spec.substring(gitAtIndex + 5);
+  } else {
+    url = spec;
+    ref = 'main';
   }
-  return {
-    url: spec,
-    ref: 'main',
-  };
+
+  // Extract repo name from URL
+  // e.g., "https://gitlab.example.com/group/mms-matchmaking.git" -> "mms-matchmaking"
+  const repoMatch = url.match(/\/([^\/]+)\.git$/);
+  const repoName = repoMatch ? repoMatch[1] : null;
+
+  return { url, ref, repoName };
 }
 
 /**
@@ -83,6 +89,47 @@ async function findModuleDir(searchDir) {
   return null;
 }
 
+/**
+ * Try to install from local sibling directory (dev mode)
+ * @returns {boolean} true if installed from local
+ */
+async function tryInstallFromLocal(name, spec, outputDir, parentDir) {
+  const { repoName } = parseGitSpec(spec);
+
+  if (!repoName) {
+    return false;
+  }
+
+  // Check if sibling directory exists
+  const localRepoDir = path.join(parentDir, repoName);
+
+  if (!await fs.pathExists(localRepoDir)) {
+    return false;
+  }
+
+  log.info(`[DEV] Found local: ${localRepoDir}`);
+
+  // Find module directory in local repo
+  const moduleDir = await findModuleDir(localRepoDir);
+
+  if (!moduleDir) {
+    log.warn(`[DEV] No init.luau found in ${localRepoDir}, falling back to git`);
+    return false;
+  }
+
+  const target = path.join(outputDir, name);
+
+  // 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(`[DEV] ${name} <- ${moduleDir}`);
+  return true;
+}
+
 /**
  * Install a single git package
  */
@@ -136,10 +183,11 @@ async function installGitPackage(name, spec, outputDir, tempDir) {
  * Main install function
  */
 async function install(options) {
-  const { config, output, skipWally, force } = options;
+  const { config, output, skipWally, force, dev } = options;
   const configPath = path.resolve(config);
   const outputDir = path.resolve(output);
   const tempDir = path.join(process.cwd(), '.yllaw_temp');
+  const parentDir = path.dirname(process.cwd()); // Parent directory for dev mode
 
   // Check config exists
   if (!await fs.pathExists(configPath)) {
@@ -181,17 +229,29 @@ async function install(options) {
   if (packages.length === 0) {
     log.info('No git dependencies found');
   } else {
+    if (dev) {
+      log.info(`[DEV MODE] Looking for packages in: ${parentDir}`);
+    }
     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)) {
+      // Skip if exists and not forcing update (unless dev mode, always update in dev)
+      if (!force && !dev && await fs.pathExists(target)) {
         log.info(`${name} already exists, skipping (use 'yllaw update' to force)`);
         continue;
       }
 
+      // Dev mode: try local first
+      if (dev) {
+        const installedFromLocal = await tryInstallFromLocal(name, spec, outputDir, parentDir);
+        if (installedFromLocal) {
+          continue;
+        }
+        log.info(`[DEV] ${name} not found locally, using git`);
+      }
+
       await installGitPackage(name, spec, outputDir, tempDir);
     }
   }