@kamaras/venpm 0.0.1 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kamaras
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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
+AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -0,0 +1,204 @@
+<p align="center">
+  <img src="https://venpm.dev/logo.svg" alt="venpm" width="80" />
+</p>
+
+<h1 align="center">venpm</h1>
+
+<p align="center">
+  <strong>The package manager for Vencord userplugins.</strong><br/>
+  Install, update, and manage plugins from decentralized JSON indexes.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@kamaras/venpm"><img src="https://img.shields.io/npm/v/@kamaras/venpm?color=f97316&label=npm" alt="npm version" /></a>
+  <a href="https://github.com/theokyr/venpm/actions"><img src="https://img.shields.io/github/actions/workflow/status/theokyr/venpm/ci.yml?label=tests&color=34d399" alt="CI" /></a>
+  <a href="https://venpm.dev"><img src="https://img.shields.io/badge/docs-venpm.dev-f97316" alt="docs" /></a>
+  <a href="https://github.com/theokyr/venpm/blob/master/LICENSE"><img src="https://img.shields.io/github/license/theokyr/venpm?color=94a3b8" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-94a3b8" alt="node >= 18" /></a>
+</p>
+
+---
+
+## Why venpm?
+
+Vencord's userplugin ecosystem is powerful but fragmented. Plugin authors host code in personal repos, users manually clone and rebuild, and there's no dependency resolution, no update tracking, and no discoverability.
+
+**venpm fixes this.** Authors publish a small `plugins.json` index alongside their code. Users install plugins with a single command. venpm handles dependencies, version pinning, sparse git checkouts, and Vencord rebuilds automatically.
+
+```
+venpm install minimalCallBar
+  Resolved minimalCallBar@0.1.0 from kamaras-plugins
+  Optional: settingsHub, channelTabs (install with venpm install <name>)
+  Fetching via git (sparse checkout)...
+  Installed minimalCallBar@0.1.0
+  Rebuilding Vencord... done
+```
+
+## Install
+
+```bash
+npm install -g @kamaras/venpm
+```
+
+Or run without installing:
+
+```bash
+npx @kamaras/venpm doctor
+```
+
+## Quick Start
+
+```bash
+# Check your environment
+venpm doctor
+
+# Point venpm at your Vencord install
+venpm config set vencord.path ~/Vencord
+
+# Add a plugin repository
+venpm repo add https://example.com/plugins.json
+
+# Find and install plugins
+venpm search betterFolders
+venpm install BetterFolders
+venpm list
+venpm update
+venpm rebuild
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `venpm install <plugin>` | Install a plugin and its dependencies |
+| `venpm uninstall <plugin>` | Remove a plugin (warns about reverse deps) |
+| `venpm update [plugin]` | Update one or all plugins |
+| `venpm list` | Show installed plugins |
+| `venpm search <query>` | Search across all configured repos |
+| `venpm info <plugin>` | Show plugin details |
+| `venpm repo add\|remove\|list` | Manage plugin index repositories |
+| `venpm config set\|get\|path` | View or edit venpm configuration |
+| `venpm create <path>` | Scaffold a new plugin repo or plugin |
+| `venpm rebuild` | Rebuild Vencord after changes |
+| `venpm doctor` | Diagnose environment issues |
+| `venpm validate [path]` | Validate a `plugins.json` index file |
+
+**Global flags:** `--yes` (auto-confirm), `--verbose`, `--quiet`, `--json` (structured output)
+
+## How It Works
+
+```
+  Author                          User
+  ------                          ----
+  plugins.json  ──publish──>  venpm repo add <url>
+       |                          |
+       v                          v
+  GitHub / any URL            venpm install <plugin>
+                                  |
+                              resolve deps
+                              fetch (git sparse checkout / tarball)
+                              update lockfile
+                              rebuild Vencord
+```
+
+1. **Authors** publish a [`plugins.json`](https://venpm.dev/author/plugin-index) index file — a JSON document describing their plugins, versions, and sources.
+2. **Users** register that URL with `venpm repo add`.
+3. **venpm** resolves the full dependency graph, fetches via git (with sparse checkout for monorepos) or tarball, updates the lockfile, and optionally rebuilds Vencord.
+
+## For Plugin Authors
+
+```bash
+# Scaffold a new plugin repository
+venpm create my-plugins
+
+# Scaffold a plugin inside an existing repo
+venpm create my-plugins/MyPlugin
+
+# Validate your index before publishing
+venpm validate plugins.json --strict
+```
+
+venpm ships a **GitHub Action** for automated index publishing:
+
+```yaml
+- uses: theokyr/venpm/actions/publish-index@master
+```
+
+See the [Author Guide](https://venpm.dev/author/your-first-plugin) for the full walkthrough.
+
+### Plugin Index Spec
+
+The [JSON Schema](https://venpm.dev/schemas/v1/plugins.json) defines the index format. Key features:
+
+- **Dependencies & optional dependencies** with automatic resolution
+- **Monorepo support** via `source.git` + `source.path` (sparse checkout)
+- **Multiple source types:** git, tarball, local symlink
+- **Version pinning** with `versions` map of tag/tarball pairs
+- **Informational constraints** for Discord and Vencord versions
+
+## Architecture
+
+```
+src/
+  core/           Pure logic + I/O interfaces (never imports from cli/)
+    types.ts        All interfaces: IOContext, PluginIndex, Config, Lockfile
+    resolver.ts     Version resolution, dependency graph, topological sort
+    registry.ts     Fetch + parse + cache plugin indexes
+    fetcher.ts      Git clone (sparse checkout), tarball extract, local symlink
+    builder.ts      Vencord pnpm build, deploy, Discord restart
+    ...             config, lockfile, schema, detect, cache, paths, prompt, log
+  cli/            Command handlers (compose core modules)
+    context.ts      createRealIOContext() — wires real Node.js I/O
+    install.ts      uninstall.ts  update.ts  list.ts  search.ts  ...
+  index.ts        CLI entry point (commander)
+schemas/v1/       JSON Schemas — the primary deliverable
+actions/          GitHub Action for plugin repo authors
+```
+
+**Design principle:** All I/O is injected via `IOContext` — filesystem, HTTP, git, shell, prompts, logging. Core modules never import `fs`, `fetch`, or `child_process` directly. This makes the entire core testable with pure mocks.
+
+## Development
+
+```bash
+git clone https://github.com/theokyr/venpm.git && cd venpm
+node scripts/setup.mjs    # install, build, link globally
+```
+
+```bash
+npm run dev                # watch mode (live global updates)
+npm test                   # 240 tests
+npm run lint               # type check (tsc --noEmit)
+npm run build              # one-shot compile
+```
+
+### Test Suite
+
+240 tests across three layers:
+
+| Layer | What it tests |
+|-------|---------------|
+| **Unit** | Pure functions — resolver, registry, config, lockfile, schema, detect, cache |
+| **Integration** | Full command flows with mocked IOContext |
+| **E2E** | Compiled CLI as a subprocess against real temp directories |
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
+
+## Config & State
+
+venpm stores configuration in a single XDG-compliant directory:
+
+| OS | Path |
+|----|------|
+| Linux | `~/.config/venpm/` |
+| macOS | `~/Library/Application Support/venpm/` |
+| Windows | `%APPDATA%\venpm\` |
+
+Files: `config.json`, `venpm-lock.json`, `index-cache.json`
+
+## Documentation
+
+Full documentation at **[venpm.dev](https://venpm.dev)** — guides, author documentation, API reference, and TypeDoc-generated internals.
+
+## License
+
+[MIT](LICENSE)

package/actions/publish-index/action.yml

@@ -0,0 +1,50 @@
+name: "venpm Publish Index"
+description: "Validate and publish a venpm plugin index as a GitHub Release"
+
+inputs:
+  index-path:
+    description: "Path to plugins.json"
+    required: false
+    default: "plugins.json"
+  strict:
+    description: "Run strict validation (check URLs, deps)"
+    required: false
+    default: "true"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: "18"
+
+    - name: Validate index
+      shell: bash
+      run: |
+        STRICT_FLAG=""
+        if [ "${{ inputs.strict }}" = "true" ]; then
+          STRICT_FLAG="--strict"
+        fi
+        npx venpm validate "${{ inputs.index-path }}" $STRICT_FLAG
+
+    - name: Create plugin tarballs
+      shell: bash
+      run: |
+        PLUGINS_DIR=$(dirname "${{ inputs.index-path }}")/plugins
+        if [ -d "$PLUGINS_DIR" ]; then
+          mkdir -p dist
+          for plugin_dir in "$PLUGINS_DIR"/*/; do
+            plugin_name=$(basename "$plugin_dir")
+            tar -czf "dist/${plugin_name}.tar.gz" -C "$PLUGINS_DIR" "$plugin_name"
+            echo "Created dist/${plugin_name}.tar.gz"
+          done
+        fi
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: venpm-release
+        path: |
+          ${{ inputs.index-path }}
+          dist/*.tar.gz

package/dist/cli/config-cmd.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config-cmd.d.ts.map

package/dist/cli/config-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/config-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiE5D"}

package/dist/cli/config-cmd.js

@@ -0,0 +1,101 @@
+import { loadConfig, saveConfig } from "../core/config.js";
+import { getConfigPath, getConfigDir } from "../core/paths.js";
+import { jsonSuccess, jsonError, writeJson } from "../core/json.js";
+import { createRealIOContext } from "./context.js";
+function getNestedValue(obj, keys) {
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function setNestedValue(obj, keys, value) {
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] === null || current[key] === undefined || typeof current[key] !== "object") {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}
+function coerceValue(raw) {
+    if (raw === "null")
+        return null;
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    // Try JSON parse for numbers/arrays/objects
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+export function registerConfigCommand(program) {
+    const config = program
+        .command("config")
+        .description("View or edit venpm configuration");
+    config
+        .command("set <key> <value>")
+        .description("Set a configuration value (dotted key path)")
+        .action(async (key, value) => {
+        const parentOpts = program.opts();
+        const ctx = createRealIOContext(parentOpts);
+        const configPath = parentOpts.config ?? getConfigPath();
+        const cfg = await loadConfig(ctx.fs, configPath);
+        const keys = key.split(".");
+        const coerced = coerceValue(value);
+        setNestedValue(cfg, keys, coerced);
+        await saveConfig(ctx.fs, configPath, cfg);
+        if (parentOpts.json) {
+            writeJson(jsonSuccess({ key, value: coerced }));
+            return;
+        }
+        ctx.logger.success(`Set ${key} = ${JSON.stringify(coerced)}`);
+    });
+    config
+        .command("get <key>")
+        .description("Get a configuration value (dotted key path)")
+        .action(async (key) => {
+        const parentOpts = program.opts();
+        const ctx = createRealIOContext(parentOpts);
+        const configPath = parentOpts.config ?? getConfigPath();
+        const cfg = await loadConfig(ctx.fs, configPath);
+        const keys = key.split(".");
+        const value = getNestedValue(cfg, keys);
+        if (value === undefined) {
+            if (parentOpts.json) {
+                writeJson(jsonError(`Key "${key}" not found in config`));
+                return;
+            }
+            ctx.logger.error(`Key "${key}" not found in config`);
+            process.exitCode = 1;
+            return;
+        }
+        if (parentOpts.json) {
+            writeJson(jsonSuccess({ key, value }));
+            return;
+        }
+        ctx.logger.info(JSON.stringify(value, null, 2));
+    });
+    config
+        .command("path")
+        .description("Print the venpm config directory path")
+        .action(() => {
+        const parentOpts = program.opts();
+        if (parentOpts.json) {
+            writeJson(jsonSuccess({ path: getConfigDir() }));
+            return;
+        }
+        const ctx = createRealIOContext(parentOpts);
+        ctx.logger.info(getConfigDir());
+    });
+}
+//# sourceMappingURL=config-cmd.js.map

package/dist/cli/config-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.js","sourceRoot":"","sources":["../../src/cli/config-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,3 @@
+import type { IOContext, GlobalOptions } from "../core/types.js";
+export declare function createRealIOContext(options: GlobalOptions): IOContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAkD,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAgKrE"}

package/dist/cli/context.js

@@ -0,0 +1,153 @@
+import { execFile as _execFile, spawn as _spawn } from "node:child_process";
+import { promisify } from "node:util";
+import * as fsPromises from "node:fs/promises";
+import { createPrompter } from "../core/prompt.js";
+import { createLogger } from "../core/log.js";
+const execFileAsync = promisify(_execFile);
+export function createRealIOContext(options) {
+    const fs = {
+        async readFile(path, encoding) {
+            return fsPromises.readFile(path, { encoding });
+        },
+        async writeFile(path, data, encoding) {
+            return fsPromises.writeFile(path, data, { encoding: encoding ?? "utf8" });
+        },
+        async exists(path) {
+            try {
+                await fsPromises.access(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async mkdir(path, opts) {
+            await fsPromises.mkdir(path, opts);
+        },
+        async rm(path, opts) {
+            await fsPromises.rm(path, opts);
+        },
+        async symlink(target, path) {
+            return fsPromises.symlink(target, path);
+        },
+        async readlink(path) {
+            return fsPromises.readlink(path);
+        },
+        async readdir(path) {
+            return fsPromises.readdir(path);
+        },
+        async stat(path) {
+            return fsPromises.stat(path);
+        },
+        async lstat(path) {
+            return fsPromises.lstat(path);
+        },
+        async copyDir(src, dest) {
+            await fsPromises.cp(src, dest, { recursive: true });
+        },
+    };
+    const http = {
+        async fetch(url, fetchOptions) {
+            const res = await globalThis.fetch(url, { headers: fetchOptions?.headers });
+            return {
+                ok: res.ok,
+                status: res.status,
+                headers: res.headers,
+                text: () => res.text(),
+                json: () => res.json(),
+                arrayBuffer: () => res.arrayBuffer(),
+            };
+        },
+    };
+    const git = {
+        async available() {
+            try {
+                await execFileAsync("git", ["--version"]);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async clone(url, dest, cloneOptions) {
+            const args = ["clone", "--filter=blob:none"];
+            if (cloneOptions?.sparse && cloneOptions.sparse.length > 0) {
+                args.push("--sparse");
+            }
+            if (cloneOptions?.branch) {
+                args.push("--branch", cloneOptions.branch);
+            }
+            if (cloneOptions?.depth !== undefined) {
+                args.push("--depth", String(cloneOptions.depth));
+            }
+            args.push(url, dest);
+            await execFileAsync("git", args);
+            if (cloneOptions?.sparse && cloneOptions.sparse.length > 0) {
+                await execFileAsync("git", ["-C", dest, "sparse-checkout", "set", ...cloneOptions.sparse]);
+            }
+        },
+        async pull(repoPath) {
+            await execFileAsync("git", ["-C", repoPath, "pull"]);
+        },
+        async revParse(repoPath, ref) {
+            const { stdout } = await execFileAsync("git", ["-C", repoPath, "rev-parse", ref]);
+            return stdout.trim();
+        },
+        async checkout(repoPath, ref) {
+            await execFileAsync("git", ["-C", repoPath, "checkout", ref]);
+        },
+    };
+    const shell = {
+        async exec(cmd, args, execOptions) {
+            try {
+                const { stdout, stderr } = await execFileAsync(cmd, args, {
+                    cwd: execOptions?.cwd,
+                    env: execOptions?.env ? { ...process.env, ...execOptions.env } : undefined,
+                });
+                return { stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 };
+            }
+            catch (err) {
+                const e = err;
+                return {
+                    stdout: e.stdout ?? "",
+                    stderr: e.stderr ?? "",
+                    exitCode: e.code ?? 1,
+                };
+            }
+        },
+        async spawn(cmd, args, spawnOptions) {
+            return new Promise((resolve, reject) => {
+                const child = _spawn(cmd, args, {
+                    cwd: spawnOptions?.cwd,
+                    detached: spawnOptions?.detached,
+                    env: spawnOptions?.env ? { ...process.env, ...spawnOptions.env } : undefined,
+                    stdio: "inherit",
+                });
+                if (spawnOptions?.detached) {
+                    child.unref();
+                    resolve();
+                }
+                else {
+                    child.on("close", (code) => {
+                        if (code === 0)
+                            resolve();
+                        else
+                            reject(new Error(`${cmd} exited with code ${code}`));
+                    });
+                    child.on("error", reject);
+                }
+            });
+        },
+    };
+    const nonInteractive = !process.stdin.isTTY && !options.yes && !options.json;
+    const prompter = createPrompter({
+        yes: options.yes || options.json || false,
+        nonInteractive,
+    });
+    const logger = createLogger({
+        verbose: options.verbose ?? false,
+        quiet: options.quiet ?? false,
+    });
+    return { fs, http, git, shell, prompter, logger };
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;AAE3C,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACtD,MAAM,EAAE,GAAe;QACnB,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAwB;YACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAY,EAAE,QAAyB;YACjE,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAY;YACrB,IAAI,CAAC;gBACD,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAA8B;YACpD,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,EAAE,CAAC,IAAY,EAAE,IAA+C;YAClE,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,IAAY;YACtC,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAAY;YACvB,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAY;YACtB,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAY;YACnB,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAY;YACpB,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,IAAY;YACnC,MAAM,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;KACJ,CAAC;IAEF,MAAM,IAAI,GAAe;QACrB,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,YAAmD;YACxE,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5E,OAAO;gBACH,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;gBACtB,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAsB;gBAC1C,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE;aACvC,CAAC;QACN,CAAC;KACJ,CAAC;IAEF,MAAM,GAAG,GAAc;QACnB,KAAK,CAAC,SAAS;YACX,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC1C,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAY,EAAE,YAAqE;YACxG,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAC7C,IAAI,YAAY,EAAE,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,YAAY,EAAE,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,YAAY,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACrB,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAEjC,IAAI,YAAY,EAAE,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/F,CAAC;QACL,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,QAAgB;YACvB,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,GAAW;YACxC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;YAClF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,GAAW;YACxC,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;KACJ,CAAC;IAEF,MAAM,KAAK,GAAgB;QACvB,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAc,EAAE,WAA4D;YAChG,IAAI,CAAC;gBACD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE;oBACtD,GAAG,EAAE,WAAW,EAAE,GAAG;oBACrB,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;iBAC7E,CAAC,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACvE,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACpB,MAAM,CAAC,GAAG,GAA0D,CAAC;gBACrE,OAAO;oBACH,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;oBACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;oBACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;iBACxB,CAAC;YACN,CAAC;QACL,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAc,EAAE,YAAiF;YACtH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE;oBAC5B,GAAG,EAAE,YAAY,EAAE,GAAG;oBACtB,QAAQ,EAAE,YAAY,EAAE,QAAQ;oBAChC,GAAG,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;oBAC5E,KAAK,EAAE,SAAS;iBACnB,CAAC,CAAC;gBACH,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;oBACzB,KAAK,CAAC,KAAK,EAAE,CAAC;oBACd,OAAO,EAAE,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACJ,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;wBACvB,IAAI,IAAI,KAAK,CAAC;4BAAE,OAAO,EAAE,CAAC;;4BACrB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;oBAC9D,CAAC,CAAC,CAAC;oBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7E,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,IAAI,KAAK;QACzC,cAAc;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;KAChC,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC"}

package/dist/cli/create.d.ts

@@ -0,0 +1,23 @@
+import type { Command } from "commander";
+import type { FileSystem, IOContext, GlobalOptions } from "../core/types.js";
+export interface CreateOptions extends GlobalOptions {
+    tsx?: boolean;
+    css?: boolean;
+    native?: boolean;
+}
+/**
+ * Walk up ancestor directories from startPath looking for a plugins.json whose
+ * $schema contains "venpm". Returns { path, data } if found, null otherwise.
+ */
+export declare function findAncestorIndex(fs: FileSystem, startPath: string): Promise<{
+    path: string;
+    data: Record<string, unknown>;
+} | null>;
+/**
+ * Walk up ancestor directories from targetPath looking for a venpm plugins.json.
+ * Returns "plugin" if found, "repo" otherwise.
+ */
+export declare function detectCreateMode(fs: FileSystem, targetPath: string): Promise<"repo" | "plugin">;
+export declare function executeCreate(ctx: IOContext, targetPath: string, options: CreateOptions): Promise<void>;
+export declare function registerCreateCommand(program: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAM7E,MAAM,WAAW,aAAc,SAAQ,aAAa;IAChD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAsB,iBAAiB,CACnC,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBjE;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,EAAE,EAAE,UAAU,EACd,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,CAG5B;AAwLD,wBAAsB,aAAa,CAC/B,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB5D"}