vscode-behavior3 2.2.0 → 2.3.3

package/dist/extension.js

@@ -215264,10 +215264,7 @@ function customAlphabet(alphabet, size = 21) {
 
 // webview/shared/stable-id.ts
 var UUID_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-var generateUuid = customAlphabet(
-  UUID_ALPHABET,
-  10
-);
+var generateUuid = customAlphabet(UUID_ALPHABET, 10);
 var hashString = (value) => {
   let hash = 2166136261;
   for (let index = 0; index < value.length; index += 1) {
@@ -215281,7 +215278,7 @@ var generateDeterministicUuid = (seed) => {
   let result = "";
   for (let index = 0; index < 10; index += 1) {
     state = Math.imul(state ^ state >>> 16, 2246822519) >>> 0;
-    state ^= hashString(`${seed}:${index}`);
+    state = (state ^ hashString(`${seed}:${index}`)) >>> 0;
     result += UUID_ALPHABET[state % UUID_ALPHABET.length];
   }
   return result;
@@ -215375,6 +215372,12 @@ var asRequiredString = (value, label) => {
   }
   return value;
 };
+var normalizeTreeVersion = (value) => {
+  if (value === void 0) {
+    return DOCUMENT_VERSION;
+  }
+  return asRequiredString(value, "tree file version");
+};
 var asStringArray = (value, label) => {
   if (value === void 0) {
     return [];
@@ -215693,7 +215696,7 @@ var normalizeTreeData = (value, opts) => {
   const variablesValue = record.variables;
   const variablesRecord = variablesValue === void 0 ? void 0 : expectPlainRecord(variablesValue, "tree file variables");
   return {
-    version: asRequiredString(record.version, "tree file version"),
+    version: normalizeTreeVersion(record.version),
     name: asRequiredString(record.name, "tree file name"),
     prefix: asOptionalString(record.prefix) ?? "",
     desc: asOptionalString(record.desc),
@@ -215948,10 +215951,10 @@ var applyMainTreeDisplayIds = (root, idsByStableId) => {
     }
   });
 };
-var hasMissingStableIds = (content) => {
+var needsLegacyTreeWriteback = (content) => {
   try {
     const parsed = JSON.parse(content);
-    return subtreeNeedsMissingIds(parsed.root) || parsed.$override !== void 0 || parsed.import !== void 0 || parsed.vars !== void 0;
+    return parsed.version === void 0 || subtreeNeedsMissingIds(parsed.root) || parsed.$override !== void 0 || parsed.import !== void 0 || parsed.vars !== void 0;
   } catch {
     return false;
   }
@@ -215974,7 +215977,7 @@ var loadSubtreeSourceCache = async (params) => {
       return;
     }
     try {
-      const needsWriteback = hasMissingStableIds(content);
+      const needsWriteback = needsLegacyTreeWriteback(content);
       const tree = parsePersistedTreeContent(content, normalizedPath);
       cache[normalizedPath] = tree;
       await params.onTreeLoaded?.({
@@ -216464,14 +216467,15 @@ var readWorkspaceSettings = (path14) => {
   const content = getFs().readFileSync(path14, "utf-8");
   return parseWorkspaceModelContent(content).settings;
 };
-var hasBatchHookMethod = (obj) => {
+var hasBuildHookMethod = (obj) => {
   if (!obj || typeof obj !== "object") {
     return false;
   }
   const candidate = obj;
-  return typeof candidate.shouldUpgradeTree === "function" || typeof candidate.onProcessTree === "function" || typeof candidate.onProcessNode === "function" || typeof candidate.onWriteFile === "function" || typeof candidate.onComplete === "function";
+  return typeof candidate.onProcessTree === "function" || typeof candidate.onProcessNode === "function" || typeof candidate.onWriteFile === "function" || typeof candidate.onComplete === "function";
 };
 var BUILD_HOOK_MARKER = "__behavior3BuildHook";
+var BATCH_HOOK_MARKER = "__behavior3BatchHook";
 var CHECK_HOOK_MARKER = "__behavior3CheckHook";
 var CHECK_HOOK_NAME = "__behavior3CheckName";
 var markBuildHook = (ctor) => {
@@ -216481,6 +216485,13 @@ var markBuildHook = (ctor) => {
   });
   return ctor;
 };
+var markBatchHook = (ctor) => {
+  Object.defineProperty(ctor, BATCH_HOOK_MARKER, {
+    value: true,
+    configurable: false
+  });
+  return ctor;
+};
 var markCheckCtor = (ctor, explicitName) => {
   const name = explicitName?.trim() || ctor.name;
   Object.defineProperty(ctor, CHECK_HOOK_MARKER, {
@@ -216499,28 +216510,51 @@ var markCheckHook = (nameOrCtor, _context) => {
   }
   return (ctor) => markCheckCtor(ctor, nameOrCtor);
 };
-var isDecoratedHookCtor = (value) => typeof value === "function" && value[BUILD_HOOK_MARKER] === true;
+var isDecoratedBuildHookCtor = (value) => typeof value === "function" && value[BUILD_HOOK_MARKER] === true;
+var isDecoratedBatchHookCtor = (value) => typeof value === "function" && value[BATCH_HOOK_MARKER] === true;
 var isDecoratedCheckCtor = (value) => typeof value === "function" && value[CHECK_HOOK_MARKER] === true;
-var findDecoratedHookCtor = (moduleRecord) => {
-  const decorated = Array.from(new Set(Object.values(moduleRecord))).filter(isDecoratedHookCtor);
+var findDecoratedBuildHookCtor = (moduleRecord) => {
+  const decorated = Array.from(new Set(Object.values(moduleRecord))).filter(
+    isDecoratedBuildHookCtor
+  );
   if (decorated.length > 1) {
     logger.error("build script must decorate exactly one exported class with @behavior3.build");
     return void 0;
   }
   return decorated[0];
 };
+var findDecoratedBatchHookCtor = (moduleRecord) => {
+  const decorated = Array.from(new Set(Object.values(moduleRecord))).filter(
+    isDecoratedBatchHookCtor
+  );
+  if (decorated.length > 1) {
+    logger.error("batch script must decorate exactly one exported class with @behavior3.batch");
+    return void 0;
+  }
+  if (decorated.length === 1) {
+    return decorated[0];
+  }
+  const legacyDecorated = Array.from(new Set(Object.values(moduleRecord))).filter(
+    isDecoratedBuildHookCtor
+  );
+  if (legacyDecorated.length > 1) {
+    logger.error("batch script must decorate exactly one exported class with @behavior3.batch");
+    return void 0;
+  }
+  return legacyDecorated[0];
+};
 var findDecoratedCheckCtors = (moduleRecord) => Array.from(new Set(Object.values(moduleRecord))).filter(isDecoratedCheckCtor);
-var createBatchHooks = (moduleExports, env2, reportMissing = true) => {
+var createBuildHooks = (moduleExports, env2, reportMissing = true) => {
   if (!moduleExports || typeof moduleExports !== "object") {
     return void 0;
   }
   const moduleRecord = moduleExports;
-  const defaultExport = isDecoratedCheckCtor(moduleRecord.default) ? void 0 : moduleRecord.default;
-  const ctor = moduleRecord.Hook ?? findDecoratedHookCtor(moduleRecord) ?? defaultExport;
+  const defaultExport = isDecoratedCheckCtor(moduleRecord.default) || isDecoratedBatchHookCtor(moduleRecord.default) ? void 0 : moduleRecord.default;
+  const ctor = moduleRecord.BuildHook ?? moduleRecord.Hook ?? findDecoratedBuildHookCtor(moduleRecord) ?? defaultExport;
   if (typeof ctor === "function") {
     try {
       const instance = new ctor(env2);
-      if (hasBatchHookMethod(instance)) {
+      if (hasBuildHookMethod(instance)) {
         return instance;
       }
       logger.error("build hook class instance has no supported hook methods");
@@ -216530,7 +216564,32 @@ var createBatchHooks = (moduleExports, env2, reportMissing = true) => {
   }
   if (reportMissing) {
     logger.error(
-      "build script must export a Hook class, default class, or one @behavior3.build-decorated class"
+      "build script must export a BuildHook class, Hook class, default class, or one @behavior3.build-decorated class"
+    );
+  }
+  return void 0;
+};
+var createBatchHooks = (moduleExports, env2, reportMissing = true) => {
+  if (!moduleExports || typeof moduleExports !== "object") {
+    return void 0;
+  }
+  const moduleRecord = moduleExports;
+  const defaultExport = isDecoratedCheckCtor(moduleRecord.default) || isDecoratedBuildHookCtor(moduleRecord.default) || isDecoratedBatchHookCtor(moduleRecord.default) ? void 0 : moduleRecord.default;
+  const ctor = moduleRecord.BatchHook ?? findDecoratedBatchHookCtor(moduleRecord) ?? moduleRecord.Hook ?? defaultExport;
+  if (typeof ctor === "function") {
+    try {
+      const instance = new ctor(env2);
+      if (hasBuildHookMethod(instance) || typeof instance.shouldUpgradeTree === "function") {
+        return instance;
+      }
+      logger.error("batch hook class instance has no supported hook methods");
+    } catch (error) {
+      logger.error("failed to instantiate batch hook class", error);
+    }
+  }
+  if (reportMissing) {
+    logger.error(
+      "batch script must export a BatchHook class, default class, or one @behavior3.batch-decorated class"
     );
   }
   return void 0;
@@ -216579,13 +216638,13 @@ var createBuildScriptRuntime = (moduleExports, env2) => {
     };
   }
   const moduleRecord = moduleExports;
-  const hasBuildHookCandidate = typeof moduleRecord.Hook === "function" || Object.values(moduleRecord).some(isDecoratedHookCtor) || typeof moduleRecord.default === "function" && !isDecoratedCheckCtor(moduleRecord.default);
-  const buildScript = createBatchHooks(moduleExports, env2, false);
+  const hasBuildHookCandidate = typeof moduleRecord.BuildHook === "function" || typeof moduleRecord.Hook === "function" || Object.values(moduleRecord).some(isDecoratedBuildHookCtor) || typeof moduleRecord.default === "function" && !isDecoratedCheckCtor(moduleRecord.default) && !isDecoratedBatchHookCtor(moduleRecord.default);
+  const buildScript = createBuildHooks(moduleExports, env2, false);
   const checkerResult = createNodeArgCheckers(moduleExports, env2);
   const hasEntries = Boolean(buildScript) || checkerResult.hasCheckers;
   if (!hasEntries) {
     logger.error(
-      "build script must export a Hook class, default build class, @behavior3.build class, or @behavior3.check class"
+      "build script must export a BuildHook class, Hook class, default build class, @behavior3.build class, or @behavior3.check class"
     );
   }
   return {
@@ -217006,6 +217065,7 @@ var applyBehavior3DecoratorGlobal = () => {
   runtimeGlobal.behavior3 = {
     ...decoratorGlobalState.previousBehavior3 && typeof decoratorGlobalState.previousBehavior3 === "object" ? decoratorGlobalState.previousBehavior3 : {},
     build: markBuildHook,
+    batch: markBatchHook,
     check: markCheckHook
   };
 };
@@ -217026,7 +217086,7 @@ var restoreBehavior3DecoratorGlobal = () => {
   decoratorGlobalState.hadBehavior3 = false;
   decoratorGlobalState.previousBehavior3 = void 0;
 };
-var withBehavior3BuildDecoratorGlobal = async (loader) => {
+var withBehavior3ScriptDecoratorGlobal = async (loader) => {
   applyBehavior3DecoratorGlobal();
   try {
     return await loader();
@@ -217165,7 +217225,7 @@ var loadRuntimeModule = async (modulePath, options) => {
       }
     }
     if (getRuntimeProcess()?.type === "renderer") {
-      return await withBehavior3BuildDecoratorGlobal(
+      return await withBehavior3ScriptDecoratorGlobal(
         () => import(
           /* @vite-ignore */
           `${modulePath}?t=${Date.now()}`
@@ -217193,7 +217253,7 @@ var loadRuntimeModule = async (modulePath, options) => {
       return null;
     }
     const normalizedModulePath = b3path_default.posixPath(tempModulePath);
-    const result = await withBehavior3BuildDecoratorGlobal(
+    const result = await withBehavior3ScriptDecoratorGlobal(
       () => import(
         /* @vite-ignore */
         `file:///${normalizedModulePath}?t=${Date.now()}`
@@ -217507,6 +217567,14 @@ var validateExpressionEntries = (entries, usingVars, checkExpr) => {
   return null;
 };
 var getArgLabel = (arg) => arg.desc || arg.name;
+var findNodeArgOneofInputIndex = (arg, inputDefs) => {
+  if (!arg.oneof || !inputDefs?.length) {
+    return -1;
+  }
+  return inputDefs.findIndex(
+    (input, index) => parseSlotDefinition(input, inputDefs, index).label === arg.oneof
+  );
+};
 var isRequiredNodeArgValueMissing = (arg, value) => {
   if (isNodeArgOptional(arg)) {
     return false;
@@ -217621,6 +217689,28 @@ var validateNodeArgValue = (params) => {
   }
   return validateNodeArgScalarValue(arg, value, args, validateOptions);
 };
+var validateNodeArgOneof = (params) => {
+  const { arg, argValue, inputValues, inputDefs } = params;
+  if (!arg.oneof) {
+    return null;
+  }
+  const relatedInputIndex = findNodeArgOneofInputIndex(arg, inputDefs);
+  if (relatedInputIndex < 0) {
+    return {
+      code: "missing-oneof-input",
+      argName: arg.name,
+      inputLabel: arg.oneof
+    };
+  }
+  if (checkOneof(arg, argValue, inputValues?.[relatedInputIndex])) {
+    return null;
+  }
+  return {
+    code: "oneof-conflict",
+    argName: arg.name,
+    inputLabel: arg.oneof
+  };
+};
 
 // webview/shared/b3build-context.ts
 var unknownNodeDef = {
@@ -217704,6 +217794,10 @@ var formatBuildDiagnostic = (diagnostic) => {
       return `intput field '${diagnostic.label}' is required`;
     case "required-output":
       return `output field '${diagnostic.label}' is required`;
+    case "missing-oneof-input":
+      return `missing oneof input slot '${diagnostic.inputLabel}' for arg '${diagnostic.argName}'`;
+    case "oneof-conflict":
+      return `only one of arg '${diagnostic.argName}' and input '${diagnostic.inputLabel}' can be set`;
     case "invalid-arg-value": {
       const value = JSON.stringify(diagnostic.value);
       switch (diagnostic.expected) {
@@ -217744,14 +217838,15 @@ var checkNodeArg = (data, conf, i, printer) => {
   const diagnostics = validateNodeArgValue({ arg, value, args: data.args ?? {} });
   let hasError = diagnostics.length > 0;
   diagnostics.forEach((diagnostic) => error(formatBuildDiagnostic(diagnostic)));
-  if (arg.oneof !== void 0) {
-    const idx = conf.input?.findIndex((v) => v.startsWith(arg.oneof)) ?? -1;
-    if (!checkOneof(arg, data.args?.[arg.name], data.input?.[idx])) {
-      error(
-        `only one is allowed for between argument '${arg.name}' and input '${data.input?.[idx]}'`
-      );
-      hasError = true;
-    }
+  const oneofDiagnostic = validateNodeArgOneof({
+    arg,
+    argValue: value,
+    inputValues: data.input,
+    inputDefs: conf.input
+  });
+  if (oneofDiagnostic) {
+    error(formatBuildDiagnostic(oneofDiagnostic));
+    hasError = true;
   }
   return !hasError;
 };
@@ -218524,15 +218619,14 @@ async function runBatchProcess(context, resourceUri) {
   await runBatchProcessWithScript(context, workspaceFile, settingPath, projectRoot, picked[0].fsPath);
 }
 async function runBatchProcessScript(context, resourceUri) {
-  const scriptUri = resourceUri?.scheme === "file" ? resourceUri : getActiveFileUri();
+  const resourceIsFile = resourceUri?.scheme === "file";
+  const resourcePath = resourceIsFile ? resourceUri.fsPath : void 0;
+  const explicitScriptUri = resourcePath && isSupportedBatchScriptPath(resourcePath) ? resourceUri : void 0;
+  const activeFileUri = getActiveFileUri();
+  const activeScriptUri = activeFileUri && isSupportedBatchScriptPath(activeFileUri.fsPath) ? activeFileUri : void 0;
+  const scriptUri = explicitScriptUri ?? (!resourceUri ? activeScriptUri : void 0);
   if (!scriptUri) {
-    void vscode2.window.showErrorMessage("Select a batch script file first.");
-    return;
-  }
-  if (!isSupportedBatchScriptPath(scriptUri.fsPath)) {
-    void vscode2.window.showErrorMessage(
-      "Batch script must be a .ts, .mts, .js, or .mjs file."
-    );
+    await runBatchProcess(context, resourceUri);
     return;
   }
   const folder = vscode2.workspace.getWorkspaceFolder(scriptUri) ?? vscode2.workspace.workspaceFolders?.[0];
@@ -219928,6 +220022,15 @@ function buildInitMessage(params) {
   };
 }
 
+// webview/shared/node-overrides.ts
+var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+var getNodeArgOverrideCompareValue = (args, arg) => {
+  if (args && hasOwn(args, arg.name)) {
+    return args[arg.name];
+  }
+  return arg.default;
+};
+
 // media/locales/en.json
 var en_default = {
   about: "About Behavior3",
@@ -220095,6 +220198,11 @@ var en_default = {
   "editor.newerVersionEditDenied": "This file is created by a newer version of Behavior3({{version}}). Please upgrade to the latest version.",
   "inspector.noActiveDocument": "Open a Behavior3 editor to inspect and edit the active tree.",
   "inspector.embeddedModeNotice": "Inspector is configured to appear inside the Behavior3 editor.",
+  "inspector.embeddedToolbar.build": "Build Behavior Tree",
+  "inspector.embeddedToolbar.toggleEditorMode": "Toggle Editor Mode",
+  "inspector.embeddedToolbar.toggleInspectorNodeJson": "Toggle Raw Node JSON",
+  "inspector.embeddedToolbar.createProject": "Create Project",
+  "inspector.embeddedToolbar.createTree": "Create Behavior Tree",
   "mutation.invalidJsonPath": "Invalid JSON path: {{path}}",
   "mutation.missingSelectedNode": "No selected node is available for this mutation.",
   "mutation.selectedNodeMismatch": "The selected node changed before the mutation was applied.",
@@ -220298,6 +220406,11 @@ var zh_default = {
   "editor.newerVersionEditDenied": "\u6B64\u6587\u4EF6\u7531\u65B0\u7248\u672C Behavior3({{version}}) \u521B\u5EFA\uFF0C\u8BF7\u5347\u7EA7\u5230\u6700\u65B0\u7248\u672C\u540E\u518D\u7F16\u8F91\u3002",
   "inspector.noActiveDocument": "\u6253\u5F00\u4E00\u4E2A Behavior3 \u7F16\u8F91\u5668\u540E\uFF0C\u8FD9\u91CC\u4F1A\u663E\u793A\u5F53\u524D\u884C\u4E3A\u6811\u7684 Inspector\uFF0C\u5E76\u652F\u6301\u76F4\u63A5\u7F16\u8F91\u3002",
   "inspector.embeddedModeNotice": "Inspector \u5F53\u524D\u914D\u7F6E\u4E3A\u5728 Behavior3 \u7F16\u8F91\u5668\u5185\u90E8\u663E\u793A\u3002",
+  "inspector.embeddedToolbar.build": "\u6784\u5EFA\u884C\u4E3A\u6811",
+  "inspector.embeddedToolbar.toggleEditorMode": "\u5207\u6362\u7F16\u8F91\u5668\u6A21\u5F0F",
+  "inspector.embeddedToolbar.toggleInspectorNodeJson": "\u5207\u6362\u539F\u59CB\u8282\u70B9 JSON",
+  "inspector.embeddedToolbar.createProject": "\u65B0\u5EFA\u9879\u76EE",
+  "inspector.embeddedToolbar.createTree": "\u65B0\u5EFA\u884C\u4E3A\u6811",
   "mutation.invalidJsonPath": "\u65E0\u6548\u7684 JSON \u8DEF\u5F84: {{path}}",
   "mutation.missingSelectedNode": "\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u4E8E\u63D0\u4EA4\u6B64\u4FEE\u6539\u7684\u9009\u4E2D\u8282\u70B9\u3002",
   "mutation.selectedNodeMismatch": "\u5F53\u524D\u9009\u4E2D\u8282\u70B9\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u8BD5\u3002",
@@ -220448,8 +220561,8 @@ var computeNodeOverride = (original, edited, def) => {
   if (def?.args?.length) {
     const diffArgs = {};
     for (const arg of def.args) {
-      const originalValue = original.args?.[arg.name];
-      const editedValue = edited.args?.[arg.name];
+      const originalValue = getNodeArgOverrideCompareValue(original.args, arg);
+      const editedValue = getNodeArgOverrideCompareValue(edited.args, arg);
       if (!isJsonEqual(originalValue, editedValue)) {
         diffArgs[arg.name] = editedValue;
       }
@@ -221243,6 +221356,9 @@ function createSessionDispatcher({
           buildScriptDebug: msg.buildScriptDebug
         }).then(void 0, logAsyncRuntimeError("command:behavior3.build"));
         return;
+      case "runInspectorCommand":
+        void vscode14.commands.executeCommand(msg.command).then(void 0, logAsyncRuntimeError(`command:${msg.command}`));
+        return;
       case "validateNodeChecks":
         await handleValidateNodeChecksMessage(msg, reply);
         return;
@@ -222954,11 +223070,154 @@ function createLogOutputChannelLogger(out) {
   };
 }
 
+// src/script-scaffold.ts
+var SCRIPT_FILE_EXTENSION_RE = /\.(ts|mts|js|mjs)$/i;
+var INVALID_FILE_NAME_RE = /[\/\\:*?"<>|]/;
+var DEFAULT_BASE_NAMES = {
+  build: "build",
+  batch: "batch",
+  checker: "checker"
+};
+function getScriptScaffoldDefaultBaseName(kind) {
+  return DEFAULT_BASE_NAMES[kind];
+}
+function normalizeScriptScaffoldBaseName(value) {
+  return value.trim();
+}
+function validateScriptScaffoldBaseName(value) {
+  const normalized = normalizeScriptScaffoldBaseName(value);
+  if (!normalized) {
+    return "Name cannot be empty";
+  }
+  if (INVALID_FILE_NAME_RE.test(normalized)) {
+    return "Name contains invalid characters";
+  }
+  if (SCRIPT_FILE_EXTENSION_RE.test(normalized)) {
+    return "Enter the name without an extension";
+  }
+  return null;
+}
+function createScriptScaffoldFileName(baseName) {
+  return `${normalizeScriptScaffoldBaseName(baseName)}.ts`;
+}
+function createScriptScaffoldContent(kind, baseName) {
+  switch (kind) {
+    case "build":
+      return createBuildScriptContent(baseName);
+    case "batch":
+      return createBatchScriptContent(baseName);
+    case "checker":
+      return createCheckerScriptContent(baseName);
+  }
+}
+function createBuildScriptContent(baseName) {
+  const className = ensureSuffix(toPascalIdentifier(baseName), "Script");
+  return [
+    'import type { BuildEnv, BuildScript, NodeData, TreeData } from "vscode-behavior3/build";',
+    "",
+    "@behavior3.build",
+    `export class ${className} implements BuildScript {`,
+    "    constructor(private readonly env: BuildEnv) {}",
+    "",
+    "    onProcessTree(tree: TreeData, _path: string, _errors: string[]) {",
+    "        return tree;",
+    "    }",
+    "",
+    "    onProcessNode(node: NodeData, _errors: string[]) {",
+    "        return node;",
+    "    }",
+    "",
+    '    onComplete(status: "success" | "failure") {',
+    "        this.env.logger.info(`build ${status}`);",
+    "    }",
+    "}",
+    ""
+  ].join("\n");
+}
+function createBatchScriptContent(baseName) {
+  const className = ensureSuffix(toPascalIdentifier(baseName), "Script");
+  return [
+    'import type { BatchScript, BuildEnv, NodeData, TreeData } from "vscode-behavior3/build";',
+    "",
+    "@behavior3.batch",
+    `export class ${className} implements BatchScript {`,
+    "    constructor(private readonly env: BuildEnv) {}",
+    "",
+    "    shouldUpgradeTree(_path: string, _tree: TreeData) {",
+    "        return false;",
+    "    }",
+    "",
+    "    onProcessTree(tree: TreeData, _path: string, _errors: string[]) {",
+    "        return tree;",
+    "    }",
+    "",
+    "    onProcessNode(node: NodeData, _errors: string[]) {",
+    "        return node;",
+    "    }",
+    "",
+    '    onComplete(status: "success" | "failure") {',
+    "        this.env.logger.info(`batch ${status}`);",
+    "    }",
+    "}",
+    ""
+  ].join("\n");
+}
+function createCheckerScriptContent(baseName) {
+  const className = ensureSuffix(toPascalIdentifier(baseName), "Checker");
+  const checkerName = toCheckerRegistrationName(baseName);
+  return [
+    'import type { NodeArgCheckContext } from "vscode-behavior3/build";',
+    "",
+    `@behavior3.check("${checkerName}")`,
+    `export class ${className} {`,
+    "    validate(value: unknown, ctx: NodeArgCheckContext) {",
+    '        if (value === undefined || value === null || value === "") {',
+    "            return;",
+    "        }",
+    '        if (typeof value !== "number") {',
+    "            return `${ctx.argName} must be a number`;",
+    "        }",
+    "        if (value <= 0) {",
+    "            return `${ctx.argName} must be greater than 0`;",
+    "        }",
+    "    }",
+    "}",
+    ""
+  ].join("\n");
+}
+function toPascalIdentifier(value) {
+  const source = normalizeScriptScaffoldBaseName(value).replace(SCRIPT_FILE_EXTENSION_RE, "");
+  const tokens = source.match(/[A-Za-z0-9]+/g) ?? [];
+  const joined = tokens.map((token) => token.charAt(0).toUpperCase() + token.slice(1)).join("");
+  if (!joined) {
+    return "Generated";
+  }
+  if (/^[A-Za-z_$]/.test(joined)) {
+    return joined;
+  }
+  return `Generated${joined}`;
+}
+function ensureSuffix(value, suffix) {
+  return value.toLowerCase().endsWith(suffix.toLowerCase()) ? value : `${value}${suffix}`;
+}
+function toCheckerRegistrationName(value) {
+  const normalized = normalizeScriptScaffoldBaseName(value).replace(SCRIPT_FILE_EXTENSION_RE, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized || "checker";
+}
+
 // src/extension.ts
 var getVSCodeTheme2 = () => {
   const kind = vscode23.window.activeColorTheme.kind;
   return kind === vscode23.ColorThemeKind.Light || kind === vscode23.ColorThemeKind.HighContrastLight ? "light" : "dark";
 };
+var getActiveBehaviorTreeEditorUri = () => {
+  const tab = vscode23.window.tabGroups.activeTabGroup.activeTab;
+  const input = tab?.input;
+  if (!(input instanceof vscode23.TabInputCustom) || input.viewType !== TreeEditorProvider.viewType) {
+    return null;
+  }
+  return input.uri;
+};
 function activate(context) {
   const config = vscode23.workspace.getConfiguration("behavior3");
   const inspectorMode = config.get("inspectorMode", "sidebar");
@@ -223006,27 +223265,35 @@ function activate(context) {
     inspectorCoordinator.setActiveDocument(documentUri);
   };
   syncActiveInspectorDocument();
-  context.subscriptions.push(vscode23.window.tabGroups.onDidChangeTabs(() => {
-    syncActiveInspectorDocument();
-  }));
-  context.subscriptions.push(vscode23.window.tabGroups.onDidChangeTabGroups(() => {
-    syncActiveInspectorDocument();
-  }));
-  context.subscriptions.push(vscode23.window.onDidChangeActiveColorTheme(() => {
-    inspectorCoordinator.setTheme(getVSCodeTheme2());
-  }));
-  context.subscriptions.push(vscode23.workspace.onDidChangeConfiguration((event) => {
-    if (!event.affectsConfiguration("behavior3.inspectorMode")) {
-      return;
-    }
-    const nextInspectorMode = vscode23.workspace.getConfiguration("behavior3").get("inspectorMode", "sidebar");
-    inspectorCoordinator.setInspectorMode(nextInspectorMode);
-    void vscode23.commands.executeCommand(
-      "setContext",
-      "behavior3.inspectorSidebarMode",
-      nextInspectorMode === "sidebar"
-    );
-  }));
+  context.subscriptions.push(
+    vscode23.window.tabGroups.onDidChangeTabs(() => {
+      syncActiveInspectorDocument();
+    })
+  );
+  context.subscriptions.push(
+    vscode23.window.tabGroups.onDidChangeTabGroups(() => {
+      syncActiveInspectorDocument();
+    })
+  );
+  context.subscriptions.push(
+    vscode23.window.onDidChangeActiveColorTheme(() => {
+      inspectorCoordinator.setTheme(getVSCodeTheme2());
+    })
+  );
+  context.subscriptions.push(
+    vscode23.workspace.onDidChangeConfiguration((event) => {
+      if (!event.affectsConfiguration("behavior3.inspectorMode")) {
+        return;
+      }
+      const nextInspectorMode = vscode23.workspace.getConfiguration("behavior3").get("inspectorMode", "sidebar");
+      inspectorCoordinator.setInspectorMode(nextInspectorMode);
+      void vscode23.commands.executeCommand(
+        "setContext",
+        "behavior3.inspectorSidebarMode",
+        nextInspectorMode === "sidebar"
+      );
+    })
+  );
   const autoCheckedJsonWhileOpen = /* @__PURE__ */ new Set();
   const autoOpeningJsonUris = /* @__PURE__ */ new Set();
   const skipNextAutoOpenUris = /* @__PURE__ */ new Set();
@@ -223070,14 +223337,35 @@ function activate(context) {
   );
   context.subscriptions.push(
     vscode23.commands.registerCommand("behavior3.toggleInspectorNodeJson", async () => {
+      const activeEditorUri = getActiveBehaviorTreeEditorUri();
+      const activeInspectorMode = vscode23.workspace.getConfiguration("behavior3").get("inspectorMode", "sidebar");
+      if (activeInspectorMode === "embedded" && activeEditorUri) {
+        TreeEditorProvider.postMessageToDocument(activeEditorUri.toString(), {
+          type: "toggleInspectorNodeJson"
+        });
+        return;
+      }
       inspectorCoordinator.toggleNodeJsonView();
     })
   );
   context.subscriptions.push(
-    vscode23.commands.registerCommand("behavior3.batchProcess", async (uri) => {
-      await runBatchProcess(context, uri);
+    vscode23.commands.registerCommand("behavior3.createBuildScript", async (uri) => {
+      await createBehavior3Script("build", uri);
     })
   );
+  context.subscriptions.push(
+    vscode23.commands.registerCommand("behavior3.createBatchScript", async (uri) => {
+      await createBehavior3Script("batch", uri);
+    })
+  );
+  context.subscriptions.push(
+    vscode23.commands.registerCommand(
+      "behavior3.createCheckerScript",
+      async (uri) => {
+        await createBehavior3Script("checker", uri);
+      }
+    )
+  );
   context.subscriptions.push(
     vscode23.commands.registerCommand(
       "behavior3.runBatchProcessScript",
@@ -223292,6 +223580,62 @@ function activate(context) {
 }
 function deactivate() {
 }
+async function createBehavior3Script(kind, uri) {
+  const folderUri = await resolveFolderTargetUri(uri);
+  if (!folderUri) {
+    void vscode23.window.showErrorMessage("Please open a workspace folder first.");
+    return;
+  }
+  const baseName = await vscode23.window.showInputBox({
+    prompt: `Enter ${getScriptScaffoldPromptLabel(kind)} file name (without extension)`,
+    placeHolder: getScriptScaffoldDefaultBaseName(kind),
+    value: getScriptScaffoldDefaultBaseName(kind),
+    validateInput: validateScriptScaffoldBaseName
+  });
+  if (!baseName) {
+    return;
+  }
+  const normalizedBaseName = normalizeScriptScaffoldBaseName(baseName);
+  const fileName = createScriptScaffoldFileName(normalizedBaseName);
+  const fileUri = vscode23.Uri.file(path13.join(folderUri.fsPath, fileName));
+  if (fs8.existsSync(fileUri.fsPath)) {
+    void vscode23.window.showErrorMessage(`File already exists: ${fileName}`);
+    return;
+  }
+  try {
+    await fs8.promises.writeFile(
+      fileUri.fsPath,
+      createScriptScaffoldContent(kind, normalizedBaseName),
+      "utf-8"
+    );
+    await vscode23.window.showTextDocument(fileUri);
+  } catch (e) {
+    void vscode23.window.showErrorMessage(
+      `Failed to create file: ${e instanceof Error ? e.message : e}`
+    );
+  }
+}
+async function resolveFolderTargetUri(uri) {
+  if (uri?.scheme === "file") {
+    try {
+      const stat = await vscode23.workspace.fs.stat(uri);
+      return stat.type === vscode23.FileType.Directory ? uri : vscode23.Uri.file(path13.dirname(uri.fsPath));
+    } catch {
+      return void 0;
+    }
+  }
+  return vscode23.workspace.workspaceFolders?.[0]?.uri;
+}
+function getScriptScaffoldPromptLabel(kind) {
+  switch (kind) {
+    case "build":
+      return "build script";
+    case "batch":
+      return "batch script";
+    case "checker":
+      return "checker script";
+  }
+}
 async function tryAutoOpenBehaviorEditor(uri, autoCheckedJsonWhileOpen, autoOpeningJsonUris, skipNextAutoOpenUris) {
   if (uri.scheme !== "file") {
     return;