vscode-behavior3 2.1.1

package/package.json

@@ -0,0 +1,313 @@
+{
+  "name": "vscode-behavior3",
+  "displayName": "%extension.displayName%",
+  "description": "%extension.description%",
+  "version": "2.1.1",
+  "publisher": "codetypess",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codetypess/vscode-behavior3"
+  },
+  "keywords": [
+    "behavior3",
+    "behavior-tree",
+    "vscode",
+    "cli",
+    "game-ai"
+  ],
+  "bin": {
+    "behavior3-build": "./dist/build-cli.js"
+  },
+  "exports": {
+    "./build": {
+      "types": "./build.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "build": [
+        "build.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "build.d.ts",
+    "dist/build-cli.js",
+    "dist/extension.js",
+    "dist/webview/",
+    "icon.png",
+    "media/icons/icon.svg",
+    "package.nls.json",
+    "package.nls.zh-cn.json",
+    "webview/shared/b3build-model.d.ts",
+    "webview/shared/b3type.ts"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18",
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "icon": "icon.png",
+  "activationEvents": [
+    "onLanguage:json"
+  ],
+  "main": "./dist/extension.js",
+  "contributes": {
+    "customEditors": [
+      {
+        "viewType": "behavior3.treeEditor",
+        "displayName": "%extension.editor.displayName%",
+        "selector": [
+          {
+            "filenamePattern": "*.json"
+          }
+        ],
+        "priority": "option"
+      }
+    ],
+    "viewsContainers": {
+      "activitybar": [
+        {
+          "id": "behavior3InspectorContainer",
+          "title": "%viewContainer.inspector.title%",
+          "icon": "media/icons/icon.svg"
+        }
+      ]
+    },
+    "views": {
+      "behavior3InspectorContainer": [
+        {
+          "id": "behavior3.inspectorView",
+          "name": "%view.inspector.title%",
+          "icon": "media/icons/icon.svg",
+          "type": "webview",
+          "visibility": "visible"
+        }
+      ]
+    },
+    "submenus": [
+      {
+        "id": "behavior3.explorer",
+        "label": "%submenu.explorer.label%"
+      }
+    ],
+    "commands": [
+      {
+        "command": "behavior3.build",
+        "title": "%command.build.title%",
+        "category": "%command.category%",
+        "icon": "$(build)"
+      },
+      {
+        "command": "behavior3.buildDebug",
+        "title": "%command.buildDebug.title%",
+        "category": "%command.category%",
+        "icon": "$(debug-alt)"
+      },
+      {
+        "command": "behavior3.batchProcess",
+        "title": "%command.batchProcess.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.runBatchProcessScript",
+        "title": "%command.runBatchProcessScript.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.createProject",
+        "title": "%command.createProject.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.createTree",
+        "title": "%command.createTree.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.openSettings",
+        "title": "%command.openSettings.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.openWithEditor",
+        "title": "%command.openWithEditor.title%",
+        "category": "%command.category%"
+      },
+      {
+        "command": "behavior3.toggleEditorMode",
+        "title": "%command.toggleEditorMode.title%",
+        "category": "%command.category%",
+        "icon": "$(edit-code)"
+      }
+    ],
+    "keybindings": [
+      {
+        "command": "behavior3.build",
+        "key": "ctrl+b",
+        "mac": "cmd+b",
+        "when": "activeCustomEditorId == 'behavior3.treeEditor'"
+      },
+      {
+        "command": "behavior3.buildDebug",
+        "key": "ctrl+shift+b",
+        "mac": "cmd+shift+b",
+        "when": "activeCustomEditorId == 'behavior3.treeEditor'"
+      },
+      {
+        "command": "behavior3.toggleEditorMode",
+        "key": "f4",
+        "when": "activeCustomEditorId == 'behavior3.treeEditor' || resourceExtname == .json"
+      }
+    ],
+    "menus": {
+      "editor/title": [
+        {
+          "command": "behavior3.toggleEditorMode",
+          "when": "activeCustomEditorId == 'behavior3.treeEditor' || resourceExtname == .json",
+          "group": "navigation@0"
+        },
+        {
+          "command": "behavior3.build",
+          "when": "activeCustomEditorId == 'behavior3.treeEditor'",
+          "group": "navigation@1",
+          "alt": "behavior3.buildDebug"
+        }
+      ],
+      "explorer/context": [
+        {
+          "submenu": "behavior3.explorer",
+          "when": "explorerResourceIsFolder || resourceExtname == .json || resourceExtname == .ts || resourceExtname == .mts || resourceExtname == .js || resourceExtname == .mjs",
+          "group": "navigation@45"
+        }
+      ],
+      "behavior3.explorer": [
+        {
+          "command": "behavior3.createProject",
+          "when": "explorerResourceIsFolder",
+          "group": "1_create@1"
+        },
+        {
+          "command": "behavior3.batchProcess",
+          "when": "explorerResourceIsFolder",
+          "group": "1_create@2"
+        },
+        {
+          "command": "behavior3.createTree",
+          "when": "explorerResourceIsFolder",
+          "group": "1_create@3"
+        },
+        {
+          "command": "behavior3.runBatchProcessScript",
+          "when": "(resourceExtname == .ts || resourceExtname == .mts || resourceExtname == .js || resourceExtname == .mjs) && !explorerResourceIsFolder",
+          "group": "2_run@1"
+        },
+        {
+          "command": "behavior3.openWithEditor",
+          "when": "resourceExtname == .json && !explorerResourceIsFolder",
+          "group": "3_open@1"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "%configuration.title%",
+      "properties": {
+        "behavior3.checkExpr": {
+          "type": "boolean",
+          "default": true,
+          "description": "%configuration.checkExpr.description%"
+        },
+        "behavior3.language": {
+          "type": "string",
+          "default": "auto",
+          "enum": [
+            "auto",
+            "zh",
+            "en"
+          ],
+          "enumDescriptions": [
+            "%configuration.language.auto%",
+            "%configuration.language.zh%",
+            "%configuration.language.en%"
+          ],
+          "description": "%configuration.language.description%"
+        },
+        "behavior3.subtreeEditable": {
+          "type": "boolean",
+          "default": true,
+          "description": "%configuration.subtreeEditable.description%"
+        },
+        "behavior3.inspectorMode": {
+          "type": "string",
+          "default": "sidebar",
+          "enum": [
+            "sidebar",
+            "embedded"
+          ],
+          "enumDescriptions": [
+            "%configuration.inspectorMode.sidebar%",
+            "%configuration.inspectorMode.embedded%"
+          ],
+          "description": "%configuration.inspectorMode.description%"
+        }
+      }
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run build",
+    "build": "node esbuild.js && vite build",
+    "build:cli": "node esbuild.js --cli",
+    "build:dev": "node esbuild.js --dev && vite build --mode development",
+    "watch:ext": "node esbuild.js --watch",
+    "watch:webview": "vite build --watch --mode development",
+    "dev": "npm run watch:webview",
+    "package": "vsce package",
+    "pack:npm": "npm pack --dry-run",
+    "prepack": "npm run check && npm run test:shared && npm run build",
+    "publish:npm": "npm publish --access public",
+    "check": "tsc --noEmit && tsc --project tsconfig.webview.json --noEmit",
+    "test:shared": "node test/run-tests.js",
+    "format:check": "prettier --check package.json \"test/**/*.js\" \"test/**/*.ts\"",
+    "format": "prettier --write package.json \"test/**/*.js\" \"test/**/*.ts\""
+  },
+  "dependencies": {
+    "behavior3": "^1.1.0"
+  },
+  "devDependencies": {
+    "@ant-design/icons": "^6.1.1",
+    "@antv/g6": "^5.0.51",
+    "@types/node": "^20.19.37",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@types/vscode": "^1.85.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "@vscode/vsce": "^3.7.1",
+    "ahooks": "^3.8.0",
+    "antd": "^6.3.4",
+    "autoprefixer": "^10.4.20",
+    "esbuild": "^0.24.0",
+    "i18next": "^23.12.2",
+    "nanoid": "^5.1.6",
+    "postcss": "^8.4.49",
+    "prettier": "^3.8.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "^14.1.3",
+    "react-icons": "^5.2.1",
+    "react-markdown": "^9.0.1",
+    "sass": "^1.77.8",
+    "tailwindcss": "^3.4.15",
+    "ts-key-enum": "^2.0.12",
+    "typescript": "^5.8.2",
+    "usehooks-ts": "^3.1.0",
+    "vite": "^6.3.5",
+    "zustand": "^5.0.3"
+  }
+}

package/package.nls.json

@@ -0,0 +1,28 @@
+{
+  "extension.displayName": "Behavior3 Editor",
+  "extension.description": "Visual Behavior3 Editor for game development",
+  "extension.editor.displayName": "Behavior3 Editor",
+  "viewContainer.inspector.title": "Behavior3",
+  "view.inspector.title": "Behavior3",
+  "submenu.explorer.label": "Behavior3",
+  "command.category": "Behavior Tree",
+  "command.build.title": "Build Behavior Tree",
+  "command.buildDebug.title": "Debug Build Behavior Tree",
+  "command.batchProcess.title": "Batch Process Behavior Trees",
+  "command.runBatchProcessScript.title": "Run as Batch Process",
+  "command.createProject.title": "Create Project",
+  "command.openSettings.title": "Open Node Config (.b3-setting)",
+  "command.createTree.title": "Create Behavior3 File",
+  "command.openWithEditor.title": "Open with Behavior3",
+  "command.toggleEditorMode.title": "Toggle Text / Behavior3",
+  "configuration.title": "Behavior3 Editor",
+  "configuration.checkExpr.description": "Enable expression validation.",
+  "configuration.language.description": "Editor UI language. The default follows the VS Code display language; you can also force a language.",
+  "configuration.language.auto": "Follow VS Code display language",
+  "configuration.language.zh": "Force Chinese",
+  "configuration.language.en": "Force English",
+  "configuration.subtreeEditable.description": "Allow editing subtree node properties in the Inspector, including input, output, and arguments. When enabled, $override can override node properties inside subtrees. When disabled, subtree internal nodes are read-only.",
+  "configuration.inspectorMode.description": "Choose where the Inspector is shown.",
+  "configuration.inspectorMode.sidebar": "Show the Inspector in the dedicated VS Code sidebar.",
+  "configuration.inspectorMode.embedded": "Show the Inspector inside the Behavior3 editor."
+}

package/package.nls.zh-cn.json

@@ -0,0 +1,28 @@
+{
+  "extension.displayName": "Behavior3 编辑器",
+  "extension.description": "面向游戏开发的可视化 Behavior3 编辑器",
+  "extension.editor.displayName": "Behavior3 编辑器",
+  "viewContainer.inspector.title": "Behavior3",
+  "view.inspector.title": "Behavior3",
+  "submenu.explorer.label": "Behavior3",
+  "command.category": "行为树",
+  "command.build.title": "构建行为树",
+  "command.buildDebug.title": "调试构建行为树",
+  "command.batchProcess.title": "批量处理行为树",
+  "command.runBatchProcessScript.title": "作为批处理运行",
+  "command.createProject.title": "创建项目",
+  "command.openSettings.title": "打开节点配置 (.b3-setting)",
+  "command.createTree.title": "创建 Behavior3 文件",
+  "command.openWithEditor.title": "使用 Behavior3 打开",
+  "command.toggleEditorMode.title": "切换文本 / Behavior3",
+  "configuration.title": "Behavior3 编辑器",
+  "configuration.checkExpr.description": "启用表达式校验。",
+  "configuration.language.description": "编辑器界面语言。默认跟随 VS Code 显示语言，也可手动指定。",
+  "configuration.language.auto": "跟随 VS Code 显示语言",
+  "configuration.language.zh": "强制中文",
+  "configuration.language.en": "强制英文",
+  "configuration.subtreeEditable.description": "允许在 Inspector 中编辑子树节点的属性，包括输入、输出和参数。启用时可通过 $override 覆盖子树中的节点属性；禁用时子树内部节点为只读。",
+  "configuration.inspectorMode.description": "选择 Inspector 的显示位置。",
+  "configuration.inspectorMode.sidebar": "在独立的 VS Code 侧栏中显示 Inspector。",
+  "configuration.inspectorMode.embedded": "在 Behavior3 编辑器内部显示 Inspector。"
+}

package/webview/shared/b3build-model.d.ts

@@ -0,0 +1,98 @@
+import type { NodeDef } from "behavior3";
+import type { NodeData, TreeData } from "./b3type";
+
+export type NodeArg = Exclude<NodeDef["args"], undefined>[number];
+
+export type BuildLogger = {
+    log: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+
+export type FsLike = {
+    readFileSync(path: string, encoding: "utf8" | "utf-8"): string;
+    writeFileSync(path: string, data: string, encoding?: "utf8" | "utf-8"): void;
+    readdirSync(path: string): string[];
+    readdirSync(path: string, options: { encoding: "utf8" | "utf-8"; recursive?: boolean }): string[];
+    statSync(path: string): { mtimeMs: number; isFile(): boolean };
+    mkdirSync(path: string, options?: { recursive?: boolean }): unknown;
+    copyFileSync(source: string, destination: string): void;
+    unlinkSync(path: string): void;
+};
+
+export type PathLike = {
+    [key: string]: unknown;
+    basename(path: string, suffix?: string): string;
+    basenameWithoutExt(path: string): string;
+    dirname(path: string): string;
+    extname(path: string): string;
+    isAbsolute(path: string): boolean;
+    join(...paths: string[]): string;
+    lsdir(path: string, recursive?: boolean): string[];
+    normalize(path: string): string;
+    posixPath(path: string): string;
+    relative(from: string, to: string): string;
+    resolve(...paths: string[]): string;
+};
+
+export type BuildEnv = {
+    fs: FsLike;
+    path: PathLike;
+    workdir: string;
+    nodeDefs: ReadonlyMap<string, NodeDef>;
+    logger: BuildLogger;
+};
+
+export type NodeArgCheckResult = string | string[] | null | undefined;
+
+export type NodeArgCheckContext = {
+    node: NodeData;
+    tree: TreeData;
+    nodeDef: NodeDef;
+    arg: NodeArg;
+    argName: string;
+    treePath: string;
+    env: BuildEnv;
+};
+
+export interface NodeArgChecker {
+    validate(value: unknown, ctx: NodeArgCheckContext): NodeArgCheckResult;
+}
+
+export type BuildScript = {
+    onProcessTree?: (tree: TreeData, path: string, errors: string[]) => TreeData | null;
+    onProcessNode?: (node: NodeData, errors: string[]) => NodeData | null;
+    onWriteFile?: (path: string, tree: TreeData) => void;
+    onComplete?: (status: "success" | "failure") => void;
+};
+
+export type BuildHookClass<T extends BuildScript = BuildScript> = new (...args: any[]) => T;
+export type NodeArgCheckerClass<T extends NodeArgChecker = NodeArgChecker> = new (
+    ...args: any[]
+) => T;
+
+export type BuildDecorator = {
+    <T extends BuildHookClass>(target: T): T | void;
+    <T extends BuildHookClass>(target: T, context: ClassDecoratorContext<T>): T | void;
+};
+
+export type CheckDecorator = {
+    <T extends NodeArgCheckerClass>(target: T): T | void;
+    <T extends NodeArgCheckerClass>(target: T, context: ClassDecoratorContext<T>): T | void;
+    (name?: string): <T extends NodeArgCheckerClass>(target: T) => T | void;
+};
+
+export type BuildRuntime = {
+    build: BuildDecorator;
+    check: CheckDecorator;
+};
+
+export declare class Hook implements BuildScript {
+    constructor(env: BuildEnv);
+    onProcessTree?(tree: TreeData, path: string, errors: string[]): TreeData | null;
+    onProcessNode?(node: NodeData, errors: string[]): NodeData | null;
+    onWriteFile?(path: string, tree: TreeData): void;
+    onComplete?(status: "success" | "failure"): void;
+}

package/webview/shared/b3type.ts

@@ -0,0 +1,112 @@
+import type { NodeDef } from "behavior3";
+
+export type { NodeDef };
+export type NodeType = NodeDef["type"] | "Other" | "Error";
+export type NodeArg = Exclude<NodeDef["args"], undefined>[number];
+
+export const DOCUMENT_VERSION = "2.1.0";
+export const VERSION = DOCUMENT_VERSION;
+
+export interface NodeData {
+    id: string;
+    name: string;
+    desc?: string;
+    args?: { [key: string]: unknown };
+    input?: string[];
+    output?: string[];
+    children?: NodeData[];
+    debug?: boolean;
+    disabled?: boolean;
+    path?: string;
+
+    // Stable node identity, for overrides
+    uuid: string;
+
+    // for runtime
+    $mtime?: number;
+    $size?: number[];
+    $status?: number;
+}
+
+export interface VarDecl {
+    name: string;
+    desc: string;
+}
+
+export interface TreeVariables {
+    imports: string[];
+    locals: VarDecl[];
+}
+
+export interface GroupDecl {
+    name: string;
+    value: boolean;
+}
+
+export interface ImportDecl {
+    path: string;
+    modified?: number;
+    vars: VarDecl[];
+    depends: {
+        path: string;
+        modified: number;
+    }[];
+}
+
+export interface FileVarDecl {
+    import: ImportDecl[];
+    subtree: ImportDecl[];
+    vars: VarDecl[];
+}
+
+export interface TreeData {
+    version: string;
+    name: string;
+    prefix: string;
+    desc?: string;
+    export?: boolean;
+    group: string[];
+    variables: TreeVariables;
+    custom: Record<string, string | number | boolean | object>;
+    root: NodeData;
+
+    overrides: {
+        [key: string]: Pick<NodeData, "desc" | "input" | "output" | "args" | "debug" | "disabled">;
+    };
+}
+
+export const keyWords = ["true", "false", "null", "undefined", "NaN", "Infinity"];
+
+export const isIntType = (type: string) => type.startsWith("int");
+export const isFloatType = (type: string) => type.startsWith("float");
+export const isStringType = (type: string) => type.startsWith("string");
+export const isBoolType = (type: string) => type.startsWith("bool");
+export const isExprType = (type: string) => type.startsWith("expr");
+export const isJsonType = (type: string) => type.startsWith("json");
+export const hasArgOptions = (arg: NodeArg) => arg.options !== undefined;
+
+/** `.b3-workspace` file shape. Extension build only reads `settings`; `files` is optional (desktop may still use it). */
+export interface WorkspaceModel {
+    settings: {
+        checkExpr?: boolean;
+        buildScript?: string;
+        checkScripts?: string[];
+        /** Override default node-type colors. Keys: "Composite" | "Decorator" | "Condition" | "Action" | "Other" | "Error" */
+        nodeColors?: Record<string, string>;
+    };
+}
+
+export const getNodeType = (def: NodeDef): NodeType => {
+    const type = def.type.toLocaleLowerCase().toString();
+    if (type.startsWith("action")) {
+        return "Action";
+    } else if (type.startsWith("composite")) {
+        return "Composite";
+    } else if (type.startsWith("decorator")) {
+        return "Decorator";
+    } else if (type.startsWith("condition")) {
+        return "Condition";
+    } else {
+        return "Other";
+    }
+};