spawnpack 0.1.2 → 0.1.4

package/README.md

@@ -30,17 +30,17 @@ Install Bun first:
 
 ## Install
 
-### Global install with Bun
-
-```bash
-bun add -g spawnpack
-```
-
-### Global install with npm
-
-```bash
-npm i -g spawnpack
-```
+### Global install with Bun
+
+```bash
+bun add -g spawnpack
+```
+
+### Global install with npm
+
+```bash
+npm i -g spawnpack
+```
 
 ### One-off run with Bun
 
@@ -57,24 +57,24 @@ bun run src/index.ts
 
 ## Usage
 
-```bash
-spawnpack
-```
-
-Show the installed version:
-
-```bash
-spawnpack -v
-spawnpack --version
-```
+```bash
+spawnpack
+```
+
+Show the installed version:
+
+```bash
+spawnpack -v
+spawnpack --version
+```
 
 The wizard walks through:
 
 1. Project name and author
-2. Namespace, addon identifier, and project ID
+2. Marketplace add-on structure toggle
 3. Destination folder
-4. Marketplace add-on structure toggle
-5. Scripting mode
+4. Script API setup
+5. Publisher ID and Project ID when needed
 6. Script packages
 7. `rgl` toggle
 8. Rockide toggle
@@ -88,7 +88,7 @@ Depending on your choices, Spawnpack can generate:
 - `packs/BP`
 - `packs/RP`
 - `data/scripts/main.ts`
-- `packs/BP/scripts/<namespace>/<projectId>/main.js`
+- `packs/BP/scripts/<publisher-id>/<project-id>/main.js`
 - `package.json`
 - `tsconfig.json`
 - `dprint.json`
@@ -135,7 +135,7 @@ bun run build
 The npm package is configured to publish only:
 
 - `dist/spawnpack.js`
-- `templates/CLAUDE.md`
+- `templates/CLAUDE.md`
 - `README.md`
 - `LICENSE`
 - `package.json`

package/dist/spawnpack.js

@@ -1748,7 +1748,7 @@ function generatePackageJson(config, versions) {
     scripts.check = "bun --smol packs/BP/scripts";
   }
   const packageJson = {
-    name: `${config.namespace}-${config.projectId}`,
+    name: `${config.identifier}-${config.projectId}`,
     version: PACK_VERSION2,
     private: true,
     type: "module",
@@ -1861,7 +1861,7 @@ function generateMainTs(config) {
   return `import { world } from "@minecraft/server";
 
 world.afterEvents.worldLoad.subscribe(() => {
-    console.warn("[${config.namespace}:${config.identifier}] Addon loaded!");
+    console.warn("[${config.identifier}:${config.projectId}] Addon loaded!");
 });
 `;
 }
@@ -1869,7 +1869,7 @@ function generateMainJs(config) {
   return `import { world } from "@minecraft/server";
 
 world.afterEvents.worldLoad.subscribe(() => {
-    console.warn("[${config.namespace}:${config.identifier}] Addon loaded!");
+    console.warn("[${config.identifier}:${config.projectId}] Addon loaded!");
 });
 `;
 }
@@ -1899,8 +1899,8 @@ Add your own API keys before using the MCP tools:
 
 - Exa API keys: https://dashboard.exa.ai/api-keys
 - Exa API key docs: https://exa.ai/docs/reference/team-management/create-api-key
-- Hyperbrowser signup: https://app.hyperbrowser.ai/signup
-- Hyperbrowser quickstart: https://hyperbrowser.ai/docs/quickstart
+- Browser Use API keys: https://cloud.browser-use.com/settings?tab=api-keys&new=1
+- Browser Use MCP docs: https://docs.browser-use.com/cloud/guides/mcp-server
 
 Update the placeholder values in \`.mcp.json\` with your own tokens.
 
@@ -1911,7 +1911,7 @@ Update the placeholder values in \`.mcp.json\` with your own tokens.
 
 - Behavior Pack: \`packs/BP\`
 - Resource Pack: \`packs/RP\`
-- Scripting: ${config.scripting}
+- Script API setup: ${config.scripting}
 - Script source: ${scriptSource}
 - Runtime entry: ${runtimeEntry}
 
@@ -1942,10 +1942,10 @@ The generated \`config.json\` already points the script bundle to \`${runtimeEnt
 `;
 }
 function generateBlocksJson() {
-  return {};
+  return { format_version: "1.21.40" };
 }
 function generateSoundsJson() {
-  return {};
+  return { entity_sounds: {} };
 }
 function generateSoundDefinitions() {
   return { format_version: "1.14.0", sound_definitions: {} };
@@ -2059,12 +2059,12 @@ async function generateProject(config) {
     directories.push(...BP_NAMESPACED_DIRECTORIES.map((folder) => getScopedContentDirectory(bpPath, folder, config)), ...RP_NAMESPACED_DIRECTORIES.map((folder) => getScopedContentDirectory(rpPath, folder, config)), ...RP_NAMESPACED_NESTED_DIRECTORIES.map((segments) => getScopedNestedContentDirectory(rpPath, segments, config)));
   }
   if (config.scripting === "javascript") {
-    directories.push(join(bpPath, "scripts"), join(bpPath, "scripts", config.namespace), bpScriptPath);
+    directories.push(join(bpPath, "scripts"), join(bpPath, "scripts", config.identifier), bpScriptPath);
   }
   if (config.scripting === "typescript") {
     directories.push(join(destination, "data"), dataScriptsPath);
     if (!config.useRgl) {
-      directories.push(join(bpPath, "scripts"), join(bpPath, "scripts", config.namespace), bpScriptPath);
+      directories.push(join(bpPath, "scripts"), join(bpPath, "scripts", config.identifier), bpScriptPath);
     }
   }
   await Promise.all(directories.filter(shouldCreateDirectory).map((directory) => mkdir(directory, { recursive: true })));
@@ -2117,11 +2117,10 @@ function buildMcpServers() {
         EXA_API_KEY: "YOUR_EXA_API_KEY"
       }
     },
-    hyperbrowser: {
-      command: "npx",
-      args: ["-y", "hyperbrowser-mcp"],
-      env: {
-        HYPERBROWSER_API_KEY: "YOUR_HYPERBROWSER_API_KEY"
+    "browser-use": {
+      url: "https://api.browser-use.com/v3/mcp",
+      headers: {
+        "x-browser-use-api-key": "YOUR_BROWSER_USE_API_KEY"
       }
     },
     "sequential-thinking": {
@@ -2441,7 +2440,6 @@ function showReview(config) {
     "",
     `${border}  ${import_picocolors.default.dim(padLabel("Project:"))} ${formatValue(config.projectName)}`,
     `${border}  ${import_picocolors.default.dim(padLabel("Author:"))} ${config.author ? formatValue(config.author) : import_picocolors.default.dim("—")}`,
-    `${border}  ${import_picocolors.default.dim(padLabel("Namespace:"))} ${formatValue(config.namespace)}`,
     ...config.useMarketplaceStructure ? [
       `${border}  ${import_picocolors.default.dim(padLabel("Publisher ID:"))} ${formatValue(config.identifier)}`,
       `${border}  ${import_picocolors.default.dim(padLabel("Project ID:"))} ${formatValue(config.projectId)}`,
@@ -2487,9 +2485,9 @@ function showPostGeneration(config) {
   }
   if (config.useAi) {
     usefulCommands.push("");
-    usefulCommands.push(`${teal(import_picocolors.default.bold("Note"))} ${import_picocolors.default.dim("Add your own Exa and Hyperbrowser MCP API keys in .mcp.json before using the AI tooling.")}`);
+    usefulCommands.push(`${teal(import_picocolors.default.bold("Note"))} ${import_picocolors.default.dim("Add your own Exa and Browser Use MCP API keys in .mcp.json before using the AI tooling.")}`);
     usefulCommands.push(`  ${import_picocolors.default.dim("Exa:")} ${import_picocolors.default.cyan("https://dashboard.exa.ai/api-keys")}`);
-    usefulCommands.push(`  ${import_picocolors.default.dim("Hyperbrowser:")} ${import_picocolors.default.cyan("https://app.hyperbrowser.ai/signup")}`);
+    usefulCommands.push(`  ${import_picocolors.default.dim("Browser Use:")} ${import_picocolors.default.cyan("https://cloud.browser-use.com/settings?tab=api-keys&new=1")}`);
   }
   O2.message([...nextSteps, "", ...usefulCommands].join(`
 `), {
@@ -2536,7 +2534,6 @@ async function runWizard() {
     return abortWizard();
   }
   const trimmedProjectName = projectName.trim();
-  const defaultNamespace = "sample";
   const suggestedProjectId = generateProjectId(trimmedProjectName);
   const author = await Ot({
     message: `${import_picocolors2.default.bold("Author")} ${import_picocolors2.default.dim("optional")}`,
@@ -2545,39 +2542,55 @@ async function runWizard() {
   if (q(author)) {
     return abortWizard();
   }
-  const namespace = await Ot({
-    message: `${import_picocolors2.default.bold("Namespace")} ${import_picocolors2.default.dim("used in identifiers like namespace:item_name")}`,
-    placeholder: defaultNamespace,
-    initialValue: defaultNamespace,
+  const useMarketplaceStructure = await ot2({
+    message: `${import_picocolors2.default.bold("Marketplace Add-On structure?")} ${import_picocolors2.default.dim("Nest BP/RP content under publisher_id/project_id for better coexistence")}`,
+    initialValue: false
+  });
+  if (q(useMarketplaceStructure)) {
+    return abortWizard();
+  }
+  const defaultPublisherId = sanitizeIdentifier(author.trim()) || sanitizeIdentifier(trimmedProjectName) || "sample";
+  let identifierValue = defaultPublisherId;
+  let projectIdValue = suggestedProjectId;
+  const destination = await Ot({
+    message: import_picocolors2.default.bold("Destination folder"),
+    placeholder: ".",
+    initialValue: ".",
     validate(value) {
       const trimmed = (value ?? "").trim();
       if (trimmed.length === 0) {
-        return "Namespace is required.";
+        return "Destination folder is required.";
+      }
+      if (/[<>"|?*]/.test(trimmed)) {
+        return 'Invalid characters in path (avoid < > " | ? *).';
       }
-      if (!/^[a-z0-9_]+$/.test(trimmed)) {
-        return "Use lowercase letters, numbers, and underscores only.";
+      if (trimmed.length > 200) {
+        return "Path is too long (max 200 characters).";
       }
       return;
     }
   });
-  if (q(namespace)) {
+  if (q(destination)) {
     return abortWizard();
   }
-  const namespaceValue = namespace.trim();
-  const useMarketplaceStructure = await ot2({
-    message: `${import_picocolors2.default.bold("Marketplace Add-On structure?")} ${import_picocolors2.default.dim("Nest BP/RP content under publisher_id/project_id for better coexistence")}`,
-    initialValue: false
+  const scripting = await _t({
+    message: import_picocolors2.default.bold("Scripting API"),
+    initialValue: "typescript",
+    options: [
+      { value: "none", label: "None", hint: "manifest-only addon scaffold" },
+      { value: "javascript", label: "JavaScript", hint: "script entry with JS tooling" },
+      { value: "typescript", label: "TypeScript", hint: "recommended" }
+    ]
   });
-  if (q(useMarketplaceStructure)) {
+  if (q(scripting)) {
     return abortWizard();
   }
-  let identifierValue = namespaceValue;
-  let projectIdValue = suggestedProjectId;
-  if (useMarketplaceStructure) {
+  if (useMarketplaceStructure || scripting !== "none") {
+    const publisherHint = useMarketplaceStructure ? "used for scoped folders like publisher_id/project_id" : "used for script folders and package naming";
     const publisherId = await Ot({
-      message: `${import_picocolors2.default.bold("Publisher ID")} ${import_picocolors2.default.dim("used for scoped folders like publisher_id/project_id")}`,
-      placeholder: namespaceValue,
-      initialValue: namespaceValue,
+      message: `${import_picocolors2.default.bold("Publisher ID")} ${import_picocolors2.default.dim(publisherHint)}`,
+      placeholder: defaultPublisherId,
+      initialValue: defaultPublisherId,
       validate(value) {
         const trimmed = (value ?? "").trim();
         if (trimmed.length === 0) {
@@ -2610,39 +2623,6 @@ async function runWizard() {
     }
     projectIdValue = projectId.trim();
   }
-  const destination = await Ot({
-    message: import_picocolors2.default.bold("Destination folder"),
-    placeholder: ".",
-    initialValue: ".",
-    validate(value) {
-      const trimmed = (value ?? "").trim();
-      if (trimmed.length === 0) {
-        return "Destination folder is required.";
-      }
-      if (/[<>"|?*]/.test(trimmed)) {
-        return 'Invalid characters in path (avoid < > " | ? *).';
-      }
-      if (trimmed.length > 200) {
-        return "Path is too long (max 200 characters).";
-      }
-      return;
-    }
-  });
-  if (q(destination)) {
-    return abortWizard();
-  }
-  const scripting = await _t({
-    message: import_picocolors2.default.bold("Scripting API"),
-    initialValue: "typescript",
-    options: [
-      { value: "none", label: "None", hint: "manifest-only addon scaffold" },
-      { value: "javascript", label: "JavaScript", hint: "script entry with JS tooling" },
-      { value: "typescript", label: "TypeScript", hint: "recommended" }
-    ]
-  });
-  if (q(scripting)) {
-    return abortWizard();
-  }
   let scriptPackages = { ...DEFAULT_SCRIPT_PACKAGES };
   let useRgl = false;
   if (scripting !== "none") {
@@ -2687,7 +2667,6 @@ async function runWizard() {
   const config = {
     projectName: trimmedProjectName,
     author: author.trim(),
-    namespace: namespaceValue,
     identifier: identifierValue,
     projectId: projectIdValue,
     destination: destination.trim(),

package/package.json

@@ -1,55 +1,55 @@
-{
-    "name": "spawnpack",
-    "version": "0.1.2",
-    "description": "Minecraft Bedrock addon project generator — scaffold your BP+RP in seconds",
-    "author": "veedy-dev",
-    "license": "MIT",
-    "type": "module",
-    "bin": {
-        "spawnpack": "bin/spawnpack.js"
-    },
-    "files": [
-        "bin/spawnpack.js",
-        "dist/spawnpack.js",
-        "templates/CLAUDE.md",
-        "README.md",
-        "LICENSE",
-        "package.json"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/veedy-dev/spawnpack.git"
-    },
-    "bugs": {
-        "url": "https://github.com/veedy-dev/spawnpack/issues"
-    },
-    "homepage": "https://github.com/veedy-dev/spawnpack#readme",
-    "keywords": [
-        "minecraft",
-        "bedrock",
-        "addon",
-        "generator",
-        "cli",
-        "spawnpack",
-        "regolith",
-        "rgl"
-    ],
-    "engines": {
-        "bun": ">=1.2.0"
-    },
-    "scripts": {
-        "start": "bun run src/index.ts",
-        "dev": "bun --watch src/index.ts",
-        "build": "bun build src/index.ts --outfile dist/spawnpack.js --target node",
-        "typecheck": "tsc --noEmit",
-        "prepack": "bun run typecheck && bun run build"
-    },
-    "dependencies": {
-        "@clack/prompts": "^1.2.0",
-        "picocolors": "^1.1.1"
-    },
-    "devDependencies": {
-        "@types/bun": "^1.2.0",
-        "typescript": "^5.7.0"
-    }
-}
+{
+    "name": "spawnpack",
+    "version": "0.1.4",
+    "description": "Minecraft Bedrock addon project generator — scaffold your BP+RP in seconds",
+    "author": "veedy-dev",
+    "license": "MIT",
+    "type": "module",
+    "bin": {
+        "spawnpack": "bin/spawnpack.js"
+    },
+    "files": [
+        "bin/spawnpack.js",
+        "dist/spawnpack.js",
+        "templates/CLAUDE.md",
+        "README.md",
+        "LICENSE",
+        "package.json"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/veedy-dev/spawnpack.git"
+    },
+    "bugs": {
+        "url": "https://github.com/veedy-dev/spawnpack/issues"
+    },
+    "homepage": "https://github.com/veedy-dev/spawnpack#readme",
+    "keywords": [
+        "minecraft",
+        "bedrock",
+        "addon",
+        "generator",
+        "cli",
+        "spawnpack",
+        "regolith",
+        "rgl"
+    ],
+    "engines": {
+        "bun": ">=1.2.0"
+    },
+    "scripts": {
+        "start": "bun run src/index.ts",
+        "dev": "bun --watch src/index.ts",
+        "build": "bun build src/index.ts --outfile dist/spawnpack.js --target node",
+        "typecheck": "tsc --noEmit",
+        "prepack": "bun run typecheck && bun run build"
+    },
+    "dependencies": {
+        "@clack/prompts": "^1.2.0",
+        "picocolors": "^1.1.1"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.2.0",
+        "typescript": "^5.7.0"
+    }
+}