@abco20/btxml-checker 0.1.1 → 0.1.3

package/dist/server.cjs

@@ -927,9 +927,9 @@ var require_codegen = __commonJS({
       }
     };
     var Throw = class extends Node {
-      constructor(error51) {
+      constructor(error52) {
         super();
-        this.error = error51;
+        this.error = error52;
       }
       render({ _n }) {
         return `throw ${this.error};` + _n;
@@ -1166,9 +1166,9 @@ var require_codegen = __commonJS({
       }
     };
     var Catch = class extends BlockNode {
-      constructor(error51) {
+      constructor(error52) {
         super();
-        this.error = error51;
+        this.error = error52;
       }
       render(opts) {
         return `catch(${this.error})` + super.render(opts);
@@ -1359,9 +1359,9 @@ var require_codegen = __commonJS({
         this._blockNode(node);
         this.code(tryBody);
         if (catchCode) {
-          const error51 = this.name("e");
-          this._currNode = node.catch = new Catch(error51);
-          catchCode(error51);
+          const error52 = this.name("e");
+          this._currNode = node.catch = new Catch(error52);
+          catchCode(error52);
         }
         if (finallyCode) {
           this._currNode = node.finally = new Finally();
@@ -1370,8 +1370,8 @@ var require_codegen = __commonJS({
         return this._endBlockNode(Catch, Finally);
       }
       // `throw` statement
-      throw(error51) {
-        return this._leafNode(new Throw(error51));
+      throw(error52) {
+        return this._leafNode(new Throw(error52));
       }
       // start self-balancing block
       block(body, nodeCount) {
@@ -1727,10 +1727,10 @@ var require_errors = __commonJS({
     exports2.keyword$DataError = {
       message: ({ keyword, schemaType }) => schemaType ? (0, codegen_1.str)`"${keyword}" keyword must be ${schemaType} ($data)` : (0, codegen_1.str)`"${keyword}" keyword is invalid ($data)`
     };
-    function reportError(cxt, error51 = exports2.keywordError, errorPaths, overrideAllErrors) {
+    function reportError(cxt, error52 = exports2.keywordError, errorPaths, overrideAllErrors) {
       const { it } = cxt;
       const { gen, compositeRule, allErrors } = it;
-      const errObj = errorObjectCode(cxt, error51, errorPaths);
+      const errObj = errorObjectCode(cxt, error52, errorPaths);
       if (overrideAllErrors !== null && overrideAllErrors !== void 0 ? overrideAllErrors : compositeRule || allErrors) {
         addError(gen, errObj);
       } else {
@@ -1738,10 +1738,10 @@ var require_errors = __commonJS({
       }
     }
     exports2.reportError = reportError;
-    function reportExtraError(cxt, error51 = exports2.keywordError, errorPaths) {
+    function reportExtraError(cxt, error52 = exports2.keywordError, errorPaths) {
       const { it } = cxt;
       const { gen, compositeRule, allErrors } = it;
-      const errObj = errorObjectCode(cxt, error51, errorPaths);
+      const errObj = errorObjectCode(cxt, error52, errorPaths);
       addError(gen, errObj);
       if (!(compositeRule || allErrors)) {
         returnErrors(it, names_1.default.vErrors);
@@ -1792,19 +1792,19 @@ var require_errors = __commonJS({
       schema: new codegen_1.Name("schema"),
       parentSchema: new codegen_1.Name("parentSchema")
     };
-    function errorObjectCode(cxt, error51, errorPaths) {
+    function errorObjectCode(cxt, error52, errorPaths) {
       const { createErrors } = cxt.it;
       if (createErrors === false)
         return (0, codegen_1._)`{}`;
-      return errorObject(cxt, error51, errorPaths);
+      return errorObject(cxt, error52, errorPaths);
     }
-    function errorObject(cxt, error51, errorPaths = {}) {
+    function errorObject(cxt, error52, errorPaths = {}) {
       const { gen, it } = cxt;
       const keyValues = [
         errorInstancePath(it, errorPaths),
         errorSchemaPath(cxt, errorPaths)
       ];
-      extraErrorProps(cxt, error51, keyValues);
+      extraErrorProps(cxt, error52, keyValues);
       return gen.object(...keyValues);
     }
     function errorInstancePath({ errorPath }, { instancePath }) {
@@ -5159,7 +5159,7 @@ var require_limitNumber = __commonJS({
       exclusiveMaximum: { okStr: "<", ok: ops.LT, fail: ops.GTE },
       exclusiveMinimum: { okStr: ">", ok: ops.GT, fail: ops.LTE }
     };
-    var error51 = {
+    var error52 = {
       message: ({ keyword, schemaCode }) => (0, codegen_1.str)`must be ${KWDs[keyword].okStr} ${schemaCode}`,
       params: ({ keyword, schemaCode }) => (0, codegen_1._)`{comparison: ${KWDs[keyword].okStr}, limit: ${schemaCode}}`
     };
@@ -5168,7 +5168,7 @@ var require_limitNumber = __commonJS({
       type: "number",
       schemaType: "number",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { keyword, data, schemaCode } = cxt;
         cxt.fail$data((0, codegen_1._)`${data} ${KWDs[keyword].fail} ${schemaCode} || isNaN(${data})`);
@@ -5184,7 +5184,7 @@ var require_multipleOf = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
-    var error51 = {
+    var error52 = {
       message: ({ schemaCode }) => (0, codegen_1.str)`must be multiple of ${schemaCode}`,
       params: ({ schemaCode }) => (0, codegen_1._)`{multipleOf: ${schemaCode}}`
     };
@@ -5193,7 +5193,7 @@ var require_multipleOf = __commonJS({
       type: "number",
       schemaType: "number",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, schemaCode, it } = cxt;
         const prec = it.opts.multipleOfPrecision;
@@ -5240,7 +5240,7 @@ var require_limitLength = __commonJS({
     var codegen_1 = require_codegen();
     var util_1 = require_util();
     var ucs2length_1 = require_ucs2length();
-    var error51 = {
+    var error52 = {
       message({ keyword, schemaCode }) {
         const comp = keyword === "maxLength" ? "more" : "fewer";
         return (0, codegen_1.str)`must NOT have ${comp} than ${schemaCode} characters`;
@@ -5252,7 +5252,7 @@ var require_limitLength = __commonJS({
       type: "string",
       schemaType: "number",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { keyword, data, schemaCode, it } = cxt;
         const op = keyword === "maxLength" ? codegen_1.operators.GT : codegen_1.operators.LT;
@@ -5272,7 +5272,7 @@ var require_pattern = __commonJS({
     var code_1 = require_code2();
     var util_1 = require_util();
     var codegen_1 = require_codegen();
-    var error51 = {
+    var error52 = {
       message: ({ schemaCode }) => (0, codegen_1.str)`must match pattern "${schemaCode}"`,
       params: ({ schemaCode }) => (0, codegen_1._)`{pattern: ${schemaCode}}`
     };
@@ -5281,7 +5281,7 @@ var require_pattern = __commonJS({
       type: "string",
       schemaType: "string",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, $data, schema, schemaCode, it } = cxt;
         const u = it.opts.unicodeRegExp ? "u" : "";
@@ -5307,7 +5307,7 @@ var require_limitProperties = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
-    var error51 = {
+    var error52 = {
       message({ keyword, schemaCode }) {
         const comp = keyword === "maxProperties" ? "more" : "fewer";
         return (0, codegen_1.str)`must NOT have ${comp} than ${schemaCode} properties`;
@@ -5319,7 +5319,7 @@ var require_limitProperties = __commonJS({
       type: "object",
       schemaType: "number",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { keyword, data, schemaCode } = cxt;
         const op = keyword === "maxProperties" ? codegen_1.operators.GT : codegen_1.operators.LT;
@@ -5338,7 +5338,7 @@ var require_required = __commonJS({
     var code_1 = require_code2();
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: ({ params: { missingProperty } }) => (0, codegen_1.str)`must have required property '${missingProperty}'`,
       params: ({ params: { missingProperty } }) => (0, codegen_1._)`{missingProperty: ${missingProperty}}`
     };
@@ -5347,7 +5347,7 @@ var require_required = __commonJS({
       type: "object",
       schemaType: "array",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, schema, schemaCode, data, $data, it } = cxt;
         const { opts } = it;
@@ -5418,7 +5418,7 @@ var require_limitItems = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
-    var error51 = {
+    var error52 = {
       message({ keyword, schemaCode }) {
         const comp = keyword === "maxItems" ? "more" : "fewer";
         return (0, codegen_1.str)`must NOT have ${comp} than ${schemaCode} items`;
@@ -5430,7 +5430,7 @@ var require_limitItems = __commonJS({
       type: "array",
       schemaType: "number",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { keyword, data, schemaCode } = cxt;
         const op = keyword === "maxItems" ? codegen_1.operators.GT : codegen_1.operators.LT;
@@ -5461,7 +5461,7 @@ var require_uniqueItems = __commonJS({
     var codegen_1 = require_codegen();
     var util_1 = require_util();
     var equal_1 = require_equal();
-    var error51 = {
+    var error52 = {
       message: ({ params: { i, j } }) => (0, codegen_1.str)`must NOT have duplicate items (items ## ${j} and ${i} are identical)`,
       params: ({ params: { i, j } }) => (0, codegen_1._)`{i: ${i}, j: ${j}}`
     };
@@ -5470,7 +5470,7 @@ var require_uniqueItems = __commonJS({
       type: "array",
       schemaType: "boolean",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, $data, schema, parentSchema, schemaCode, it } = cxt;
         if (!$data && !schema)
@@ -5527,14 +5527,14 @@ var require_const = __commonJS({
     var codegen_1 = require_codegen();
     var util_1 = require_util();
     var equal_1 = require_equal();
-    var error51 = {
+    var error52 = {
       message: "must be equal to constant",
       params: ({ schemaCode }) => (0, codegen_1._)`{allowedValue: ${schemaCode}}`
     };
     var def = {
       keyword: "const",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, $data, schemaCode, schema } = cxt;
         if ($data || schema && typeof schema == "object") {
@@ -5556,7 +5556,7 @@ var require_enum = __commonJS({
     var codegen_1 = require_codegen();
     var util_1 = require_util();
     var equal_1 = require_equal();
-    var error51 = {
+    var error52 = {
       message: "must be equal to one of the allowed values",
       params: ({ schemaCode }) => (0, codegen_1._)`{allowedValues: ${schemaCode}}`
     };
@@ -5564,7 +5564,7 @@ var require_enum = __commonJS({
       keyword: "enum",
       schemaType: "array",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, $data, schema, schemaCode, it } = cxt;
         if (!$data && schema.length === 0)
@@ -5643,7 +5643,7 @@ var require_additionalItems = __commonJS({
     exports2.validateAdditionalItems = void 0;
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: ({ params: { len } }) => (0, codegen_1.str)`must NOT have more than ${len} items`,
       params: ({ params: { len } }) => (0, codegen_1._)`{limit: ${len}}`
     };
@@ -5652,7 +5652,7 @@ var require_additionalItems = __commonJS({
       type: "array",
       schemaType: ["boolean", "object"],
       before: "uniqueItems",
-      error: error51,
+      error: error52,
       code(cxt) {
         const { parentSchema, it } = cxt;
         const { items } = parentSchema;
@@ -5771,7 +5771,7 @@ var require_items2020 = __commonJS({
     var util_1 = require_util();
     var code_1 = require_code2();
     var additionalItems_1 = require_additionalItems();
-    var error51 = {
+    var error52 = {
       message: ({ params: { len } }) => (0, codegen_1.str)`must NOT have more than ${len} items`,
       params: ({ params: { len } }) => (0, codegen_1._)`{limit: ${len}}`
     };
@@ -5780,7 +5780,7 @@ var require_items2020 = __commonJS({
       type: "array",
       schemaType: ["object", "boolean"],
       before: "uniqueItems",
-      error: error51,
+      error: error52,
       code(cxt) {
         const { schema, parentSchema, it } = cxt;
         const { prefixItems } = parentSchema;
@@ -5804,7 +5804,7 @@ var require_contains = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: ({ params: { min, max } }) => max === void 0 ? (0, codegen_1.str)`must contain at least ${min} valid item(s)` : (0, codegen_1.str)`must contain at least ${min} and no more than ${max} valid item(s)`,
       params: ({ params: { min, max } }) => max === void 0 ? (0, codegen_1._)`{minContains: ${min}}` : (0, codegen_1._)`{minContains: ${min}, maxContains: ${max}}`
     };
@@ -5814,7 +5814,7 @@ var require_contains = __commonJS({
       schemaType: ["object", "boolean"],
       before: "uniqueItems",
       trackErrors: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, schema, parentSchema, data, it } = cxt;
         let min;
@@ -5992,7 +5992,7 @@ var require_propertyNames = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: "property name must be valid",
       params: ({ params }) => (0, codegen_1._)`{propertyName: ${params.propertyName}}`
     };
@@ -6000,7 +6000,7 @@ var require_propertyNames = __commonJS({
       keyword: "propertyNames",
       type: "object",
       schemaType: ["object", "boolean"],
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, schema, data, it } = cxt;
         if ((0, util_1.alwaysValidSchema)(it, schema))
@@ -6037,7 +6037,7 @@ var require_additionalProperties = __commonJS({
     var codegen_1 = require_codegen();
     var names_1 = require_names();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: "must NOT have additional properties",
       params: ({ params }) => (0, codegen_1._)`{additionalProperty: ${params.additionalProperty}}`
     };
@@ -6047,7 +6047,7 @@ var require_additionalProperties = __commonJS({
       schemaType: ["boolean", "object"],
       allowUndefined: true,
       trackErrors: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, schema, parentSchema, data, errsCount, it } = cxt;
         if (!errsCount)
@@ -6321,7 +6321,7 @@ var require_oneOf = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: "must match exactly one schema in oneOf",
       params: ({ params }) => (0, codegen_1._)`{passingSchemas: ${params.passing}}`
     };
@@ -6329,7 +6329,7 @@ var require_oneOf = __commonJS({
       keyword: "oneOf",
       schemaType: "array",
       trackErrors: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, schema, parentSchema, it } = cxt;
         if (!Array.isArray(schema))
@@ -6406,7 +6406,7 @@ var require_if = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: ({ params }) => (0, codegen_1.str)`must match "${params.ifClause}" schema`,
       params: ({ params }) => (0, codegen_1._)`{failingKeyword: ${params.ifClause}}`
     };
@@ -6414,7 +6414,7 @@ var require_if = __commonJS({
       keyword: "if",
       schemaType: ["object", "boolean"],
       trackErrors: true,
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, parentSchema, it } = cxt;
         if (parentSchema.then === void 0 && parentSchema.else === void 0) {
@@ -6540,7 +6540,7 @@ var require_format = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     var codegen_1 = require_codegen();
-    var error51 = {
+    var error52 = {
       message: ({ schemaCode }) => (0, codegen_1.str)`must match format "${schemaCode}"`,
       params: ({ schemaCode }) => (0, codegen_1._)`{format: ${schemaCode}}`
     };
@@ -6549,7 +6549,7 @@ var require_format = __commonJS({
       type: ["number", "string"],
       schemaType: "string",
       $data: true,
-      error: error51,
+      error: error52,
       code(cxt, ruleType) {
         const { gen, data, $data, schema, schemaCode, it } = cxt;
         const { opts, errSchemaPath, schemaEnv, self } = it;
@@ -6704,7 +6704,7 @@ var require_discriminator = __commonJS({
     var compile_1 = require_compile();
     var ref_error_1 = require_ref_error();
     var util_1 = require_util();
-    var error51 = {
+    var error52 = {
       message: ({ params: { discrError, tagName } }) => discrError === types_1.DiscrError.Tag ? `tag "${tagName}" must be string` : `value of tag "${tagName}" must be in oneOf`,
       params: ({ params: { discrError, tag, tagName } }) => (0, codegen_1._)`{error: ${discrError}, tag: ${tagName}, tagValue: ${tag}}`
     };
@@ -6712,7 +6712,7 @@ var require_discriminator = __commonJS({
       keyword: "discriminator",
       type: "object",
       schemaType: "object",
-      error: error51,
+      error: error52,
       code(cxt) {
         const { gen, data, schema, parentSchema, it } = cxt;
         const { oneOf } = parentSchema;
@@ -7044,10 +7044,10 @@ var require_is = __commonJS({
       return typeof value === "number" || value instanceof Number;
     }
     exports2.number = number4;
-    function error51(value) {
+    function error52(value) {
       return value instanceof Error;
     }
-    exports2.error = error51;
+    exports2.error = error52;
     function func(value) {
       return typeof value === "function";
     }
@@ -7089,10 +7089,10 @@ var require_is2 = __commonJS({
       return typeof value === "number" || value instanceof Number;
     }
     exports2.number = number4;
-    function error51(value) {
+    function error52(value) {
       return value instanceof Error;
     }
-    exports2.error = error51;
+    exports2.error = error52;
     function func(value) {
       return typeof value === "function";
     }
@@ -8154,8 +8154,8 @@ var require_messageReader = __commonJS({
       get onError() {
         return this.errorEmitter.event;
       }
-      fireError(error51) {
-        this.errorEmitter.fire(this.asError(error51));
+      fireError(error52) {
+        this.errorEmitter.fire(this.asError(error52));
       }
       get onClose() {
         return this.closeEmitter.event;
@@ -8169,11 +8169,11 @@ var require_messageReader = __commonJS({
       firePartialMessage(info) {
         this.partialMessageEmitter.fire(info);
       }
-      asError(error51) {
-        if (error51 instanceof Error) {
-          return error51;
+      asError(error52) {
+        if (error52 instanceof Error) {
+          return error52;
         } else {
-          return new Error(`Reader received error. Reason: ${Is.string(error51.message) ? error51.message : "unknown"}`);
+          return new Error(`Reader received error. Reason: ${Is.string(error52.message) ? error52.message : "unknown"}`);
         }
       }
     };
@@ -8243,7 +8243,7 @@ var require_messageReader = __commonJS({
         const result = this.readable.onData((data) => {
           this.onData(data);
         });
-        this.readable.onError((error51) => this.fireError(error51));
+        this.readable.onError((error52) => this.fireError(error52));
         this.readable.onClose(() => this.fireClose());
         return result;
       }
@@ -8280,12 +8280,12 @@ ${JSON.stringify(Object.fromEntries(headers))}`));
               const bytes = this.options.contentDecoder !== void 0 ? await this.options.contentDecoder.decode(body) : body;
               const message = await this.options.contentTypeDecoder.decode(bytes, this.options);
               this.callback(message);
-            }).catch((error51) => {
-              this.fireError(error51);
+            }).catch((error52) => {
+              this.fireError(error52);
             });
           }
-        } catch (error51) {
-          this.fireError(error51);
+        } catch (error52) {
+          this.fireError(error52);
         }
       }
       clearPartialMessageTimer() {
@@ -8344,8 +8344,8 @@ var require_messageWriter = __commonJS({
       get onError() {
         return this.errorEmitter.event;
       }
-      fireError(error51, message, count) {
-        this.errorEmitter.fire([this.asError(error51), message, count]);
+      fireError(error52, message, count) {
+        this.errorEmitter.fire([this.asError(error52), message, count]);
       }
       get onClose() {
         return this.closeEmitter.event;
@@ -8353,11 +8353,11 @@ var require_messageWriter = __commonJS({
       fireClose() {
         this.closeEmitter.fire(void 0);
       }
-      asError(error51) {
-        if (error51 instanceof Error) {
-          return error51;
+      asError(error52) {
+        if (error52 instanceof Error) {
+          return error52;
         } else {
-          return new Error(`Writer received error. Reason: ${Is.string(error51.message) ? error51.message : "unknown"}`);
+          return new Error(`Writer received error. Reason: ${Is.string(error52.message) ? error52.message : "unknown"}`);
         }
       }
     };
@@ -8380,7 +8380,7 @@ var require_messageWriter = __commonJS({
         this.options = ResolvedMessageWriterOptions.fromOptions(options);
         this.errorCount = 0;
         this.writeSemaphore = new semaphore_1.Semaphore(1);
-        this.writable.onError((error51) => this.fireError(error51));
+        this.writable.onError((error52) => this.fireError(error52));
         this.writable.onClose(() => this.fireClose());
       }
       async write(msg) {
@@ -8397,9 +8397,9 @@ var require_messageWriter = __commonJS({
             headers.push(ContentLength, buffer.byteLength.toString(), CRLF);
             headers.push(CRLF);
             return this.doWrite(msg, headers, buffer);
-          }, (error51) => {
-            this.fireError(error51);
-            throw error51;
+          }, (error52) => {
+            this.fireError(error52);
+            throw error52;
           });
         });
       }
@@ -8407,14 +8407,14 @@ var require_messageWriter = __commonJS({
         try {
           await this.writable.write(headers.join(""), "ascii");
           return this.writable.write(data);
-        } catch (error51) {
-          this.handleError(error51, msg);
-          return Promise.reject(error51);
+        } catch (error52) {
+          this.handleError(error52, msg);
+          return Promise.reject(error52);
         }
       }
-      handleError(error51, msg) {
+      handleError(error52, msg) {
         this.errorCount++;
-        this.fireError(error51, msg, this.errorCount);
+        this.fireError(error52, msg, this.errorCount);
       }
       end() {
         this.writable.end();
@@ -8867,8 +8867,8 @@ var require_connection = __commonJS({
           closeEmitter.fire(void 0);
         }
       }
-      function readErrorHandler(error51) {
-        errorEmitter.fire([error51, void 0, void 0]);
+      function readErrorHandler(error52) {
+        errorEmitter.fire([error52, void 0, void 0]);
       }
       function writeErrorHandler(data) {
         errorEmitter.fire(data);
@@ -8962,11 +8962,11 @@ var require_connection = __commonJS({
           traceSendingResponse(message, method, startTime2);
           messageWriter.write(message).catch(() => logger.error(`Sending response failed.`));
         }
-        function replyError(error51, method, startTime2) {
+        function replyError(error52, method, startTime2) {
           const message = {
             jsonrpc: version2,
             id: requestMessage.id,
-            error: error51.toJson()
+            error: error52.toJson()
           };
           traceSendingResponse(message, method, startTime2);
           messageWriter.write(message).catch(() => logger.error(`Sending response failed.`));
@@ -9034,12 +9034,12 @@ var require_connection = __commonJS({
               promise2.then((resultOrError) => {
                 requestTokens.delete(tokenKey);
                 reply(resultOrError, requestMessage.method, startTime);
-              }, (error51) => {
+              }, (error52) => {
                 requestTokens.delete(tokenKey);
-                if (error51 instanceof messages_1.ResponseError) {
-                  replyError(error51, requestMessage.method, startTime);
-                } else if (error51 && Is.string(error51.message)) {
-                  replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed with message: ${error51.message}`), requestMessage.method, startTime);
+                if (error52 instanceof messages_1.ResponseError) {
+                  replyError(error52, requestMessage.method, startTime);
+                } else if (error52 && Is.string(error52.message)) {
+                  replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed with message: ${error52.message}`), requestMessage.method, startTime);
                 } else {
                   replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed unexpectedly without providing any details.`), requestMessage.method, startTime);
                 }
@@ -9048,12 +9048,12 @@ var require_connection = __commonJS({
               requestTokens.delete(tokenKey);
               reply(handlerResult, requestMessage.method, startTime);
             }
-          } catch (error51) {
+          } catch (error52) {
             requestTokens.delete(tokenKey);
-            if (error51 instanceof messages_1.ResponseError) {
-              reply(error51, requestMessage.method, startTime);
-            } else if (error51 && Is.string(error51.message)) {
-              replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed with message: ${error51.message}`), requestMessage.method, startTime);
+            if (error52 instanceof messages_1.ResponseError) {
+              reply(error52, requestMessage.method, startTime);
+            } else if (error52 && Is.string(error52.message)) {
+              replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed with message: ${error52.message}`), requestMessage.method, startTime);
             } else {
               replyError(new messages_1.ResponseError(messages_1.ErrorCodes.InternalError, `Request ${requestMessage.method} failed unexpectedly without providing any details.`), requestMessage.method, startTime);
             }
@@ -9081,16 +9081,16 @@ ${JSON.stringify(responseMessage.error, void 0, 4)}`);
             responsePromises.delete(key);
             try {
               if (responseMessage.error) {
-                const error51 = responseMessage.error;
-                responsePromise.reject(new messages_1.ResponseError(error51.code, error51.message, error51.data));
+                const error52 = responseMessage.error;
+                responsePromise.reject(new messages_1.ResponseError(error52.code, error52.message, error52.data));
               } else if (responseMessage.result !== void 0) {
                 responsePromise.resolve(responseMessage.result);
               } else {
                 throw new Error("Should never happen.");
               }
-            } catch (error51) {
-              if (error51.message) {
-                logger.error(`Response handler '${responsePromise.method}' failed with message: ${error51.message}`);
+            } catch (error52) {
+              if (error52.message) {
+                logger.error(`Response handler '${responsePromise.method}' failed with message: ${error52.message}`);
               } else {
                 logger.error(`Response handler '${responsePromise.method}' failed unexpectedly.`);
               }
@@ -9151,9 +9151,9 @@ ${JSON.stringify(responseMessage.error, void 0, 4)}`);
             } else if (starNotificationHandler) {
               starNotificationHandler(message.method, message.params);
             }
-          } catch (error51) {
-            if (error51.message) {
-              logger.error(`Notification handler '${message.method}' failed with message: ${error51.message}`);
+          } catch (error52) {
+            if (error52.message) {
+              logger.error(`Notification handler '${message.method}' failed with message: ${error52.message}`);
             } else {
               logger.error(`Notification handler '${message.method}' failed unexpectedly.`);
             }
@@ -9311,8 +9311,8 @@ ${JSON.stringify(message, null, 4)}`);
             }
           }
           if (responsePromise) {
-            const error51 = message.error ? ` Request failed: ${message.error.message} (${message.error.code}).` : "";
-            tracer.log(`Received response '${responsePromise.method} - (${message.id})' in ${Date.now() - responsePromise.timerStart}ms.${error51}`, data);
+            const error52 = message.error ? ` Request failed: ${message.error.message} (${message.error.code}).` : "";
+            tracer.log(`Received response '${responsePromise.method} - (${message.id})' in ${Date.now() - responsePromise.timerStart}ms.${error52}`, data);
           } else {
             tracer.log(`Received response ${message.id} without active response promise.`, data);
           }
@@ -9451,9 +9451,9 @@ ${JSON.stringify(message, null, 4)}`);
             params: messageParams
           };
           traceSendingNotification(notificationMessage);
-          return messageWriter.write(notificationMessage).catch((error51) => {
+          return messageWriter.write(notificationMessage).catch((error52) => {
             logger.error(`Sending notification failed.`);
-            throw error51;
+            throw error52;
           });
         },
         onNotification: (type, handler) => {
@@ -9578,10 +9578,10 @@ ${JSON.stringify(message, null, 4)}`);
             try {
               await messageWriter.write(requestMessage);
               responsePromises.set(id, responsePromise);
-            } catch (error51) {
+            } catch (error52) {
               logger.error(`Sending request failed.`);
-              responsePromise.reject(new messages_1.ResponseError(messages_1.ErrorCodes.MessageWriteError, error51.message ? error51.message : "Unknown reason"));
-              throw error51;
+              responsePromise.reject(new messages_1.ResponseError(messages_1.ErrorCodes.MessageWriteError, error52.message ? error52.message : "Unknown reason"));
+              throw error52;
             }
           });
         },
@@ -9654,9 +9654,9 @@ ${JSON.stringify(message, null, 4)}`);
           }
           state = ConnectionState.Disposed;
           disposeEmitter.fire(void 0);
-          const error51 = new messages_1.ResponseError(messages_1.ErrorCodes.PendingResponseRejected, "Pending response rejected since connection got disposed");
+          const error52 = new messages_1.ResponseError(messages_1.ErrorCodes.PendingResponseRejected, "Pending response rejected since connection got disposed");
           for (const promise2 of responsePromises.values()) {
-            promise2.reject(error51);
+            promise2.reject(error52);
           }
           responsePromises = /* @__PURE__ */ new Map();
           requestTokens = /* @__PURE__ */ new Map();
@@ -9977,11 +9977,11 @@ var require_ril = __commonJS({
       }
       write(data, encoding) {
         return new Promise((resolve, reject) => {
-          const callback = (error51) => {
-            if (error51 === void 0 || error51 === null) {
+          const callback = (error52) => {
+            if (error52 === void 0 || error52 === null) {
               resolve();
             } else {
-              reject(error51);
+              reject(error52);
             }
           };
           if (typeof data === "string") {
@@ -10093,7 +10093,7 @@ var require_main = __commonJS({
         super();
         this.process = process3;
         let eventEmitter = this.process;
-        eventEmitter.on("error", (error51) => this.fireError(error51));
+        eventEmitter.on("error", (error52) => this.fireError(error52));
         eventEmitter.on("close", () => this.fireClose());
       }
       listen(callback) {
@@ -10108,30 +10108,30 @@ var require_main = __commonJS({
         this.process = process3;
         this.errorCount = 0;
         const eventEmitter = this.process;
-        eventEmitter.on("error", (error51) => this.fireError(error51));
+        eventEmitter.on("error", (error52) => this.fireError(error52));
         eventEmitter.on("close", () => this.fireClose);
       }
       write(msg) {
         try {
           if (typeof this.process.send === "function") {
-            this.process.send(msg, void 0, void 0, (error51) => {
-              if (error51) {
+            this.process.send(msg, void 0, void 0, (error52) => {
+              if (error52) {
                 this.errorCount++;
-                this.handleError(error51, msg);
+                this.handleError(error52, msg);
               } else {
                 this.errorCount = 0;
               }
             });
           }
           return Promise.resolve();
-        } catch (error51) {
-          this.handleError(error51, msg);
-          return Promise.reject(error51);
+        } catch (error52) {
+          this.handleError(error52, msg);
+          return Promise.reject(error52);
         }
       }
-      handleError(error51, msg) {
+      handleError(error52, msg) {
         this.errorCount++;
-        this.fireError(error51, msg, this.errorCount);
+        this.fireError(error52, msg, this.errorCount);
       }
       end() {
       }
@@ -10142,7 +10142,7 @@ var require_main = __commonJS({
         super();
         this.onData = new api_1.Emitter();
         port.on("close", () => this.fireClose);
-        port.on("error", (error51) => this.fireError(error51));
+        port.on("error", (error52) => this.fireError(error52));
         port.on("message", (message) => {
           this.onData.fire(message);
         });
@@ -10158,20 +10158,20 @@ var require_main = __commonJS({
         this.port = port;
         this.errorCount = 0;
         port.on("close", () => this.fireClose());
-        port.on("error", (error51) => this.fireError(error51));
+        port.on("error", (error52) => this.fireError(error52));
       }
       write(msg) {
         try {
           this.port.postMessage(msg);
           return Promise.resolve();
-        } catch (error51) {
-          this.handleError(error51, msg);
-          return Promise.reject(error51);
+        } catch (error52) {
+          this.handleError(error52, msg);
+          return Promise.reject(error52);
         }
       }
-      handleError(error51, msg) {
+      handleError(error52, msg) {
         this.errorCount++;
-        this.fireError(error51, msg, this.errorCount);
+        this.fireError(error52, msg, this.errorCount);
       }
       end() {
       }
@@ -11908,10 +11908,10 @@ var require_is3 = __commonJS({
       return typeof value === "number" || value instanceof Number;
     }
     exports2.number = number4;
-    function error51(value) {
+    function error52(value) {
       return value instanceof Error;
     }
-    exports2.error = error51;
+    exports2.error = error52;
     function func(value) {
       return typeof value === "function";
     }
@@ -15066,7 +15066,7 @@ var require_server = __commonJS({
           return value;
         } else if (Is.thenable(value)) {
           return new Promise((resolve, reject) => {
-            value.then((resolved) => resolve(resolved), (error51) => reject(error51));
+            value.then((resolved) => resolve(resolved), (error52) => reject(error52));
           });
         } else {
           return Promise.resolve(value);
@@ -15380,8 +15380,8 @@ var require_files = __commonJS({
             reject(new Error(`Starting process to resolve node module  ${moduleName} failed`));
             return;
           }
-          cp.on("error", (error51) => {
-            reject(error51);
+          cp.on("error", (error52) => {
+            reject(error52);
           });
           cp.on("message", (message2) => {
             if (message2.c === "r") {
@@ -15398,8 +15398,8 @@ var require_files = __commonJS({
             a: moduleName
           };
           cp.send(message);
-        } catch (error51) {
-          reject(error51);
+        } catch (error52) {
+          reject(error52);
         }
       });
     }
@@ -15850,7 +15850,7 @@ var require_main4 = __commonJS({
       console.log = function log(...args) {
         logger.log(serialize(args));
       };
-      console.error = function error51(...args) {
+      console.error = function error52(...args) {
         logger.error(serialize(args));
       };
       console.trace = function trace(...args) {
@@ -15932,7 +15932,8 @@ var DEFAULT_RESOLVED_BTXML_CONFIG = {
     files: [],
     augmentations: [],
     definitions: [],
-    inline: {}
+    inline: {},
+    convention: "allow-unused"
   },
   linter: {
     enabled: true,
@@ -16069,6 +16070,106 @@ function createTextDocument(uri, text, version2 = 0, languageId = "xml") {
   return document;
 }
 
+// ../model/src/blackboard-reference.ts
+var BLACKBOARD_KEY_RE = /^[A-Za-z_][A-Za-z0-9_./:-]*$/;
+function ok(reference) {
+  return { ok: true, reference };
+}
+function error(kind, raw, message) {
+  return {
+    ok: false,
+    error: {
+      kind,
+      raw,
+      message
+    }
+  };
+}
+function isValidKey(key) {
+  return BLACKBOARD_KEY_RE.test(key);
+}
+function parseScopedKey(raw) {
+  if (!raw) {
+    return error("empty-key", raw, "Blackboard reference key must not be empty");
+  }
+  if (raw[0] === "@") {
+    const key = raw.slice(1);
+    if (!key) {
+      return error("empty-key", raw, "Global blackboard reference key must not be empty");
+    }
+    if (!isValidKey(key)) {
+      return error("invalid-global-key", raw, `Invalid global blackboard reference key: ${raw}`);
+    }
+    return { ok: true, scope: "global", key };
+  }
+  if (!isValidKey(raw)) {
+    return error("invalid-key", raw, `Invalid blackboard reference key: ${raw}`);
+  }
+  return { ok: true, scope: "local", key: raw };
+}
+function parsePortBlackboardReference(input) {
+  const { portName } = input;
+  const rawValue = input.rawValue.trim();
+  if (rawValue === "=" || rawValue === "{=}") {
+    return ok({
+      scope: "local",
+      key: portName,
+      raw: rawValue,
+      syntax: "shorthand"
+    });
+  }
+  if (!rawValue.startsWith("{") && !rawValue.endsWith("}")) {
+    return error("not-a-reference", rawValue, `Not a blackboard reference: ${rawValue}`);
+  }
+  if (!(rawValue.startsWith("{") && rawValue.endsWith("}"))) {
+    return error(
+      "unbalanced-braces",
+      rawValue,
+      `Unbalanced blackboard reference braces: ${rawValue}`
+    );
+  }
+  const body = rawValue.slice(1, -1).trim();
+  const parsed = parseScopedKey(body);
+  if (!parsed.ok) {
+    return parsed;
+  }
+  return ok({
+    scope: parsed.scope,
+    key: parsed.key,
+    raw: rawValue,
+    syntax: "braced"
+  });
+}
+function parseScriptBlackboardIdentifier(input) {
+  const { rawName } = input;
+  if (!rawName.startsWith("@")) {
+    return error("not-a-reference", rawName, `Not a script blackboard identifier: ${rawName}`);
+  }
+  const parsed = parseScopedKey(rawName);
+  if (!parsed.ok) {
+    return parsed;
+  }
+  if (parsed.scope !== "global") {
+    return error(
+      "not-a-reference",
+      rawName,
+      `Script blackboard identifiers must use the global scope marker: ${rawName}`
+    );
+  }
+  return ok({
+    scope: parsed.scope,
+    key: parsed.key,
+    raw: rawName,
+    syntax: "script"
+  });
+}
+function formatBlackboardReference(reference) {
+  return reference.scope === "global" ? `{@${reference.key}}` : `{${reference.key}}`;
+}
+function makeBlackboardIdentity(reference) {
+  return `${reference.scope}:${reference.key}`;
+}
+
 // ../model/src/model.ts
 var BTCPP_DIAGNOSTIC_CODES = {
   DuplicateNodeModelId: "BT006_DUPLICATE_NODE_MODEL_ID"
@@ -16096,31 +16197,76 @@ function toPortSource(document, fallback = "inline-tree-nodes-model") {
   if (document.kind === "model-document") return "external-tree-nodes-model";
   return fallback;
 }
-function collectBlackboardReferences(element, refs, uri) {
+function advancePosition(start, text) {
+  let line = start.line;
+  let character = start.character;
+  let offset = start.offset;
+  for (const char of text) {
+    offset += char.length;
+    if (char === "\n") {
+      line += 1;
+      character = 0;
+      continue;
+    }
+    character += char.length;
+  }
+  return { line, character, offset };
+}
+function rangeFromRawText(start, prefix, text) {
+  const rangeStart = advancePosition(start, prefix);
+  const rangeEnd = advancePosition(rangeStart, text);
+  return {
+    start: rangeStart,
+    end: rangeEnd
+  };
+}
+function collectBlackboardReferences(element, refs, uri, documentText) {
   for (const attr of element.attributes || []) {
-    const matches = [...String(attr.value).matchAll(/\{([^}]+)\}/g)];
-    for (const match of matches) {
-      const index = match.index ?? 0;
-      const start = attr.valueRange.start;
-      const end = {
-        ...start,
-        character: start.character + match[0].length,
-        offset: start.offset + index + match[0].length
-      };
+    const baseRange = attr.valueContentRange ?? attr.valueRange;
+    const rawValue = documentText.slice(baseRange.start.offset, baseRange.end.offset);
+    const collectParsedReference = (input) => {
+      const parsed = parsePortBlackboardReference({
+        portName: attr.name,
+        rawValue: input.parsedRaw
+      });
+      if (!parsed.ok) return;
+      const referenceLength = parsed.reference.raw.length;
       refs.push({
-        name: match[1],
+        raw: parsed.reference.raw,
+        key: parsed.reference.key,
+        scope: parsed.reference.scope,
+        identity: makeBlackboardIdentity(parsed.reference),
+        syntax: parsed.reference.syntax,
         attributeName: attr.name,
         element,
         uri,
-        range: {
-          start: { ...start, character: start.character + index, offset: start.offset + index },
-          end
-        }
+        range: rangeFromRawText(
+          baseRange.start,
+          rawValue.slice(0, input.parsedOffset),
+          parsed.reference.raw.slice(0, referenceLength)
+        )
       });
+    };
+    const parsedWhole = parsePortBlackboardReference({
+      portName: attr.name,
+      rawValue
+    });
+    if (parsedWhole.ok) {
+      const parsedOffset = Math.max(0, rawValue.indexOf(parsedWhole.reference.raw));
+      collectParsedReference({
+        parsedRaw: parsedWhole.reference.raw,
+        parsedOffset
+      });
+      continue;
+    }
+    for (const match of rawValue.matchAll(/\{[^}]*\}/g)) {
+      const parsedRaw = match[0];
+      const parsedOffset = match.index ?? 0;
+      collectParsedReference({ parsedRaw, parsedOffset });
     }
   }
   for (const child of element.children || []) {
-    if (child.kind === "element") collectBlackboardReferences(child, refs, uri);
+    if (child.kind === "element") collectBlackboardReferences(child, refs, uri, documentText);
   }
 }
 function extractTreeNodesModel(element, uri, source, editable) {
@@ -16198,8 +16344,10 @@ function extractBehaviorTrees(root, uri) {
 }
 function extractSubTreeReferences(root, uri) {
   const refs = [];
-  const walk2 = (node, parentBehaviorTreeId) => {
+  const walk2 = (node, parentBehaviorTreeId, inTreeNodesModel = false) => {
+    if (inTreeNodesModel) return;
     const currentBehaviorTreeId = node.name === "BehaviorTree" ? getAttr(node, "ID")?.value ?? parentBehaviorTreeId : parentBehaviorTreeId;
+    const nextInTreeNodesModel = node.name === "TreeNodesModel";
     if (node.name === "SubTree") {
       const idAttr = getAttr(node, "ID");
       if (idAttr) {
@@ -16216,9 +16364,10 @@ function extractSubTreeReferences(root, uri) {
       }
     }
     for (const child of node.children || []) {
-      if (child.kind === "element") walk2(child, currentBehaviorTreeId);
+      if (child.kind === "element") walk2(child, currentBehaviorTreeId, nextInTreeNodesModel);
     }
   };
+  if (root.name === "TreeNodesModel") return refs;
   for (const child of root.children || []) {
     if (child.kind === "element") walk2(child);
   }
@@ -16277,9 +16426,23 @@ function stripSubTreeReferenceAst(def) {
     parentBehaviorTreeId: def.parentBehaviorTreeId
   };
 }
+function stripNodeUsageAst(def) {
+  return {
+    id: def.id,
+    uri: def.uri,
+    kind: def.kind,
+    range: def.range,
+    elementRange: def.elementRange,
+    parentBehaviorTreeId: def.parentBehaviorTreeId
+  };
+}
 function stripBlackboardReferenceAst(def) {
   return {
-    name: def.name,
+    raw: def.raw,
+    key: def.key,
+    scope: def.scope,
+    identity: def.identity,
+    syntax: def.syntax,
     attributeName: def.attributeName,
     uri: def.uri,
     range: def.range
@@ -16293,12 +16456,56 @@ function toPublicDocumentModel(input) {
     kind: input.kind,
     behaviorTrees: input.behaviorTrees.map(stripBehaviorTreeAst),
     subtreeReferences: input.subtreeReferences.map(stripSubTreeReferenceAst),
+    nodeUsages: input.nodeUsages.map(stripNodeUsageAst),
     blackboardReferences: input.blackboardReferences.map(stripBlackboardReferenceAst),
     treeNodesModel: input.treeNodesModel.map(stripTreeNodeModelAst),
     genericSubTreePorts: input.genericSubTreePorts.map(stripPortAst),
     rootMainTreeToExecute: cloneAttributeValueRef(input.rootMainTreeToExecute)
   };
 }
+function extractNodeUsages(root, uri) {
+  if (root.name === "TreeNodesModel") return [];
+  const usages = [];
+  const walk2 = (node, parentBehaviorTreeId, inTreeNodesModel = false) => {
+    if (inTreeNodesModel) return;
+    const nextInTreeNodesModel = node.name === "TreeNodesModel";
+    const currentBehaviorTreeId = node.name === "BehaviorTree" ? getAttr(node, "ID")?.value ?? parentBehaviorTreeId : parentBehaviorTreeId;
+    const isInsideBehaviorTree = currentBehaviorTreeId !== void 0;
+    if (node.name === "SubTree") {
+      const idAttr = getAttr(node, "ID");
+      if (idAttr && isInsideBehaviorTree) {
+        usages.push({
+          id: idAttr.value,
+          kind: "SubTree",
+          uri,
+          range: node.range,
+          elementRange: node.range,
+          parentBehaviorTreeId: currentBehaviorTreeId
+        });
+      }
+    } else if (isInsideBehaviorTree && node.name !== "root" && node.name !== "BehaviorTree" && node.name !== "TreeNodesModel") {
+      usages.push({
+        id: node.name,
+        kind: "node",
+        uri,
+        range: node.range,
+        elementRange: node.range,
+        parentBehaviorTreeId: currentBehaviorTreeId
+      });
+    }
+    for (const child of node.children || []) {
+      if (child.kind === "element") {
+        walk2(child, currentBehaviorTreeId, nextInTreeNodesModel);
+      }
+    }
+  };
+  for (const child of root.children || []) {
+    if (child.kind === "element") {
+      walk2(child);
+    }
+  }
+  return usages;
+}
 function addTreeNodeModelToCollections(input) {
   if (input.node.kind === "SubTree" && input.node.id === "SubTree") {
     input.genericSubTreePorts.push(...input.node.ports);
@@ -16338,7 +16545,11 @@ function extractDocumentModel(document, options) {
     const blockModels = extractTreeNodesModel(block, uri, source, editable);
     const seenInBlock = /* @__PURE__ */ new Map();
     for (const model of blockModels) {
-      if (addTreeNodeModelToCollections({ node: model, treeNodesModel, genericSubTreePorts })) {
+      if (addTreeNodeModelToCollections({
+        node: model,
+        treeNodesModel,
+        genericSubTreePorts
+      })) {
         continue;
       }
       if (seenInBlock.has(model.id)) diagnostics.push(createDuplicateNodeModelDiagnostic(model));
@@ -16346,9 +16557,10 @@ function extractDocumentModel(document, options) {
     }
   }
   const subtreeReferences = root ? extractSubTreeReferences(root, uri) : [];
+  const nodeUsages = root ? extractNodeUsages(root, uri) : [];
   const blackboardReferences = root ? (() => {
     const refs = [];
-    collectBlackboardReferences(root, refs, uri);
+    collectBlackboardReferences(root, refs, uri, document.originalText);
     return refs;
   })() : [];
   const rootMainTreeToExecute = root ? getAttr(root, "main_tree_to_execute") : void 0;
@@ -16359,10 +16571,15 @@ function extractDocumentModel(document, options) {
     kind,
     behaviorTrees,
     subtreeReferences,
+    nodeUsages,
     blackboardReferences,
     treeNodesModel,
     genericSubTreePorts,
-    rootMainTreeToExecute: rootMainTreeToExecute ? { uri, range: rootMainTreeToExecute.range, value: rootMainTreeToExecute.value } : void 0
+    rootMainTreeToExecute: rootMainTreeToExecute ? {
+      uri,
+      range: rootMainTreeToExecute.range,
+      value: rootMainTreeToExecute.value
+    } : void 0
   });
   return {
     extracted: {
@@ -16694,35 +16911,6 @@ function areTypesCompatible(registry2, left, right) {
   }
   return leftType.compatibleWith.includes(rightType.canonical) || rightType.compatibleWith.includes(leftType.canonical);
 }
-function isBlackboardPointer(value, strippedPointer) {
-  if (value.length < 3) {
-    return false;
-  }
-  let frontIndex = 0;
-  let lastIndex = value.length - 1;
-  while (frontIndex <= lastIndex && value[frontIndex] === " ") {
-    frontIndex += 1;
-  }
-  while (frontIndex <= lastIndex && value[lastIndex] === " ") {
-    lastIndex -= 1;
-  }
-  const size = lastIndex - frontIndex + 1;
-  const valid = size >= 3 && value[frontIndex] === "{" && value[lastIndex] === "}";
-  if (valid && strippedPointer) {
-    strippedPointer.current = value.slice(frontIndex + 1, lastIndex);
-  }
-  return valid;
-}
-function stripBlackboardPointer(value) {
-  const strippedPointer = {};
-  return isBlackboardPointer(value, strippedPointer) ? strippedPointer.current : void 0;
-}
-function getRemappedKey(portName, rawValue) {
-  if (rawValue === "{=}" || rawValue === "=") {
-    return portName;
-  }
-  return stripBlackboardPointer(rawValue);
-}
 
 // ../model/src/generated/btcpp-v4.6.2-builtins.ts
 var btcppV4_6_2BuiltinModels = [
@@ -19254,8 +19442,8 @@ function parse(text, errors = [], options = ParseOptions.DEFAULT) {
       currentParent = previousParents.pop();
     },
     onLiteralValue: onValue,
-    onError: (error51, offset, length) => {
-      errors.push({ error: error51, offset, length });
+    onError: (error52, offset, length) => {
+      errors.push({ error: error52, offset, length });
     }
   };
   visit(text, visitor, options);
@@ -19308,8 +19496,8 @@ function parseTree(text, errors = [], options = ParseOptions.DEFAULT) {
         }
       }
     },
-    onError: (error51, offset, length) => {
-      errors.push({ error: error51, offset, length });
+    onError: (error52, offset, length) => {
+      errors.push({ error: error52, offset, length });
     }
   };
   visit(text, visitor, options);
@@ -19457,8 +19645,8 @@ function visit(text, visitor, options = ParseOptions.DEFAULT) {
       }
     }
   }
-  function handleError(error51, skipUntilAfter = [], skipUntil = []) {
-    onError(error51);
+  function handleError(error52, skipUntilAfter = [], skipUntil = []) {
+    onError(error52);
     if (skipUntilAfter.length + skipUntil.length > 0) {
       let token = _scanner.getToken();
       while (token !== 17) {
@@ -21044,10 +21232,10 @@ var initializer = (inst, def) => {
 };
 var $ZodError = $constructor("$ZodError", initializer);
 var $ZodRealError = $constructor("$ZodError", initializer, { Parent: Error });
-function flattenError(error51, mapper = (issue2) => issue2.message) {
+function flattenError(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = {};
   const formErrors = [];
-  for (const sub of error51.issues) {
+  for (const sub of error52.issues) {
     if (sub.path.length > 0) {
       fieldErrors[sub.path[0]] = fieldErrors[sub.path[0]] || [];
       fieldErrors[sub.path[0]].push(mapper(sub));
@@ -21057,10 +21245,10 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
   }
   return { formErrors, fieldErrors };
 }
-function formatError(error51, mapper = (issue2) => issue2.message) {
+function formatError(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path4 = []) => {
-    for (const issue2 of error52.issues) {
+  const processError = (error53, path4 = []) => {
+    for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
         issue2.errors.map((issues) => processError({ issues }, [...path4, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
@@ -21090,14 +21278,14 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
       }
     }
   };
-  processError(error51);
+  processError(error52);
   return fieldErrors;
 }
-function treeifyError(error51, mapper = (issue2) => issue2.message) {
+function treeifyError(error52, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path4 = []) => {
+  const processError = (error53, path4 = []) => {
     var _a3, _b;
-    for (const issue2 of error52.issues) {
+    for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
         issue2.errors.map((issues) => processError({ issues }, [...path4, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
@@ -21132,7 +21320,7 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
       }
     }
   };
-  processError(error51);
+  processError(error52);
   return result;
 }
 function toDotPath(_path) {
@@ -21153,9 +21341,9 @@ function toDotPath(_path) {
   }
   return segs.join("");
 }
-function prettifyError(error51) {
+function prettifyError(error52) {
   const lines = [];
-  const issues = [...error51.issues].sort((a, b) => (a.path ?? []).length - (b.path ?? []).length);
+  const issues = [...error52.issues].sort((a, b) => (a.path ?? []).length - (b.path ?? []).length);
   for (const issue2 of issues) {
     lines.push(`\u2716 ${issue2.message}`);
     if (issue2.path?.length)
@@ -24153,7 +24341,7 @@ __export(locales_exports, {
 });
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ar.js
-var error = () => {
+var error2 = () => {
   const Sizable = {
     string: { unit: "\u062D\u0631\u0641", verb: "\u0623\u0646 \u064A\u062D\u0648\u064A" },
     file: { unit: "\u0628\u0627\u064A\u062A", verb: "\u0623\u0646 \u064A\u062D\u0648\u064A" },
@@ -24255,12 +24443,12 @@ var error = () => {
 };
 function ar_default() {
   return {
-    localeError: error()
+    localeError: error2()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/az.js
-var error2 = () => {
+var error3 = () => {
   const Sizable = {
     string: { unit: "simvol", verb: "olmal\u0131d\u0131r" },
     file: { unit: "bayt", verb: "olmal\u0131d\u0131r" },
@@ -24361,7 +24549,7 @@ var error2 = () => {
 };
 function az_default() {
   return {
-    localeError: error2()
+    localeError: error3()
   };
 }
 
@@ -24381,7 +24569,7 @@ function getBelarusianPlural(count, one, few, many) {
   }
   return many;
 }
-var error3 = () => {
+var error4 = () => {
   const Sizable = {
     string: {
       unit: {
@@ -24518,12 +24706,12 @@ var error3 = () => {
 };
 function be_default() {
   return {
-    localeError: error3()
+    localeError: error4()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/bg.js
-var error4 = () => {
+var error5 = () => {
   const Sizable = {
     string: { unit: "\u0441\u0438\u043C\u0432\u043E\u043B\u0430", verb: "\u0434\u0430 \u0441\u044A\u0434\u044A\u0440\u0436\u0430" },
     file: { unit: "\u0431\u0430\u0439\u0442\u0430", verb: "\u0434\u0430 \u0441\u044A\u0434\u044A\u0440\u0436\u0430" },
@@ -24639,12 +24827,12 @@ var error4 = () => {
 };
 function bg_default() {
   return {
-    localeError: error4()
+    localeError: error5()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ca.js
-var error5 = () => {
+var error6 = () => {
   const Sizable = {
     string: { unit: "car\xE0cters", verb: "contenir" },
     file: { unit: "bytes", verb: "contenir" },
@@ -24748,12 +24936,12 @@ var error5 = () => {
 };
 function ca_default() {
   return {
-    localeError: error5()
+    localeError: error6()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/cs.js
-var error6 = () => {
+var error7 = () => {
   const Sizable = {
     string: { unit: "znak\u016F", verb: "m\xEDt" },
     file: { unit: "bajt\u016F", verb: "m\xEDt" },
@@ -24860,12 +25048,12 @@ var error6 = () => {
 };
 function cs_default() {
   return {
-    localeError: error6()
+    localeError: error7()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/da.js
-var error7 = () => {
+var error8 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "havde" },
     file: { unit: "bytes", verb: "havde" },
@@ -24976,12 +25164,12 @@ var error7 = () => {
 };
 function da_default() {
   return {
-    localeError: error7()
+    localeError: error8()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/de.js
-var error8 = () => {
+var error9 = () => {
   const Sizable = {
     string: { unit: "Zeichen", verb: "zu haben" },
     file: { unit: "Bytes", verb: "zu haben" },
@@ -25085,12 +25273,12 @@ var error8 = () => {
 };
 function de_default() {
   return {
-    localeError: error8()
+    localeError: error9()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/el.js
-var error9 = () => {
+var error10 = () => {
   const Sizable = {
     string: { unit: "\u03C7\u03B1\u03C1\u03B1\u03BA\u03C4\u03AE\u03C1\u03B5\u03C2", verb: "\u03BD\u03B1 \u03AD\u03C7\u03B5\u03B9" },
     file: { unit: "bytes", verb: "\u03BD\u03B1 \u03AD\u03C7\u03B5\u03B9" },
@@ -25195,12 +25383,12 @@ var error9 = () => {
 };
 function el_default() {
   return {
-    localeError: error9()
+    localeError: error10()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/en.js
-var error10 = () => {
+var error11 = () => {
   const Sizable = {
     string: { unit: "characters", verb: "to have" },
     file: { unit: "bytes", verb: "to have" },
@@ -25308,12 +25496,12 @@ var error10 = () => {
 };
 function en_default() {
   return {
-    localeError: error10()
+    localeError: error11()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/eo.js
-var error11 = () => {
+var error12 = () => {
   const Sizable = {
     string: { unit: "karaktrojn", verb: "havi" },
     file: { unit: "bajtojn", verb: "havi" },
@@ -25418,12 +25606,12 @@ var error11 = () => {
 };
 function eo_default() {
   return {
-    localeError: error11()
+    localeError: error12()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/es.js
-var error12 = () => {
+var error13 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "tener" },
     file: { unit: "bytes", verb: "tener" },
@@ -25551,12 +25739,12 @@ var error12 = () => {
 };
 function es_default() {
   return {
-    localeError: error12()
+    localeError: error13()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/fa.js
-var error13 = () => {
+var error14 = () => {
   const Sizable = {
     string: { unit: "\u06A9\u0627\u0631\u0627\u06A9\u062A\u0631", verb: "\u062F\u0627\u0634\u062A\u0647 \u0628\u0627\u0634\u062F" },
     file: { unit: "\u0628\u0627\u06CC\u062A", verb: "\u062F\u0627\u0634\u062A\u0647 \u0628\u0627\u0634\u062F" },
@@ -25666,12 +25854,12 @@ var error13 = () => {
 };
 function fa_default() {
   return {
-    localeError: error13()
+    localeError: error14()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/fi.js
-var error14 = () => {
+var error15 = () => {
   const Sizable = {
     string: { unit: "merkki\xE4", subject: "merkkijonon" },
     file: { unit: "tavua", subject: "tiedoston" },
@@ -25779,12 +25967,12 @@ var error14 = () => {
 };
 function fi_default() {
   return {
-    localeError: error14()
+    localeError: error15()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/fr.js
-var error15 = () => {
+var error16 = () => {
   const Sizable = {
     string: { unit: "caract\xE8res", verb: "avoir" },
     file: { unit: "octets", verb: "avoir" },
@@ -25905,12 +26093,12 @@ var error15 = () => {
 };
 function fr_default() {
   return {
-    localeError: error15()
+    localeError: error16()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/fr-CA.js
-var error16 = () => {
+var error17 = () => {
   const Sizable = {
     string: { unit: "caract\xE8res", verb: "avoir" },
     file: { unit: "octets", verb: "avoir" },
@@ -26013,12 +26201,12 @@ var error16 = () => {
 };
 function fr_CA_default() {
   return {
-    localeError: error16()
+    localeError: error17()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/he.js
-var error17 = () => {
+var error18 = () => {
   const TypeNames = {
     string: { label: "\u05DE\u05D7\u05E8\u05D5\u05D6\u05EA", gender: "f" },
     number: { label: "\u05DE\u05E1\u05E4\u05E8", gender: "m" },
@@ -26208,12 +26396,12 @@ var error17 = () => {
 };
 function he_default() {
   return {
-    localeError: error17()
+    localeError: error18()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/hr.js
-var error18 = () => {
+var error19 = () => {
   const Sizable = {
     string: { unit: "znakova", verb: "imati" },
     file: { unit: "bajtova", verb: "imati" },
@@ -26331,12 +26519,12 @@ var error18 = () => {
 };
 function hr_default() {
   return {
-    localeError: error18()
+    localeError: error19()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/hu.js
-var error19 = () => {
+var error20 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "legyen" },
     file: { unit: "byte", verb: "legyen" },
@@ -26440,7 +26628,7 @@ var error19 = () => {
 };
 function hu_default() {
   return {
-    localeError: error19()
+    localeError: error20()
   };
 }
 
@@ -26455,7 +26643,7 @@ function withDefiniteArticle(word) {
   const lastChar = word[word.length - 1];
   return word + (vowels.includes(lastChar) ? "\u0576" : "\u0568");
 }
-var error20 = () => {
+var error21 = () => {
   const Sizable = {
     string: {
       unit: {
@@ -26588,12 +26776,12 @@ var error20 = () => {
 };
 function hy_default() {
   return {
-    localeError: error20()
+    localeError: error21()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/id.js
-var error21 = () => {
+var error22 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "memiliki" },
     file: { unit: "byte", verb: "memiliki" },
@@ -26695,12 +26883,12 @@ var error21 = () => {
 };
 function id_default() {
   return {
-    localeError: error21()
+    localeError: error22()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/is.js
-var error22 = () => {
+var error23 = () => {
   const Sizable = {
     string: { unit: "stafi", verb: "a\xF0 hafa" },
     file: { unit: "b\xE6ti", verb: "a\xF0 hafa" },
@@ -26805,12 +26993,12 @@ var error22 = () => {
 };
 function is_default() {
   return {
-    localeError: error22()
+    localeError: error23()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/it.js
-var error23 = () => {
+var error24 = () => {
   const Sizable = {
     string: { unit: "caratteri", verb: "avere" },
     file: { unit: "byte", verb: "avere" },
@@ -26914,12 +27102,12 @@ var error23 = () => {
 };
 function it_default() {
   return {
-    localeError: error23()
+    localeError: error24()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ja.js
-var error24 = () => {
+var error25 = () => {
   const Sizable = {
     string: { unit: "\u6587\u5B57", verb: "\u3067\u3042\u308B" },
     file: { unit: "\u30D0\u30A4\u30C8", verb: "\u3067\u3042\u308B" },
@@ -27022,12 +27210,12 @@ var error24 = () => {
 };
 function ja_default() {
   return {
-    localeError: error24()
+    localeError: error25()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ka.js
-var error25 = () => {
+var error26 = () => {
   const Sizable = {
     string: { unit: "\u10E1\u10D8\u10DB\u10D1\u10DD\u10DA\u10DD", verb: "\u10E3\u10DC\u10D3\u10D0 \u10E8\u10D4\u10D8\u10EA\u10D0\u10D5\u10D3\u10D4\u10E1" },
     file: { unit: "\u10D1\u10D0\u10D8\u10E2\u10D8", verb: "\u10E3\u10DC\u10D3\u10D0 \u10E8\u10D4\u10D8\u10EA\u10D0\u10D5\u10D3\u10D4\u10E1" },
@@ -27135,12 +27323,12 @@ var error25 = () => {
 };
 function ka_default() {
   return {
-    localeError: error25()
+    localeError: error26()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/km.js
-var error26 = () => {
+var error27 = () => {
   const Sizable = {
     string: { unit: "\u178F\u17BD\u17A2\u1780\u17D2\u179F\u179A", verb: "\u1782\u17BD\u179A\u1798\u17B6\u1793" },
     file: { unit: "\u1794\u17C3", verb: "\u1782\u17BD\u179A\u1798\u17B6\u1793" },
@@ -27246,7 +27434,7 @@ var error26 = () => {
 };
 function km_default() {
   return {
-    localeError: error26()
+    localeError: error27()
   };
 }
 
@@ -27256,7 +27444,7 @@ function kh_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ko.js
-var error27 = () => {
+var error28 = () => {
   const Sizable = {
     string: { unit: "\uBB38\uC790", verb: "to have" },
     file: { unit: "\uBC14\uC774\uD2B8", verb: "to have" },
@@ -27363,7 +27551,7 @@ var error27 = () => {
 };
 function ko_default() {
   return {
-    localeError: error27()
+    localeError: error28()
   };
 }
 
@@ -27381,7 +27569,7 @@ function getUnitTypeFromNumber(number4) {
     return "one";
   return "few";
 }
-var error28 = () => {
+var error29 = () => {
   const Sizable = {
     string: {
       unit: {
@@ -27567,12 +27755,12 @@ var error28 = () => {
 };
 function lt_default() {
   return {
-    localeError: error28()
+    localeError: error29()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/mk.js
-var error29 = () => {
+var error30 = () => {
   const Sizable = {
     string: { unit: "\u0437\u043D\u0430\u0446\u0438", verb: "\u0434\u0430 \u0438\u043C\u0430\u0430\u0442" },
     file: { unit: "\u0431\u0430\u0458\u0442\u0438", verb: "\u0434\u0430 \u0438\u043C\u0430\u0430\u0442" },
@@ -27677,12 +27865,12 @@ var error29 = () => {
 };
 function mk_default() {
   return {
-    localeError: error29()
+    localeError: error30()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ms.js
-var error30 = () => {
+var error31 = () => {
   const Sizable = {
     string: { unit: "aksara", verb: "mempunyai" },
     file: { unit: "bait", verb: "mempunyai" },
@@ -27785,12 +27973,12 @@ var error30 = () => {
 };
 function ms_default() {
   return {
-    localeError: error30()
+    localeError: error31()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/nl.js
-var error31 = () => {
+var error32 = () => {
   const Sizable = {
     string: { unit: "tekens", verb: "heeft" },
     file: { unit: "bytes", verb: "heeft" },
@@ -27896,12 +28084,12 @@ var error31 = () => {
 };
 function nl_default() {
   return {
-    localeError: error31()
+    localeError: error32()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/no.js
-var error32 = () => {
+var error33 = () => {
   const Sizable = {
     string: { unit: "tegn", verb: "\xE5 ha" },
     file: { unit: "bytes", verb: "\xE5 ha" },
@@ -28005,12 +28193,12 @@ var error32 = () => {
 };
 function no_default() {
   return {
-    localeError: error32()
+    localeError: error33()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ota.js
-var error33 = () => {
+var error34 = () => {
   const Sizable = {
     string: { unit: "harf", verb: "olmal\u0131d\u0131r" },
     file: { unit: "bayt", verb: "olmal\u0131d\u0131r" },
@@ -28115,12 +28303,12 @@ var error33 = () => {
 };
 function ota_default() {
   return {
-    localeError: error33()
+    localeError: error34()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ps.js
-var error34 = () => {
+var error35 = () => {
   const Sizable = {
     string: { unit: "\u062A\u0648\u06A9\u064A", verb: "\u0648\u0644\u0631\u064A" },
     file: { unit: "\u0628\u0627\u06CC\u067C\u0633", verb: "\u0648\u0644\u0631\u064A" },
@@ -28230,12 +28418,12 @@ var error34 = () => {
 };
 function ps_default() {
   return {
-    localeError: error34()
+    localeError: error35()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/pl.js
-var error35 = () => {
+var error36 = () => {
   const Sizable = {
     string: { unit: "znak\xF3w", verb: "mie\u0107" },
     file: { unit: "bajt\xF3w", verb: "mie\u0107" },
@@ -28340,12 +28528,12 @@ var error35 = () => {
 };
 function pl_default() {
   return {
-    localeError: error35()
+    localeError: error36()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/pt.js
-var error36 = () => {
+var error37 = () => {
   const Sizable = {
     string: { unit: "caracteres", verb: "ter" },
     file: { unit: "bytes", verb: "ter" },
@@ -28449,12 +28637,12 @@ var error36 = () => {
 };
 function pt_default() {
   return {
-    localeError: error36()
+    localeError: error37()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ro.js
-var error37 = () => {
+var error38 = () => {
   const Sizable = {
     string: { unit: "caractere", verb: "s\u0103 aib\u0103" },
     file: { unit: "octe\u021Bi", verb: "s\u0103 aib\u0103" },
@@ -28569,7 +28757,7 @@ var error37 = () => {
 };
 function ro_default() {
   return {
-    localeError: error37()
+    localeError: error38()
   };
 }
 
@@ -28589,7 +28777,7 @@ function getRussianPlural(count, one, few, many) {
   }
   return many;
 }
-var error38 = () => {
+var error39 = () => {
   const Sizable = {
     string: {
       unit: {
@@ -28726,12 +28914,12 @@ var error38 = () => {
 };
 function ru_default() {
   return {
-    localeError: error38()
+    localeError: error39()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/sl.js
-var error39 = () => {
+var error40 = () => {
   const Sizable = {
     string: { unit: "znakov", verb: "imeti" },
     file: { unit: "bajtov", verb: "imeti" },
@@ -28836,12 +29024,12 @@ var error39 = () => {
 };
 function sl_default() {
   return {
-    localeError: error39()
+    localeError: error40()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/sv.js
-var error40 = () => {
+var error41 = () => {
   const Sizable = {
     string: { unit: "tecken", verb: "att ha" },
     file: { unit: "bytes", verb: "att ha" },
@@ -28947,12 +29135,12 @@ var error40 = () => {
 };
 function sv_default() {
   return {
-    localeError: error40()
+    localeError: error41()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ta.js
-var error41 = () => {
+var error42 = () => {
   const Sizable = {
     string: { unit: "\u0B8E\u0BB4\u0BC1\u0BA4\u0BCD\u0BA4\u0BC1\u0B95\u0BCD\u0B95\u0BB3\u0BCD", verb: "\u0B95\u0BCA\u0BA3\u0BCD\u0B9F\u0BBF\u0BB0\u0BC1\u0B95\u0BCD\u0B95 \u0BB5\u0BC7\u0BA3\u0BCD\u0B9F\u0BC1\u0BAE\u0BCD" },
     file: { unit: "\u0BAA\u0BC8\u0B9F\u0BCD\u0B9F\u0BC1\u0B95\u0BB3\u0BCD", verb: "\u0B95\u0BCA\u0BA3\u0BCD\u0B9F\u0BBF\u0BB0\u0BC1\u0B95\u0BCD\u0B95 \u0BB5\u0BC7\u0BA3\u0BCD\u0B9F\u0BC1\u0BAE\u0BCD" },
@@ -29058,12 +29246,12 @@ var error41 = () => {
 };
 function ta_default() {
   return {
-    localeError: error41()
+    localeError: error42()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/th.js
-var error42 = () => {
+var error43 = () => {
   const Sizable = {
     string: { unit: "\u0E15\u0E31\u0E27\u0E2D\u0E31\u0E01\u0E29\u0E23", verb: "\u0E04\u0E27\u0E23\u0E21\u0E35" },
     file: { unit: "\u0E44\u0E1A\u0E15\u0E4C", verb: "\u0E04\u0E27\u0E23\u0E21\u0E35" },
@@ -29169,12 +29357,12 @@ var error42 = () => {
 };
 function th_default() {
   return {
-    localeError: error42()
+    localeError: error43()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/tr.js
-var error43 = () => {
+var error44 = () => {
   const Sizable = {
     string: { unit: "karakter", verb: "olmal\u0131" },
     file: { unit: "bayt", verb: "olmal\u0131" },
@@ -29275,12 +29463,12 @@ var error43 = () => {
 };
 function tr_default() {
   return {
-    localeError: error43()
+    localeError: error44()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/uk.js
-var error44 = () => {
+var error45 = () => {
   const Sizable = {
     string: { unit: "\u0441\u0438\u043C\u0432\u043E\u043B\u0456\u0432", verb: "\u043C\u0430\u0442\u0438\u043C\u0435" },
     file: { unit: "\u0431\u0430\u0439\u0442\u0456\u0432", verb: "\u043C\u0430\u0442\u0438\u043C\u0435" },
@@ -29384,7 +29572,7 @@ var error44 = () => {
 };
 function uk_default() {
   return {
-    localeError: error44()
+    localeError: error45()
   };
 }
 
@@ -29394,7 +29582,7 @@ function ua_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/ur.js
-var error45 = () => {
+var error46 = () => {
   const Sizable = {
     string: { unit: "\u062D\u0631\u0648\u0641", verb: "\u06C1\u0648\u0646\u0627" },
     file: { unit: "\u0628\u0627\u0626\u0679\u0633", verb: "\u06C1\u0648\u0646\u0627" },
@@ -29500,12 +29688,12 @@ var error45 = () => {
 };
 function ur_default() {
   return {
-    localeError: error45()
+    localeError: error46()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/uz.js
-var error46 = () => {
+var error47 = () => {
   const Sizable = {
     string: { unit: "belgi", verb: "bo\u2018lishi kerak" },
     file: { unit: "bayt", verb: "bo\u2018lishi kerak" },
@@ -29611,12 +29799,12 @@ var error46 = () => {
 };
 function uz_default() {
   return {
-    localeError: error46()
+    localeError: error47()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/vi.js
-var error47 = () => {
+var error48 = () => {
   const Sizable = {
     string: { unit: "k\xFD t\u1EF1", verb: "c\xF3" },
     file: { unit: "byte", verb: "c\xF3" },
@@ -29720,12 +29908,12 @@ var error47 = () => {
 };
 function vi_default() {
   return {
-    localeError: error47()
+    localeError: error48()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/zh-CN.js
-var error48 = () => {
+var error49 = () => {
   const Sizable = {
     string: { unit: "\u5B57\u7B26", verb: "\u5305\u542B" },
     file: { unit: "\u5B57\u8282", verb: "\u5305\u542B" },
@@ -29830,12 +30018,12 @@ var error48 = () => {
 };
 function zh_CN_default() {
   return {
-    localeError: error48()
+    localeError: error49()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/zh-TW.js
-var error49 = () => {
+var error50 = () => {
   const Sizable = {
     string: { unit: "\u5B57\u5143", verb: "\u64C1\u6709" },
     file: { unit: "\u4F4D\u5143\u7D44", verb: "\u64C1\u6709" },
@@ -29938,12 +30126,12 @@ var error49 = () => {
 };
 function zh_TW_default() {
   return {
-    localeError: error49()
+    localeError: error50()
   };
 }
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/locales/yo.js
-var error50 = () => {
+var error51 = () => {
   const Sizable = {
     string: { unit: "\xE0mi", verb: "n\xED" },
     file: { unit: "bytes", verb: "n\xED" },
@@ -30046,7 +30234,7 @@ var error50 = () => {
 };
 function yo_default() {
   return {
-    localeError: error50()
+    localeError: error51()
   };
 }
 
@@ -34393,7 +34581,7 @@ function parseModelAugmentationFile(text, options) {
       uri,
       path: options?.path
     };
-  } catch (error51) {
+  } catch (error52) {
     return {
       ok: false,
       uri,
@@ -34402,7 +34590,7 @@ function parseModelAugmentationFile(text, options) {
         {
           kind: "json",
           message: "the file could not be parsed as JSON",
-          notes: [String(error51.message || error51)]
+          notes: [String(error52.message || error52)]
         }
       ]
     };
@@ -34458,12 +34646,14 @@ var resolverConfigSchema = external_exports.object({
   includes: resolverIncludesConfigSchema.optional(),
   behaviorTreeIds: external_exports.enum(["workspace-unique", "file-local-first", "allow-ambiguous"]).optional()
 }).strict();
+var modelConventionSchema = external_exports.enum(["allow-unused", "used-only", "single-source"]);
 var modelsConfigSchema = external_exports.object({
   builtins: external_exports.array(external_exports.enum(SUPPORTED_BUILTIN_MODEL_SETS)).optional(),
   files: external_exports.array(external_exports.string()).optional(),
   augmentations: external_exports.array(external_exports.string()).optional(),
   definitions: external_exports.array(external_exports.string()).optional(),
-  inline: external_exports.record(external_exports.string(), configNodeModelSchema).optional()
+  inline: external_exports.record(external_exports.string(), configNodeModelSchema).optional(),
+  convention: modelConventionSchema.optional()
 }).strict();
 var linterSuppressionsConfigSchema = external_exports.object({
   inline: external_exports.enum(["allow", "deny"]).optional()
@@ -34552,7 +34742,7 @@ function isInvalidValueIssue(issue2) {
     return unionErrors.flat().some(isZodIssueLikeInvalidValue);
   }
   const zodUnionErrors = issue2.unionErrors;
-  return Array.isArray(zodUnionErrors) ? zodUnionErrors.flatMap((error51) => error51.issues ?? []).some(isZodIssueLikeInvalidValue) : false;
+  return Array.isArray(zodUnionErrors) ? zodUnionErrors.flatMap((error52) => error52.issues ?? []).some(isZodIssueLikeInvalidValue) : false;
 }
 function isZodIssueLikeInvalidValue(issue2) {
   return typeof issue2 === "object" && issue2 !== null && isInvalidValueIssue(issue2);
@@ -34628,8 +34818,8 @@ function normalizeParsedBtxmlConfig(raw) {
       formatter: normalizeRawFormatterOverrideConfig(override.formatter)
     })
   );
-  const ok = !diagnostics.some((d) => d.severity === DiagnosticSeverity.Error);
-  return { config: config2, diagnostics, ok };
+  const ok2 = !diagnostics.some((d) => d.severity === DiagnosticSeverity.Error);
+  return { config: config2, diagnostics, ok: ok2 };
 }
 function normalizeBtxmlConfig(raw) {
   const parsed = parseBtxmlConfig(raw);
@@ -34760,6 +34950,7 @@ var RuleCodes = {
   InvalidScriptOperandType: "BT407_INVALID_SCRIPT_OPERAND_TYPE",
   ScriptResultNotBoolCompatible: "BT408_SCRIPT_RESULT_NOT_BOOL_COMPATIBLE",
   ScriptVariableTypeMismatch: "BT410_SCRIPT_VARIABLE_TYPE_MISMATCH",
+  InvalidGlobalBlackboardIdentifier: "BT411_INVALID_GLOBAL_BLACKBOARD_IDENTIFIER",
   InvalidRootElement: "BT001_INVALID_ROOT_ELEMENT",
   MissingBTCPPFormat: "BT002_MISSING_BTCPP_FORMAT",
   MissingBehaviorTreeID: "BT003_MISSING_BEHAVIOR_TREE_ID",
@@ -34799,6 +34990,9 @@ var RuleCodes = {
   AugmentTargetNotFound: "BT117_AUGMENT_TARGET_NOT_FOUND",
   AugmentPortNotFound: "BT118_AUGMENT_PORT_NOT_FOUND",
   InvalidTypeRefinement: "BT119_INVALID_TYPE_REFINEMENT",
+  ConflictingModelKind: "BT120_CONFLICTING_MODEL_KIND",
+  UnusedModelDefinition: "BT121_UNUSED_MODEL_DEFINITION",
+  DuplicateModelDefinition: "BT122_DUPLICATE_MODEL_DEFINITION",
   ExternalModelFileNotFound: "BT321_EXTERNAL_MODEL_FILE_NOT_FOUND",
   AugmentationFileNotFound: "BT324_AUGMENTATION_FILE_NOT_FOUND",
   MissingTreeNodesModel: "BT322_MISSING_TREENODESMODEL",
@@ -34838,7 +35032,8 @@ var RULES = {
     codes: [
       RuleCodes.AssignmentToUnknownVariable,
       RuleCodes.InvalidCompoundAssignment,
-      RuleCodes.ScriptVariableTypeMismatch
+      RuleCodes.ScriptVariableTypeMismatch,
+      RuleCodes.InvalidGlobalBlackboardIdentifier
     ],
     defaultSeverity: "error",
     description: "Script assignments must target known variables and use compatible types."
@@ -35041,6 +35236,21 @@ var RULES = {
     defaultSeverity: "error",
     description: "Node model definitions must agree on kind and port shape."
   },
+  "model/no-conflicting-kind-for-id": {
+    code: RuleCodes.ConflictingModelKind,
+    defaultSeverity: "error",
+    description: "A model ID must not be defined with different kinds."
+  },
+  "model/no-unused-definition": {
+    code: RuleCodes.UnusedModelDefinition,
+    defaultSeverity: "error",
+    description: "Inline model definitions should be used in the same BT XML file."
+  },
+  "model/no-duplicate-definition": {
+    code: RuleCodes.DuplicateModelDefinition,
+    defaultSeverity: "error",
+    description: "A user-defined model (ID, kind) should be defined only once."
+  },
   "suppression/no-unused": {
     code: RuleCodes.UnusedSuppression,
     defaultSeverity: "warn",
@@ -35870,6 +36080,18 @@ function getSubTreeReferences(index, id) {
     (model) => model.subtreeReferences.filter((reference) => reference.id === id)
   );
 }
+function getAllNodeUsages(index) {
+  return getAllDocumentModels(index).flatMap((model) => model.nodeUsages);
+}
+function getNodeUsagesByUri(index) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const usage of getAllNodeUsages(index)) {
+    const list = grouped.get(usage.uri) ?? [];
+    list.push(usage);
+    grouped.set(usage.uri, list);
+  }
+  return grouped;
+}
 function getBehaviorTreeIds(index) {
   return [...asSemanticIndexState2(index).behaviorTreesById.keys()];
 }
@@ -36201,7 +36423,7 @@ function getBehaviorTreeElements(document) {
     (child) => child.kind === "element" && child.name === "BehaviorTree"
   );
 }
-function advancePosition(start, text) {
+function advancePosition2(start, text) {
   let line = start.line;
   let character = start.character;
   let offset = start.offset;
@@ -36217,32 +36439,66 @@ function advancePosition(start, text) {
   return { line, character, offset };
 }
 function rangeFromText(start, prefix, text) {
-  const rangeStart = advancePosition(start, prefix);
-  const rangeEnd = advancePosition(rangeStart, text);
+  const rangeStart = advancePosition2(start, prefix);
+  const rangeEnd = advancePosition2(rangeStart, text);
   return {
     start: rangeStart,
     end: rangeEnd
   };
 }
-function extractBlackboardReferences(document, attribute) {
+function extractBlackboardReferences(document, portName, attribute) {
   const baseRange = attribute.valueContentRange || attribute.valueRange;
   const rawValue = document.originalText.slice(baseRange.start.offset, baseRange.end.offset);
   const references = [];
-  for (const match of rawValue.matchAll(/\{([^}]+)\}/g)) {
+  for (const match of rawValue.matchAll(/\{[^}]*\}/g)) {
     const raw = match[0];
-    const key = match[1];
     const index = match.index ?? 0;
+    const parsed = parsePortBlackboardReference({ portName, rawValue: raw });
+    if (parsed.ok) {
+      references.push({
+        raw,
+        key: parsed.reference.key,
+        scope: parsed.reference.scope,
+        identity: makeBlackboardIdentity(parsed.reference),
+        range: rangeFromText(baseRange.start, rawValue.slice(0, index), raw),
+        syntax: parsed.reference.syntax === "shorthand" ? "shorthand" : "braced"
+      });
+      continue;
+    }
     references.push({
       raw,
-      key,
+      key: raw,
+      scope: "local",
+      identity: `invalid:${raw}`,
       range: rangeFromText(baseRange.start, rawValue.slice(0, index), raw),
-      syntax: "braced"
+      syntax: "invalid"
     });
   }
+  if (references.length === 0) {
+    const parsed = parsePortBlackboardReference({ portName, rawValue });
+    if (parsed.ok) {
+      const parsedOffset = Math.max(0, rawValue.indexOf(parsed.reference.raw));
+      references.push({
+        raw: parsed.reference.raw,
+        key: parsed.reference.key,
+        scope: parsed.reference.scope,
+        identity: makeBlackboardIdentity(parsed.reference),
+        range: rangeFromText(
+          baseRange.start,
+          rawValue.slice(0, parsedOffset),
+          parsed.reference.raw
+        ),
+        syntax: parsed.reference.syntax === "shorthand" ? "shorthand" : "braced"
+      });
+      return references;
+    }
+  }
   if (references.length === 0 && (rawValue.includes("{") || rawValue.includes("}"))) {
     references.push({
       raw: rawValue,
       key: rawValue,
+      scope: "local",
+      identity: `invalid:${rawValue}`,
       range: baseRange,
       syntax: "invalid"
     });
@@ -36349,10 +36605,13 @@ function getSemanticPortDirection(usage) {
 }
 function getSemanticPortValueKind(value, blackboardReferences) {
   if (value === "") return "empty";
-  if (value === "{=}") return "substitution";
+  if (value === "{=}" || value === "=") return "substitution";
   if (blackboardReferences.some((reference) => reference.syntax === "braced")) {
     return "blackboard-reference";
   }
+  if (blackboardReferences.some((reference) => reference.syntax === "shorthand")) {
+    return "substitution";
+  }
   if (blackboardReferences.some((reference) => reference.syntax === "invalid")) {
     return "unknown";
   }
@@ -36454,7 +36713,11 @@ function buildBtDocumentView(document, options) {
       attribute: portUsage.attribute,
       declaredPort: toPortResolution(portUsage),
       usage: portUsage,
-      blackboardReferences: extractBlackboardReferences(document, portUsage.attribute)
+      blackboardReferences: extractBlackboardReferences(
+        document,
+        portUsage.name,
+        portUsage.attribute
+      )
     }));
     node.children = element.children.filter((child) => child.kind === "element").map(
       (child, childIndex) => buildTreeNode(child, behaviorTree, node, [...path4, childIndex])
@@ -36531,7 +36794,11 @@ function buildSemanticDocumentView(document, index, options) {
           attribute: portUsage.attribute,
           declaredPort: toPortResolution(portUsage),
           usage: portUsage,
-          blackboardReferences: extractBlackboardReferences(document, portUsage.attribute)
+          blackboardReferences: extractBlackboardReferences(
+            document,
+            portUsage.name,
+            portUsage.attribute
+          )
         })
       )
     };
@@ -36615,6 +36882,50 @@ function findSemanticPortBindingAtPosition(view, position) {
   return void 0;
 }
 
+// ../semantic/src/model-definition-facts.ts
+function modelDefinitionKeyString(key) {
+  return `${key.kind}\0${key.id}`;
+}
+function getModelDefinitionFacts(index) {
+  return getAllNodeModelDefinitions(index).map((model) => {
+    const sourceKind = model.source ?? model.sourceMeta?.sourceKind;
+    return {
+      key: {
+        id: model.id,
+        kind: model.kind
+      },
+      model,
+      id: model.id,
+      kind: model.kind,
+      uri: model.uri,
+      range: model.range,
+      sourceKind,
+      isBuiltin: sourceKind === "builtin",
+      isCanonicalModelFile: sourceKind === "external-tree-nodes-model",
+      editable: model.editable !== false
+    };
+  });
+}
+function groupModelDefinitionsById(facts) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const fact of facts) {
+    const list = grouped.get(fact.id) ?? [];
+    list.push(fact);
+    grouped.set(fact.id, list);
+  }
+  return grouped;
+}
+function groupModelDefinitionsByKey(facts) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const fact of facts) {
+    const key = modelDefinitionKeyString(fact.key);
+    const list = grouped.get(key) ?? [];
+    list.push(fact);
+    grouped.set(key, list);
+  }
+  return grouped;
+}
+
 // ../syntax/src/parse/document-kind.ts
 function finalizeDocumentKind(input) {
   const { document, diagnostics, options, partial: partial2 } = input;
@@ -37503,6 +37814,9 @@ function parseBtXml(text, options = {}) {
     );
   }
   const root = document.root;
+  const looksLikeBtXml = root?.name === "BehaviorTree" || root?.name === "TreeNodesModel" || root?.name === "root" && (root.attributes.some((a) => a.name === "BTCPP_format" && a.value === "4") || root.children.some(
+    (child) => child.kind === "element" && (child.name === "BehaviorTree" || child.name === "TreeNodesModel")
+  ));
   if (root) {
     for (const node of document.nodes) {
       if (node === root) continue;
@@ -37521,7 +37835,7 @@ function parseBtXml(text, options = {}) {
       }
     }
   }
-  if (!document.xmlDeclaration) {
+  if (!document.xmlDeclaration && !looksLikeBtXml) {
     addOptionalDiagnostic(
       "XML008_MISSING_DECLARATION",
       DiagnosticSeverity.Warning,
@@ -37535,7 +37849,7 @@ function parseBtXml(text, options = {}) {
         ]
       }
     );
-  } else if (document.xmlDeclaration.encoding && document.xmlDeclaration.encoding.toUpperCase() !== "UTF-8") {
+  } else if (document.xmlDeclaration?.encoding && document.xmlDeclaration.encoding.toUpperCase() !== "UTF-8") {
     const encoding = document.xmlDeclaration.encoding;
     addDiagnostic(
       "XML009_INVALID_ENCODING",
@@ -38879,6 +39193,192 @@ async function resolveIncludeGraph(input) {
   };
 }
 
+// ../project/src/model-conventions.ts
+var RULE_CONFLICTING_KIND = "model/no-conflicting-kind-for-id";
+var RULE_UNUSED_DEFINITION = "model/no-unused-definition";
+var RULE_DUPLICATE_DEFINITION = "model/no-duplicate-definition";
+function createConventionDiagnostic(input) {
+  const diagnostic = createDiagnostic(
+    input.code,
+    input.severity,
+    input.message,
+    input.range,
+    input.uri,
+    void 0,
+    input.data
+  );
+  return {
+    ...diagnostic,
+    rule: input.rule,
+    ...input.relatedInformation ? { relatedInformation: input.relatedInformation } : {}
+  };
+}
+function resolveConventionSeverity(config2, rule) {
+  const severity = getRuleSeverity(config2.linter.rules, rule);
+  if (severity === "off") return void 0;
+  if (severity === "info") return DiagnosticSeverity.Info;
+  if (severity === "warn") return DiagnosticSeverity.Warning;
+  return DiagnosticSeverity.Error;
+}
+function definitionRange(definition) {
+  return definition.model.idRange ?? definition.range;
+}
+function definitionInfo(definition) {
+  return {
+    uri: definition.uri,
+    sourceKind: definition.sourceKind,
+    modelKind: definition.kind,
+    range: definition.range
+  };
+}
+function validateConflictingKinds(input) {
+  const severity = resolveConventionSeverity(input.config, RULE_CONFLICTING_KIND);
+  if (!severity) return [];
+  const diagnostics = [];
+  const groupedById = groupModelDefinitionsById(input.facts.filter((fact) => !fact.isBuiltin));
+  for (const [id, definitions] of groupedById) {
+    const kinds = new Set(definitions.map((definition) => definition.kind));
+    if (kinds.size <= 1) continue;
+    const primary = definitions[0];
+    if (!primary) continue;
+    for (const definition of definitions.slice(1)) {
+      if (definition.kind === primary.kind) continue;
+      const primaryRange = definitionRange(primary);
+      const relatedInformation = primary.uri && primaryRange ? [
+        {
+          uri: primary.uri,
+          range: primaryRange,
+          message: "first conflicting definition"
+        }
+      ] : void 0;
+      diagnostics.push(
+        createConventionDiagnostic({
+          code: "BT120_CONFLICTING_MODEL_KIND",
+          message: `model ID \`${id}\` has conflicting kinds (\`${primary.kind}\` vs \`${definition.kind}\`)`,
+          uri: definition.uri,
+          range: definitionRange(definition),
+          rule: RULE_CONFLICTING_KIND,
+          severity,
+          data: {
+            kind: "conflicting-model-kind",
+            nodeId: id,
+            definitions: definitions.map(definitionInfo)
+          },
+          relatedInformation
+        })
+      );
+    }
+  }
+  return diagnostics;
+}
+function validateUsedOnly(input) {
+  if (input.config.models.convention !== "used-only") return [];
+  const severity = resolveConventionSeverity(input.config, RULE_UNUSED_DEFINITION);
+  if (!severity) return [];
+  const diagnostics = [];
+  const usagesByUri = getNodeUsagesByUri(input.index);
+  for (const definition of input.facts) {
+    if (definition.isBuiltin) continue;
+    if (definition.sourceKind !== "inline-tree-nodes-model") continue;
+    if (definition.kind === "SubTree") continue;
+    const sameFileNodeUsages = usagesByUri.get(definition.uri ?? "") ?? [];
+    const usedNodeIds = new Set(
+      sameFileNodeUsages.filter((usage) => usage.kind === "node").map((usage) => usage.id)
+    );
+    if (usedNodeIds.has(definition.id)) continue;
+    diagnostics.push(
+      createConventionDiagnostic({
+        code: "BT121_UNUSED_MODEL_DEFINITION",
+        message: `unused inline model definition \`${definition.id}\` in this file`,
+        uri: definition.uri,
+        range: definitionRange(definition),
+        rule: RULE_UNUSED_DEFINITION,
+        severity,
+        data: {
+          kind: "unused-model-definition",
+          nodeId: definition.id,
+          modelKind: definition.kind,
+          sourceKind: "inline-tree-nodes-model",
+          fix: definition.uri && definitionRange(definition) && definition.editable ? {
+            kind: "delete-definition",
+            uri: definition.uri,
+            range: definitionRange(definition)
+          } : void 0
+        }
+      })
+    );
+  }
+  return diagnostics;
+}
+function duplicateFix(definitions) {
+  const canonical = definitions.filter((definition) => definition.isCanonicalModelFile);
+  if (canonical.length !== 1) return void 0;
+  const keep = canonical[0];
+  if (!keep?.uri) return void 0;
+  const deleteTargets = definitions.filter((definition) => definition !== keep);
+  if (deleteTargets.some(
+    (definition) => !definition.uri || !definitionRange(definition) || !definition.editable
+  )) {
+    return void 0;
+  }
+  return {
+    kind: "delete-non-canonical-definitions",
+    keep: {
+      uri: keep.uri,
+      range: definitionRange(keep)
+    },
+    delete: deleteTargets.map((definition) => ({
+      uri: definition.uri,
+      range: definitionRange(definition)
+    }))
+  };
+}
+function validateSingleSource(input) {
+  if (input.config.models.convention !== "single-source") return [];
+  const severity = resolveConventionSeverity(input.config, RULE_DUPLICATE_DEFINITION);
+  if (!severity) return [];
+  const diagnostics = [];
+  const groupedByKey = groupModelDefinitionsByKey(input.facts.filter((fact) => !fact.isBuiltin));
+  for (const definitions of groupedByKey.values()) {
+    if (definitions.length <= 1) continue;
+    const primary = definitions[0];
+    if (!primary) continue;
+    diagnostics.push(
+      createConventionDiagnostic({
+        code: "BT122_DUPLICATE_MODEL_DEFINITION",
+        message: `duplicate model definition for \`${primary.id}\` (${primary.kind})`,
+        uri: primary.uri,
+        range: definitionRange(primary),
+        rule: RULE_DUPLICATE_DEFINITION,
+        severity,
+        data: {
+          kind: "duplicate-model-definition",
+          nodeId: primary.id,
+          modelKind: primary.kind,
+          definitions: definitions.map((definition) => ({
+            uri: definition.uri,
+            sourceKind: definition.sourceKind,
+            range: definition.range,
+            canonical: definition.isCanonicalModelFile,
+            editable: definition.editable
+          })),
+          fix: duplicateFix(definitions)
+        }
+      })
+    );
+  }
+  return diagnostics;
+}
+function validateModelConventions(input) {
+  if (input.config.linter.enabled === false) return [];
+  const facts = getModelDefinitionFacts(input.index);
+  return [
+    ...validateConflictingKinds({ config: input.config, facts }),
+    ...validateUsedOnly({ config: input.config, index: input.index, facts }),
+    ...validateSingleSource({ config: input.config, facts })
+  ];
+}
+
 // ../project/src/node-definitions.ts
 function createPositionAt2(text) {
   const lineStarts = [0];
@@ -38941,8 +39441,8 @@ async function loadProjectNodeModels(input) {
       if (parseErrors.length > 0 || !jsonTree) {
         throw new Error(`JSON parse error at offset ${parseErrors[0]?.offset ?? 0}`);
       }
-    } catch (error51) {
-      const errorMessage = String(error51.message || error51);
+    } catch (error52) {
+      const errorMessage = String(error52.message || error52);
       diagnostics.push(
         createDiagnostic(
           RuleCodes.InvalidNodeDefinitionJson,
@@ -39076,7 +39576,10 @@ async function buildProjectIndex(input) {
   }) : void 0;
   const externalDocs = input.externalModelDocuments;
   const augmentations = input.augmentations;
-  const nodeDefinitions = await loadProjectNodeModels({ project: input.project, host: input.host });
+  const nodeDefinitions = await loadProjectNodeModels({
+    project: input.project,
+    host: input.host
+  });
   diagnostics.push(...nodeDefinitions.diagnostics);
   const nodeDefinitionModels = nodeDefinitions.nodeModels;
   const activeDocs = graphResult && (mode === "entrypoints" || input.resolveGraph) ? uniqueDocuments([
@@ -39098,7 +39601,13 @@ async function buildProjectIndex(input) {
     includeIssuesByUri: groupIncludeIssues(graphResult?.issues ?? []),
     suppressionIssuesByUri: /* @__PURE__ */ new Map()
   };
-  diagnostics.push(...semanticResult.diagnostics);
+  diagnostics.push(
+    ...semanticResult.diagnostics,
+    ...validateModelConventions({
+      config: resolvedConfig,
+      index: semanticResult.index
+    })
+  );
   const reachableBehaviorTreesById = new Map(
     getBehaviorTreeIds(semanticResult.index).map((id) => [
       id,
@@ -39487,11 +39996,11 @@ function reportLiteralValidation(context, input) {
   });
 }
 function validateLiteralValue(input) {
-  const remappedKey = getRemappedKey(input.port.name, input.value);
-  if (input.allowRemap && remappedKey !== void 0) {
+  const remappedReference = getExactBlackboardReference(input.port.name, input.value);
+  if (input.allowRemap && remappedReference !== void 0) {
     return void 0;
   }
-  if (!input.allowRemap && remappedKey !== void 0) {
+  if (!input.allowRemap && remappedReference !== void 0) {
     return invalidLiteral(input.diagnosticCode, input.value, input.portLabel);
   }
   if (input.port.enum && !input.port.enum.includes(input.value)) {
@@ -39524,8 +40033,12 @@ function getResolvedPortType(port) {
 function getResolvedPortTypeDefinition(registry2, port) {
   return resolveTypeDefinition(registry2, getResolvedPortType(port));
 }
-function getExactRemappedKey(portName, rawValue) {
-  return getRemappedKey(portName, rawValue);
+function getExactBlackboardReference(portName, rawValue) {
+  const parsed = parsePortBlackboardReference({
+    portName,
+    rawValue: rawValue.trim()
+  });
+  return parsed.ok ? parsed.reference : void 0;
 }
 function invalidLiteral(code, literal2, portLabel) {
   return {
@@ -39804,7 +40317,7 @@ var modelRules = [
           const port = model?.ports.find((candidate) => candidate.name === portName);
           if (!port) return;
           if (port.direction === "output") {
-            if (getRemappedKey(port.name, defaultAttr.value) === void 0) {
+            if (getExactBlackboardReference(port.name, defaultAttr.value) === void 0) {
               context.report({
                 code: RuleCodes.InvalidPortDefaultValue,
                 message: `output port default for \`${port.name}\` must be a blackboard remap`,
@@ -39841,30 +40354,34 @@ var modelRules = [
       return {
         ProgramExit() {
           const typeRegistry = getTypeRegistry(context.semantic);
-          const bindingsByKey = /* @__PURE__ */ new Map();
+          const bindingsByIdentity = /* @__PURE__ */ new Map();
           const allowStringEntryCompatibility = context.options.allowStringEntryCompatibility ?? true;
           for (const node of context.view.nodes) {
             for (const binding of node.portBindings) {
               if (binding.declaredPort.status !== "resolved") continue;
-              const key = getExactRemappedKey(binding.name, binding.value);
-              if (!key) continue;
+              const reference = getExactBlackboardReference(binding.name, binding.value);
+              if (!reference) continue;
               const typeDefinition = getResolvedPortTypeDefinition(
                 typeRegistry,
                 binding.declaredPort.port
               );
               if (!typeDefinition || typeDefinition.kind === "any") continue;
-              const records = bindingsByKey.get(key) ?? [];
+              const identity = makeBlackboardIdentity(reference);
+              const records = bindingsByIdentity.get(identity) ?? [];
               records.push({
-                key,
+                key: reference.key,
+                scope: reference.scope,
+                displayName: formatBlackboardReference(reference),
+                identity,
                 nodeId: describeBindingNode(node.element),
                 port: binding.declaredPort.port,
                 typeDefinition,
                 range: binding.attribute.range
               });
-              bindingsByKey.set(key, records);
+              bindingsByIdentity.set(identity, records);
             }
           }
-          for (const [key, bindings] of bindingsByKey) {
+          for (const bindings of bindingsByIdentity.values()) {
             const incompatibleTypes = collectIncompatibleTypes(
               context.semantic,
               bindings,
@@ -39876,10 +40393,10 @@ var modelRules = [
             );
             context.report({
               code: RuleCodes.BlackboardTypeMismatch,
-              message: `blackboard entry \`${key}\` is used with incompatible port types: ${incompatibleTypes.map((type) => `\`${type}\``).join(", ")}`,
+              message: `blackboard entry \`${primary?.displayName ?? bindings[0]?.displayName ?? bindings[0]?.key ?? ""}\` is used with incompatible port types: ${incompatibleTypes.map((type) => `\`${type}\``).join(", ")}`,
               range: primary?.range,
               details: {
-                primaryLabel: `blackboard entry \`${key}\` mixes incompatible port types`,
+                primaryLabel: `blackboard entry \`${primary?.displayName ?? bindings[0]?.displayName ?? bindings[0]?.key ?? ""}\` mixes incompatible port types`,
                 notes: bindings.filter((binding) => incompatibleTypes.includes(binding.typeDefinition.canonical)).map(
                   (binding) => `${binding.nodeId}.${binding.port.name} declares ${formatPortType(binding.port, binding.typeDefinition)}`
                 ),
@@ -39906,7 +40423,8 @@ var modelRules = [
             const portUsage = context.getPortUsage(element, attr.name);
             if (portUsage?.status !== "resolved") continue;
             if (portUsage.port.direction !== "output") continue;
-            if (getExactRemappedKey(portUsage.port.name, attr.value) !== void 0) continue;
+            if (getExactBlackboardReference(portUsage.port.name, attr.value) !== void 0)
+              continue;
             context.report({
               code: RuleCodes.OutputPortRequiresRemap,
               message: `output port \`${portUsage.port.name}\` must be remapped to a blackboard entry`,
@@ -39998,6 +40516,22 @@ function classifyScriptAttribute(input) {
   return void 0;
 }
 
+// ../script/src/analysis/blackboard.ts
+function classifyScriptIdentifier(name) {
+  if (!name.startsWith("@")) {
+    return { kind: "local", name };
+  }
+  const parsed = parseScriptBlackboardIdentifier({ rawName: name });
+  if (!parsed.ok) {
+    return {
+      kind: "invalid-global-blackboard",
+      raw: name,
+      message: `invalid global blackboard identifier \`${name}\``
+    };
+  }
+  return { kind: "global-blackboard", key: parsed.reference.key };
+}
+
 // ../script/src/tokenizer.ts
 var TWO_CHAR_TOKENS = /* @__PURE__ */ new Map([
   ["..", "DotDot"],
@@ -40571,12 +41105,22 @@ function createScriptEnvironment(input = {}) {
   const registry2 = createTypeRegistry(input.augmentations ?? []);
   const areTypesCompatible3 = input.areTypesCompatible ?? ((left, right) => areTypesCompatible(registry2, left, right));
   const compatibilityKeys = /* @__PURE__ */ new Map();
+  const globalCompatibilityKeys = /* @__PURE__ */ new Map();
   const environment = {
     symbols: /* @__PURE__ */ new Map(),
+    globalBlackboard: /* @__PURE__ */ new Map(),
     enums: normalizeEnums(input.enums, input.augmentations ?? [])
   };
   for (const symbol2 of input.symbols ?? []) {
-    mergeScriptSymbol(environment, compatibilityKeys, symbol2, areTypesCompatible3);
+    mergeScriptSymbol(environment.symbols, compatibilityKeys, symbol2, areTypesCompatible3);
+  }
+  for (const symbol2 of input.globalBlackboardSymbols ?? []) {
+    mergeScriptSymbol(
+      environment.globalBlackboard,
+      globalCompatibilityKeys,
+      symbol2,
+      areTypesCompatible3
+    );
   }
   return environment;
 }
@@ -40585,6 +41129,12 @@ function cloneScriptEnvironment(environment) {
     symbols: new Map(
       [...environment?.symbols.entries() ?? []].map(([name, symbol2]) => [name, { ...symbol2 }])
     ),
+    globalBlackboard: new Map(
+      [...environment?.globalBlackboard.entries() ?? []].map(([name, symbol2]) => [
+        name,
+        { ...symbol2 }
+      ])
+    ),
     enums: new Map(environment?.enums ?? [])
   };
 }
@@ -40613,10 +41163,14 @@ function analyzeScriptFlow(input) {
       ...analysis ? { analysis } : {}
     });
     environment.symbols.clear();
+    environment.globalBlackboard.clear();
     environment.enums.clear();
     for (const [name, symbol2] of environmentAfter.symbols) {
       environment.symbols.set(name, { ...symbol2 });
     }
+    for (const [name, symbol2] of environmentAfter.globalBlackboard) {
+      environment.globalBlackboard.set(name, { ...symbol2 });
+    }
     for (const [name, value] of environmentAfter.enums) {
       environment.enums.set(name, value);
     }
@@ -40692,10 +41246,10 @@ function normalizeEnums(enums, augmentations) {
   }
   return collected;
 }
-function mergeScriptSymbol(environment, compatibilityKeys, next, areTypesCompatible3) {
-  const existing = environment.symbols.get(next.name);
+function mergeScriptSymbol(target, compatibilityKeys, next, areTypesCompatible3) {
+  const existing = target.get(next.name);
   if (!existing) {
-    environment.symbols.set(next.name, {
+    target.set(next.name, {
       name: next.name,
       type: next.type,
       source: next.source,
@@ -40707,7 +41261,7 @@ function mergeScriptSymbol(environment, compatibilityKeys, next, areTypesCompati
   }
   const existingCompatibilityKey = compatibilityKeys.get(next.name);
   const conflict = existing.conflict === true || existingCompatibilityKey !== void 0 && next.compatibilityKey !== void 0 && !areTypesCompatible3(existingCompatibilityKey, next.compatibilityKey) || !areScriptTypesCompatible(existing.type, next.type);
-  environment.symbols.set(next.name, {
+  target.set(next.name, {
     ...existing,
     readable: existing.readable || next.readable,
     writable: existing.writable || next.writable,
@@ -40729,6 +41283,8 @@ function analyzeScript(input) {
   const identifiers = [];
   const resolvedIdentifiers = [];
   const unknownIdentifiers = [];
+  const globalBlackboardAccesses = [];
+  const invalidGlobalBlackboardIdentifiers = [];
   const introducedSymbols = [];
   const diagnostics = [];
   const statementTypes = [];
@@ -40741,6 +41297,8 @@ function analyzeScript(input) {
         identifiers,
         resolvedIdentifiers,
         unknownIdentifiers,
+        globalBlackboardAccesses,
+        invalidGlobalBlackboardIdentifiers,
         introducedSymbols,
         diagnostics,
         attributeName: input.attributeName ?? "code",
@@ -40753,6 +41311,8 @@ function analyzeScript(input) {
     identifiers,
     resolvedIdentifiers,
     unknownIdentifiers,
+    globalBlackboardAccesses,
+    invalidGlobalBlackboardIdentifiers,
     introducedSymbols,
     diagnostics,
     statementTypes,
@@ -40924,6 +41484,66 @@ function analyzeAssignment(context) {
     statementIndex: context.statementIndex
   };
   identifiers.push(access2);
+  const classified = classifyScriptIdentifier(left.name);
+  if (classified.kind === "invalid-global-blackboard") {
+    context.invalidGlobalBlackboardIdentifiers.push(access2);
+    reportInvalidGlobalBlackboardIdentifier(
+      context,
+      left.range,
+      classified.raw,
+      classified.message
+    );
+    return ERROR_TYPE;
+  }
+  if (classified.kind === "global-blackboard") {
+    const existingSymbol2 = environment.globalBlackboard.get(classified.key);
+    const accessType = expression.operator === ":=" ? rightType : expression.operator === "=" ? existingSymbol2 && isScriptTypeAssignable(existingSymbol2.type, rightType) ? rightType : !existingSymbol2 ? rightType : void 0 : compoundAssignmentResult(
+      existingSymbol2?.type ?? UNKNOWN_TYPE,
+      rightType,
+      expression.operator
+    );
+    if (expression.operator !== ":=" && expression.operator !== "=" && !accessType) {
+      reportDiagnostic(
+        context,
+        "invalid-compound-assignment",
+        expression.range,
+        `operator \`${expression.operator}\` is not valid for these operand types`,
+        `compound assignment \`${expression.operator}\` is not allowed here`,
+        expression.operator === "+=" ? "use number += number or string += string" : "use numeric operands for this compound assignment"
+      );
+      return ERROR_TYPE;
+    }
+    if ((expression.operator === ":=" || expression.operator === "=") && existingSymbol2 && !isScriptTypeAssignable(existingSymbol2.type, rightType)) {
+      reportTypeMismatch(context, left, existingSymbol2.type, rightType);
+      return ERROR_TYPE;
+    }
+    const symbol2 = existingSymbol2 ? { ...existingSymbol2 } : {
+      name: classified.key,
+      type: rightType,
+      source: {
+        kind: "global-blackboard",
+        key: classified.key,
+        range: left.range,
+        originId: context.originId
+      },
+      readable: true,
+      writable: true
+    };
+    symbol2.type = accessType ?? rightType;
+    environment.globalBlackboard.set(classified.key, symbol2);
+    context.resolvedIdentifiers.push({
+      access: access2,
+      resolution: { kind: "global-blackboard", key: classified.key, symbol: symbol2 }
+    });
+    context.globalBlackboardAccesses.push({
+      key: classified.key,
+      rawName: left.name,
+      kind: accessKind,
+      range: left.range,
+      inferredType: symbol2.type
+    });
+    return symbol2.type;
+  }
   const existingSymbol = environment.symbols.get(left.name);
   if (expression.operator === ":=" && !existingSymbol) {
     const symbol2 = {
@@ -41002,6 +41622,27 @@ function analyzeReadIdentifier(context, name, range) {
     statementIndex: context.statementIndex
   };
   context.identifiers.push(access2);
+  const classified = classifyScriptIdentifier(name);
+  if (classified.kind === "invalid-global-blackboard") {
+    context.invalidGlobalBlackboardIdentifiers.push(access2);
+    reportInvalidGlobalBlackboardIdentifier(context, range, classified.raw, classified.message);
+    return ERROR_TYPE;
+  }
+  if (classified.kind === "global-blackboard") {
+    const symbol3 = context.environment.globalBlackboard.get(classified.key);
+    context.globalBlackboardAccesses.push({
+      key: classified.key,
+      rawName: name,
+      kind: "read",
+      range,
+      inferredType: symbol3?.type ?? UNKNOWN_TYPE
+    });
+    context.resolvedIdentifiers.push({
+      access: access2,
+      resolution: { kind: "global-blackboard", key: classified.key, ...symbol3 ? { symbol: symbol3 } : {} }
+    });
+    return symbol3?.type ?? UNKNOWN_TYPE;
+  }
   const enumValue = context.environment.enums.get(name);
   if (enumValue !== void 0) {
     context.resolvedIdentifiers.push({
@@ -41073,6 +41714,16 @@ function reportTypeMismatch(context, identifier, targetType, sourceType) {
     "assign a compatible value or change the variable's source type"
   );
 }
+function reportInvalidGlobalBlackboardIdentifier(context, range, rawName, message) {
+  reportDiagnostic(
+    context,
+    "invalid-global-blackboard-identifier",
+    range,
+    message,
+    `\`${rawName}\` is not a valid global blackboard identifier`,
+    "use `@name` with a valid blackboard key that starts with a letter or underscore"
+  );
+}
 function refineLocalSymbol(symbol2, nextType) {
   if (symbol2.source.kind !== "script-assignment") return;
   if (symbol2.type.kind !== "unknown" && symbol2.type.kind !== "error") return;
@@ -41206,7 +41857,10 @@ function getScriptCursorContext(input) {
     };
   }
   if (containing && (containing.type === "Integer" || containing.type === "Real" || containing.type === "String" || containing.type === "Boolean")) {
-    return { kind: "literal", range: { start: containing.start, end: containing.end } };
+    return {
+      kind: "literal",
+      range: { start: containing.start, end: containing.end }
+    };
   }
   const operatorRange = scanOperatorRange(source, cursorOffset);
   const previousBeforeOperator = previousToken(tokens, operatorRange.start);
@@ -41260,6 +41914,19 @@ function identifierCompletionItems(input, cursor) {
       sortText: symbol2.source.kind === "script-assignment" ? `1-${symbol2.name}` : `2-${symbol2.name}`
     });
   }
+  for (const symbol2 of environment.globalBlackboard.values()) {
+    if (symbol2.conflict) continue;
+    if (!symbol2.readable) continue;
+    const label = `@${symbol2.name}`;
+    if (!matchesPrefix(label, prefix)) continue;
+    items.push({
+      label,
+      kind: "identifier",
+      detail: describeScriptSymbol(symbol2),
+      replaceRange: cursor.range,
+      sortText: `2-${label}`
+    });
+  }
   for (const value of ["true", "false"]) {
     if (!matchesPrefix(value, prefix)) continue;
     items.push({
@@ -41332,6 +41999,31 @@ function environmentBeforeCursor(input) {
       if (symbol2.source.range.end > input.cursorOffset) continue;
       next.symbols.set(symbol2.name, symbol2);
     }
+    for (const access2 of analyzed.globalBlackboardAccesses) {
+      if (access2.kind === "read") continue;
+      if (access2.range.end > input.cursorOffset) continue;
+      const analyzedSymbol = analyzed.environment.globalBlackboard.get(access2.key);
+      const existing = next.globalBlackboard.get(access2.key);
+      let symbol2;
+      if (analyzedSymbol) {
+        symbol2 = { ...analyzedSymbol };
+      } else if (existing) {
+        symbol2 = { ...existing, type: access2.inferredType };
+      } else {
+        symbol2 = {
+          name: access2.key,
+          type: access2.inferredType,
+          source: {
+            kind: "global-blackboard",
+            key: access2.key,
+            range: access2.range
+          },
+          readable: true,
+          writable: true
+        };
+      }
+      next.globalBlackboard.set(access2.key, symbol2);
+    }
     return next;
   }
   for (const token of tokens) {
@@ -41340,9 +42032,26 @@ function environmentBeforeCursor(input) {
     const next = nextToken(tokens, token.end);
     if (next?.type !== "ColonEqual") continue;
     if (next.end > input.cursorOffset) continue;
-    if (environment.symbols.has(token.text)) continue;
-    environment.symbols.set(token.text, {
-      name: token.text,
+    const classified = classifyScriptIdentifier(token.text);
+    if (classified.kind === "invalid-global-blackboard") continue;
+    if (classified.kind === "global-blackboard") {
+      if (environment.globalBlackboard.has(classified.key)) continue;
+      environment.globalBlackboard.set(classified.key, {
+        name: classified.key,
+        type: { kind: "unknown" },
+        source: {
+          kind: "global-blackboard",
+          key: classified.key,
+          range: { start: token.start, end: token.end }
+        },
+        readable: true,
+        writable: true
+      });
+      continue;
+    }
+    if (environment.symbols.has(classified.name)) continue;
+    environment.symbols.set(classified.name, {
+      name: classified.name,
       type: { kind: "unknown" },
       source: {
         kind: "script-assignment",
@@ -41360,10 +42069,14 @@ function describeScriptSymbol(symbol2) {
   switch (symbol2.source.kind) {
     case "port-remap":
       return `${typeLabel} from ${symbol2.source.nodeType ?? "node"}.${symbol2.source.portName}`;
+    case "global-blackboard-remap":
+      return `${typeLabel} from global blackboard ${symbol2.source.nodeType ?? "node"}.${symbol2.source.portName}`;
     case "subtree-port":
       return `${typeLabel} from ${symbol2.source.nodeType ?? "SubTree"}.${symbol2.source.portName}`;
     case "script-assignment":
       return `${typeLabel} from earlier ${symbol2.source.attributeName} declaration`;
+    case "global-blackboard":
+      return `${typeLabel} from global blackboard @${symbol2.source.key}`;
     case "augmentation":
       return `${typeLabel} from augmentation`;
     case "enum":
@@ -41505,6 +42218,7 @@ function getBehaviorTreeScriptFlow(context, behaviorTree) {
 function buildBaseScriptEnvironment(context, nodes) {
   const registry2 = getTypeRegistry(context.semantic);
   const portSymbols = [];
+  const globalBlackboardSymbols = [];
   const behaviorTreeId = nodes[0]?.behaviorTree.id;
   if (behaviorTreeId) {
     const subtreeModel = context.getNodeModel(behaviorTreeId);
@@ -41530,17 +42244,21 @@ function buildBaseScriptEnvironment(context, nodes) {
     }
   }
   for (const node of nodes) {
-    const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
     for (const binding of node.portBindings) {
       if (binding.usage.status !== "resolved") continue;
-      const remappedKey = getRemappedKey(binding.usage.port.name, binding.usage.value);
-      if (!remappedKey) continue;
+      const parsed = parsePortBlackboardReference({
+        portName: binding.usage.port.name,
+        rawValue: binding.usage.value
+      });
+      if (!parsed.ok) continue;
+      if (parsed.reference.scope === "global") continue;
       const resolvedTypeName = getResolvedPortType(binding.usage.port);
       const resolvedDefinition = getTypeDefinition(context.semantic, resolvedTypeName);
       const compatibilityKey = resolvedDefinition?.canonical ?? resolvedTypeName;
       const direction = binding.usage.port.direction;
+      const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
       portSymbols.push({
-        name: remappedKey,
+        name: parsed.reference.key,
         type: scriptTypeFromTypeName(registry2, resolvedTypeName),
         source: {
           kind: "port-remap",
@@ -41554,12 +42272,47 @@ function buildBaseScriptEnvironment(context, nodes) {
       });
     }
   }
+  globalBlackboardSymbols.push(...collectGlobalBlackboardSeedSymbols(context, registry2));
   return createScriptEnvironment({
     symbols: portSymbols,
+    globalBlackboardSymbols,
     augmentations: getModelAugmentations(context.semantic),
     areTypesCompatible: (left, right) => left && right ? areTypesCompatible2(context.semantic, left, right) : true
   });
 }
+function collectGlobalBlackboardSeedSymbols(context, registry2) {
+  const symbols = [];
+  for (const node of context.view.nodes) {
+    const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
+    for (const binding of node.portBindings) {
+      if (binding.usage.status !== "resolved") continue;
+      const parsed = parsePortBlackboardReference({
+        portName: binding.usage.port.name,
+        rawValue: binding.usage.value
+      });
+      if (!parsed.ok || parsed.reference.scope !== "global") continue;
+      const resolvedTypeName = getResolvedPortType(binding.usage.port);
+      const resolvedDefinition = getTypeDefinition(context.semantic, resolvedTypeName);
+      const compatibilityKey = resolvedDefinition?.canonical ?? resolvedTypeName;
+      const direction = binding.usage.port.direction;
+      symbols.push({
+        name: parsed.reference.key,
+        type: scriptTypeFromTypeName(registry2, resolvedTypeName),
+        source: {
+          kind: "global-blackboard-remap",
+          nodeType,
+          portName: binding.usage.port.name,
+          direction,
+          key: parsed.reference.key
+        },
+        readable: direction === "input" || direction === "output" || direction === "inout",
+        writable: direction === "output" || direction === "inout",
+        compatibilityKey
+      });
+    }
+  }
+  return symbols;
+}
 
 // ../analyzer/src/analysis/rules/script/no-unknown-variable.ts
 var scriptNoUnknownVariableRule = makeRuleModule({
@@ -41595,7 +42348,7 @@ var scriptValidAssignmentRule = makeRuleModule({
         for (const candidate of getAnalyzedScriptAttributeCandidates(context, element)) {
           if (!candidate.analysis) continue;
           for (const diagnostic of candidate.analysis.diagnostics) {
-            const code = diagnostic.code === "assignment-to-unknown-variable" ? RuleCodes.AssignmentToUnknownVariable : diagnostic.code === "invalid-compound-assignment" ? RuleCodes.InvalidCompoundAssignment : diagnostic.code === "variable-type-mismatch" ? RuleCodes.ScriptVariableTypeMismatch : void 0;
+            const code = diagnostic.code === "assignment-to-unknown-variable" ? RuleCodes.AssignmentToUnknownVariable : diagnostic.code === "invalid-compound-assignment" ? RuleCodes.InvalidCompoundAssignment : diagnostic.code === "variable-type-mismatch" ? RuleCodes.ScriptVariableTypeMismatch : diagnostic.code === "invalid-global-blackboard-identifier" ? RuleCodes.InvalidGlobalBlackboardIdentifier : void 0;
             if (!code) continue;
             context.report({
               code,
@@ -41668,16 +42421,16 @@ var scriptValidSyntaxRule = makeRuleModule({
       Element(element) {
         for (const candidate of getScriptAttributeCandidates(context, element)) {
           if (candidate.parseResult.ok) continue;
-          for (const error51 of candidate.parseResult.errors) {
-            const code = error51.kind === "empty-script" ? RuleCodes.EmptyScript : error51.kind === "invalid-token" ? RuleCodes.InvalidScriptToken : RuleCodes.InvalidScriptSyntax;
+          for (const error52 of candidate.parseResult.errors) {
+            const code = error52.kind === "empty-script" ? RuleCodes.EmptyScript : error52.kind === "invalid-token" ? RuleCodes.InvalidScriptToken : RuleCodes.InvalidScriptSyntax;
             context.report({
               code,
-              message: error51.message,
-              range: error51.kind === "empty-script" ? candidate.attribute.valueContentRange ?? candidate.attribute.valueRange ?? mapScriptRangeToDocument(
+              message: error52.message,
+              range: error52.kind === "empty-script" ? candidate.attribute.valueContentRange ?? candidate.attribute.valueRange ?? mapScriptRangeToDocument(
                 context,
                 candidate.attribute,
                 attributeScriptRange(candidate.attribute)
-              ) : mapScriptRangeToDocument(context, candidate.attribute, error51.range),
+              ) : mapScriptRangeToDocument(context, candidate.attribute, error52.range),
               details: {
                 primaryLabel: `invalid script in \`${candidate.attribute.name}\``
               }
@@ -41733,6 +42486,18 @@ var suppressionRules = [
 function getAttr3(element, name) {
   return element.attributes.find((attr) => attr.name === name);
 }
+function isInsideTreeNodesModel(root, target) {
+  if (!root) return false;
+  const walk2 = (element, inTreeNodesModel) => {
+    const nextInTreeNodesModel = inTreeNodesModel || element.name === "TreeNodesModel";
+    if (element === target) return nextInTreeNodesModel;
+    for (const child of element.children) {
+      if (child.kind === "element" && walk2(child, nextInTreeNodesModel)) return true;
+    }
+    return false;
+  };
+  return walk2(root, false);
+}
 var treeRules = [
   makeRuleModule({
     name: "tree/require-id",
@@ -41809,6 +42574,7 @@ var treeRules = [
       return {
         Element(element) {
           if (element.name !== "SubTree") return;
+          if (isInsideTreeNodesModel(context.document.root, element)) return;
           const call = context.getSubTreeCallView(element);
           const idAttr = call?.node.element.attributes.find((attr) => attr.name === "ID") ?? getAttr3(element, "ID");
           if (!idAttr) return;
@@ -41829,6 +42595,7 @@ var treeRules = [
       return {
         Element(element) {
           if (element.name !== "SubTree") return;
+          if (isInsideTreeNodesModel(context.document.root, element)) return;
           const idAttr = getAttr3(element, "ID");
           if (!idAttr) return;
           const call = context.getSubTreeCallView(element);
@@ -42795,8 +43562,8 @@ async function discoverBtxmlConfig(input) {
     }
     try {
       raw = await readJson(configUri, input.host);
-    } catch (error51) {
-      const errorMessage = String(error51.message || error51);
+    } catch (error52) {
+      const errorMessage = String(error52.message || error52);
       return {
         ok: false,
         configUri,
@@ -42856,34 +43623,31 @@ async function discoverBtxmlConfig(input) {
 
 // ../project/src/models.ts
 async function discoverModelFiles(rootUri, modelsConfig, filesConfig, host) {
-  const ignore2 = [...filesConfig.ignore];
-  const gitignoreLines = filesConfig.useGitignore ? await loadGitignore(rootUri, host) : [];
-  const ig = createIgnoreInstance(gitignoreLines);
   const modelFilesPatternResult = await expandPatterns(
     modelsConfig.files,
     rootUri,
-    ignore2,
+    [],
     filesConfig.followSymlinks,
     void 0,
-    ig,
+    void 0,
     host
   );
   const definitionFilesPatternResult = await expandPatterns(
     modelsConfig.definitions,
     rootUri,
-    ignore2,
+    [],
     filesConfig.followSymlinks,
     void 0,
-    ig,
+    void 0,
     host
   );
   const augmentationFilesPatternResult = await expandPatterns(
     modelsConfig.augmentations,
     rootUri,
-    ignore2,
+    [],
     filesConfig.followSymlinks,
     void 0,
-    ig,
+    void 0,
     host
   );
   const modelFiles = modelFilesPatternResult.files.map((uri) => ({
@@ -43362,21 +44126,8 @@ function uniqueItems(items) {
 }
 
 // ../language-service/src/providers/blackboard-symbols.ts
-var BLACKBOARD_KEY_RE = /^[A-Za-z_][A-Za-z0-9_./:-]*$/;
-function validateExtractedBlackboardKey(raw) {
-  const key = raw?.trim();
-  if (!key) return void 0;
-  if (key.includes("{") || key.includes("}")) return void 0;
-  return BLACKBOARD_KEY_RE.test(key) ? key : void 0;
-}
-function normalizeBlackboardKey(raw) {
-  const value = raw?.trim();
-  if (!value) return void 0;
-  const extracted = value.startsWith("{") && value.endsWith("}") ? value.slice(1, -1).trim() : value;
-  return validateExtractedBlackboardKey(extracted);
-}
-function formatBlackboardReference(key) {
-  return `{${key}}`;
+function formatBlackboardReference2(symbol2) {
+  return formatBlackboardReference(symbol2);
 }
 function normalizeType(type) {
   return type?.trim().replace(/^const\s+/, "").replace(/[&*]\s*$/, "").replace(/\s+/g, " ").toLowerCase();
@@ -43392,31 +44143,32 @@ function collectBlackboardSymbols(context) {
       if (binding.declaredPort.status !== "resolved") continue;
       const port = binding.declaredPort.port;
       for (const ref of binding.blackboardReferences) {
-        const key = normalizeBlackboardKey(ref.key);
-        if (!key) continue;
+        if (ref.syntax === "invalid") continue;
         const next = {
-          key,
+          identity: ref.identity,
+          key: ref.key,
+          scope: ref.scope,
           type: port.type,
           direction: port.direction,
           nodeType: node.usage.nodeType || node.tagName,
           portName: port.name
         };
-        const current = grouped.get(key);
+        const current = grouped.get(ref.identity);
         if (!current) {
-          grouped.set(key, next);
+          grouped.set(ref.identity, next);
           continue;
         }
         const currentType = normalizeType(current.type);
         const nextType = normalizeType(next.type);
         if (currentType && nextType && currentType !== nextType) {
-          grouped.set(key, {
+          grouped.set(ref.identity, {
             ...current,
             conflict: true
           });
           continue;
         }
         if (!currentType && nextType) {
-          grouped.set(key, {
+          grouped.set(ref.identity, {
             ...current,
             type: next.type
           });
@@ -43441,23 +44193,45 @@ function getBlackboardReplacementRange(document, attribute, cursorOffset) {
   const endsInBraces = value.endsWith("}");
   if (startsInBraces && cursorOffset > valueStart) {
     const innerStart = valueStart + 1;
+    const innerValueStart = value[1] === "@" ? innerStart + 1 : innerStart;
     const innerEnd = endsInBraces ? valueEnd - 1 : valueEnd;
     return {
-      replacementRange: rangeFromOffsets2(document, innerStart, Math.max(innerStart, innerEnd)),
-      wrapsReference: false
+      replacementRange: rangeFromOffsets2(
+        document,
+        innerValueStart,
+        Math.max(innerValueStart, innerEnd)
+      ),
+      wrapsReference: false,
+      hasScopeMarker: value[1] === "@"
     };
   }
   return {
     insertText: attribute.value,
     replacementRange: valueContentRange,
-    wrapsReference: true
+    wrapsReference: true,
+    hasScopeMarker: false
   };
 }
 function createBlackboardCompletionItem(args) {
   const { document, attribute, cursorOffset, symbol: symbol2, detail } = args;
   const replacement = getBlackboardReplacementRange(document, attribute, cursorOffset);
-  const label = formatBlackboardReference(symbol2.key);
-  const newText = replacement?.wrapsReference ? label : symbol2.key;
+  const wrapsReference = replacement?.wrapsReference ?? false;
+  const hasScopeMarker = replacement?.hasScopeMarker ?? false;
+  if (hasScopeMarker && symbol2.scope !== "global") return void 0;
+  let label = symbol2.key;
+  if (wrapsReference) {
+    label = formatBlackboardReference2(symbol2);
+  } else if (symbol2.scope === "global") {
+    label = `@${symbol2.key}`;
+  }
+  let newText = symbol2.key;
+  if (wrapsReference) {
+    newText = formatBlackboardReference2(symbol2);
+  } else if (symbol2.scope === "global") {
+    newText = hasScopeMarker ? symbol2.key : `@${symbol2.key}`;
+  }
+  const scopeFilterText = symbol2.scope === "global" ? ` @${symbol2.key}` : "";
+  const filterText = `${symbol2.key} ${label}${scopeFilterText}`.trim();
   return completion(
     label,
     "Reference",
@@ -43467,7 +44241,7 @@ function createBlackboardCompletionItem(args) {
       newText
     } : void 0,
     {
-      filterText: `${symbol2.key} ${label}`,
+      filterText,
       insertText: newText
     }
   );
@@ -43501,13 +44275,14 @@ function getScriptIdentifierTarget(context, position) {
     (entry) => entry.access.range.start === cursor.range.start && entry.access.range.end === cursor.range.end && entry.resolution.kind !== "unknown"
   );
   if (!resolved || resolved.resolution.kind === "unknown") return void 0;
-  const reference = resolved.resolution.kind === "symbol" ? { kind: "symbol", symbol: resolved.resolution.symbol } : resolved.resolution;
+  const reference = resolved.resolution.kind === "symbol" ? { kind: "symbol", symbol: resolved.resolution.symbol } : resolved.resolution.kind === "global-blackboard" ? { ...resolved.resolution, origin: "script" } : resolved.resolution;
   return {
     attributeContext: scriptContext,
     range: toDocumentRange(context, scriptContext, cursor.range),
     reference,
     flowState,
     occurrence: {
+      uri: context.document.uri,
       attributeContext: scriptContext,
       identifier: resolved.access,
       reference,
@@ -43516,11 +44291,35 @@ function getScriptIdentifierTarget(context, position) {
   };
 }
 function getScriptReferencesForSymbol(context, target) {
-  const states = getBehaviorTreeScriptFlow2(context, target.attributeContext.behaviorTree);
-  return states.flatMap(
-    (state) => collectResolvedOccurrences(context, state).filter(
-      (occurrence) => target.reference.kind === "enum" ? occurrence.reference.kind === "enum" && occurrence.reference.name === target.reference.name : sameResolvedSymbol(target.reference.symbol, occurrence.reference)
-    )
+  const occurrences = (target.reference.kind === "global-blackboard" ? collectAllScriptOccurrences(context) : getBehaviorTreeScriptFlow2(context, target.attributeContext.behaviorTree).flatMap(
+    (state) => collectResolvedOccurrences(context, state)
+  )).filter(
+    (occurrence) => target.reference.kind === "enum" ? occurrence.reference.kind === "enum" && occurrence.reference.name === target.reference.name : target.reference.kind === "global-blackboard" ? occurrence.reference.kind === "global-blackboard" && occurrence.reference.key === target.reference.key : sameResolvedSymbol(target.reference.symbol, occurrence.reference)
+  );
+  if (target.reference.kind === "global-blackboard") {
+    return uniqueScriptOccurrences([
+      ...occurrences,
+      ...collectGlobalBlackboardRemapOccurrences(context, target.reference.key)
+    ]);
+  }
+  return occurrences;
+}
+function getGlobalBlackboardReferenceLocations(context, key) {
+  return uniqueBlackboardLocations(
+    collectGlobalBlackboardRemapOccurrences(context, key).map((occurrence) => ({
+      uri: occurrence.uri,
+      range: occurrence.documentRange
+    }))
+  );
+}
+function getGlobalBlackboardScriptLocations(context, key) {
+  return uniqueBlackboardLocations(
+    collectAllScriptOccurrences(context).filter(
+      (occurrence) => occurrence.reference.kind === "global-blackboard" && occurrence.reference.key === key
+    ).map((occurrence) => ({
+      uri: occurrence.uri,
+      range: occurrence.documentRange
+    }))
   );
 }
 function getBehaviorTreeScriptFlowStates(context, behaviorTree) {
@@ -43536,10 +44335,14 @@ function describeScriptSymbol2(symbol2) {
   switch (symbol2.source.kind) {
     case "port-remap":
       return `${typeLabel} from ${symbol2.source.nodeType ?? "node"}.${symbol2.source.portName}`;
+    case "global-blackboard-remap":
+      return `${typeLabel} from global blackboard ${symbol2.source.nodeType ?? "node"}.${symbol2.source.portName}`;
     case "subtree-port":
       return `${typeLabel} from ${symbol2.source.nodeType ?? "SubTree"}.${symbol2.source.portName}`;
     case "script-assignment":
       return `${typeLabel} from earlier ${symbol2.source.attributeName} declaration`;
+    case "global-blackboard":
+      return `${typeLabel} from global blackboard @${symbol2.source.key}`;
     case "augmentation":
       return `${typeLabel} from augmentation`;
     case "enum":
@@ -43615,6 +44418,7 @@ function getScriptAttributeContext(context, element, attribute) {
 function buildBaseScriptEnvironment2(context, nodes) {
   const registry2 = getTypeRegistry(context.semantic);
   const portSymbols = [];
+  const globalBlackboardSymbols = [];
   const behaviorTreeId = nodes[0]?.behaviorTree.id;
   if (behaviorTreeId) {
     const subtreeModel = getNodeModel(context.semantic, behaviorTreeId);
@@ -43640,17 +44444,18 @@ function buildBaseScriptEnvironment2(context, nodes) {
     }
   }
   for (const node of nodes) {
-    const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
     for (const binding of node.portBindings) {
       if (binding.declaredPort.status !== "resolved") continue;
-      const remappedKey = getRemappedKeyFromBinding(binding);
-      if (!remappedKey) continue;
+      const reference = getBlackboardReferenceFromBinding(binding);
+      if (!reference) continue;
+      if (reference.scope === "global") continue;
       const resolvedTypeName = binding.declaredPort.port.type;
       const resolvedDefinition = getTypeDefinition(context.semantic, resolvedTypeName);
       const compatibilityKey = resolvedDefinition?.canonical ?? resolvedTypeName;
       const direction = binding.declaredPort.port.direction;
+      const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
       portSymbols.push({
-        name: remappedKey,
+        name: reference.key,
         type: scriptTypeFromTypeName(registry2, resolvedTypeName),
         source: {
           kind: "port-remap",
@@ -43664,19 +44469,57 @@ function buildBaseScriptEnvironment2(context, nodes) {
       });
     }
   }
+  const workspaceNodes = getDocumentTrees(context).flatMap(
+    ({ trees }) => trees.flatMap((tree) => tree.nodes)
+  );
+  globalBlackboardSymbols.push(
+    ...collectGlobalBlackboardSeedSymbols2(context, registry2, workspaceNodes)
+  );
   return createScriptEnvironment({
     symbols: portSymbols,
+    globalBlackboardSymbols,
     augmentations: getModelAugmentations(context.semantic),
     areTypesCompatible: (left, right) => left && right ? areTypesCompatible2(context.semantic, left, right) : true
   });
 }
+function collectGlobalBlackboardSeedSymbols2(context, registry2, nodes) {
+  const symbols = [];
+  for (const node of nodes) {
+    const nodeType = node.usage.model.status === "resolved" ? node.usage.model.model.id : node.usage.nodeType;
+    for (const binding of node.portBindings) {
+      if (binding.declaredPort.status !== "resolved") continue;
+      const reference = getBlackboardReferenceFromBinding(binding);
+      if (!reference || reference.scope !== "global") continue;
+      const resolvedTypeName = binding.declaredPort.port.type;
+      const resolvedDefinition = getTypeDefinition(context.semantic, resolvedTypeName);
+      const compatibilityKey = resolvedDefinition?.canonical ?? resolvedTypeName;
+      const direction = binding.declaredPort.port.direction;
+      symbols.push({
+        name: reference.key,
+        type: scriptTypeFromTypeName(registry2, resolvedTypeName),
+        source: {
+          kind: "global-blackboard-remap",
+          nodeType,
+          portName: binding.declaredPort.port.name,
+          direction,
+          key: reference.key
+        },
+        readable: direction === "input" || direction === "output" || direction === "inout",
+        writable: direction === "output" || direction === "inout",
+        compatibilityKey
+      });
+    }
+  }
+  return symbols;
+}
 function collectResolvedOccurrences(context, state) {
   if (!state.analysis) return [];
   return state.analysis.resolvedIdentifiers.flatMap((entry) => {
     if (entry.resolution.kind === "unknown") return [];
-    const reference = entry.resolution.kind === "symbol" ? { kind: "symbol", symbol: entry.resolution.symbol } : entry.resolution;
+    const reference = entry.resolution.kind === "symbol" ? { kind: "symbol", symbol: entry.resolution.symbol } : entry.resolution.kind === "global-blackboard" ? { ...entry.resolution, origin: "script" } : entry.resolution;
     return [
       {
+        uri: context.document.uri,
         attributeContext: state.context,
         identifier: entry.access,
         reference,
@@ -43696,6 +44539,112 @@ function sameResolvedSymbol(symbol2, reference) {
   }
   return symbol2.name === candidate.name && symbol2.source.kind === candidate.source.kind;
 }
+function uniqueScriptOccurrences(occurrences) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const occurrence of occurrences) {
+    const key = `${occurrence.uri}:${occurrence.documentRange.start.offset}:${occurrence.documentRange.end.offset}:${occurrence.reference.kind}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(occurrence);
+  }
+  return result;
+}
+function collectGlobalBlackboardRemapOccurrences(context, key) {
+  return getDocumentTrees(context).flatMap(
+    ({ uri, trees }) => trees.flatMap(
+      (behaviorTree) => behaviorTree.nodes.flatMap(
+        (node) => node.portBindings.flatMap(
+          (binding) => binding.blackboardReferences.filter((reference) => reference.scope === "global" && reference.key === key).map((reference) => ({
+            uri,
+            attributeContext: {
+              id: `${node.path.join(".")}:${binding.attribute.name}:${node.element.attributes.indexOf(binding.attribute)}`,
+              node,
+              element: node.element,
+              attribute: binding.attribute,
+              source: binding.attribute.value,
+              behaviorTree: node.behaviorTree
+            },
+            identifier: {
+              name: `@${reference.key}`,
+              kind: "read",
+              range: { start: 0, end: 0 },
+              identifier: {
+                kind: "Identifier",
+                name: `@${reference.key}`,
+                range: { start: 0, end: 0 }
+              },
+              statementIndex: -1
+            },
+            reference: {
+              kind: "global-blackboard",
+              key: reference.key,
+              origin: "port-remap"
+            },
+            documentRange: reference.range
+          }))
+        )
+      )
+    )
+  );
+}
+function collectAllScriptOccurrences(context) {
+  return getDocumentTrees(context).flatMap(
+    ({ uri, trees }) => trees.flatMap((behaviorTree) => {
+      const nextContext = getContextForUri(context, uri);
+      return getBehaviorTreeScriptFlow2(nextContext, behaviorTree).flatMap(
+        (state) => collectResolvedOccurrencesByUri(nextContext, uri, state)
+      );
+    })
+  );
+}
+function collectResolvedOccurrencesByUri(context, uri, state) {
+  return collectResolvedOccurrences(context, state).map((occurrence) => ({
+    ...occurrence,
+    uri
+  }));
+}
+function getDocumentTrees(context) {
+  const current = context.documentView ? [{ uri: context.document.uri, trees: context.documentView.behaviorTrees }] : [];
+  const workspace = context.workspace?.documents ?? [];
+  const others = workspace.filter((document) => document.uri !== context.document.uri).map((document) => {
+    const view = buildBtDocumentView(document, {
+      semantic: context.semantic,
+      config: context.config,
+      policy: context.nodeUsagePolicy
+    });
+    return { uri: document.uri, trees: view.behaviorTrees };
+  }).filter((entry) => entry.trees.length > 0);
+  return [...current, ...others];
+}
+function getContextForUri(context, uri) {
+  if (uri === context.document.uri) return context;
+  const parsed = context.workspace?.documents.find((document2) => document2.uri === uri);
+  if (!parsed) return context;
+  const document = createTextDocument(uri, parsed.originalText, 0, "btcpp-xml");
+  const documentView = buildBtDocumentView(parsed, {
+    semantic: context.semantic,
+    config: context.config,
+    policy: context.nodeUsagePolicy
+  });
+  return {
+    ...context,
+    document,
+    parsed,
+    documentView
+  };
+}
+function uniqueBlackboardLocations(locations) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const location of locations) {
+    const key = `${location.uri}:${location.range.start.offset}:${location.range.end.offset}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(location);
+  }
+  return result;
+}
 function toDocumentRange(context, scriptContext, range) {
   return mapDecodedAttributeRangeToDocumentRange(
     context.parsed ?? { originalText: context.document.text },
@@ -43721,9 +44670,13 @@ function mapDecodedRangeToReplacementRange(context, attribute, range) {
   const document = context.parsed ?? { originalText: context.document.text };
   return mapDecodedAttributeRangeToDocumentRange(document, attribute, range);
 }
-function getRemappedKeyFromBinding(binding) {
+function getBlackboardReferenceFromBinding(binding) {
   if (binding.declaredPort.status !== "resolved") return void 0;
-  return getRemappedKey(binding.declaredPort.port.name, binding.value);
+  const parsed = parsePortBlackboardReference({
+    portName: binding.declaredPort.port.name,
+    rawValue: binding.value
+  });
+  return parsed.ok ? parsed.reference : void 0;
 }
 
 // ../language-service/src/providers/script-completions.ts
@@ -44006,28 +44959,37 @@ function attributeValueItems(input, inspect, context) {
   const unknownTypeSymbols = symbols.filter(
     (symbol2) => !symbol2.conflict && !normalizeType(symbol2.type) && normalizedCurrentType
   );
-  const matchingKeyItems = matchingSymbols.map((symbol2) => ({
-    ...createBlackboardCompletionItem({
+  const matchingKeyItems = matchingSymbols.flatMap((symbol2) => {
+    const item = createBlackboardCompletionItem({
       document: input.document,
       attribute,
       cursorOffset: input.position.offset,
       symbol: symbol2,
-      detail: `${symbol2.type || "unknown"} blackboard key from ${symbol2.nodeType}.${symbol2.portName}`
-    }),
-    sortText: `${BLACKBOARD_SORT_TEXT.matchingKey}-${symbol2.key}`
-  }));
-  const unknownKeyItems = unknownTypeSymbols.map((symbol2) => ({
-    ...createBlackboardCompletionItem({
+      detail: symbol2.scope === "global" ? `${symbol2.type || "unknown"} global blackboard key from ${symbol2.nodeType}.${symbol2.portName}` : `${symbol2.type || "unknown"} blackboard key from ${symbol2.nodeType}.${symbol2.portName}`
+    });
+    return item ? [
+      {
+        ...item,
+        sortText: `${BLACKBOARD_SORT_TEXT.matchingKey}-${symbol2.scope === "global" ? symbol2.identity : symbol2.key}`
+      }
+    ] : [];
+  });
+  const unknownKeyItems = unknownTypeSymbols.flatMap((symbol2) => {
+    const item = createBlackboardCompletionItem({
       document: input.document,
       attribute,
       cursorOffset: input.position.offset,
       symbol: symbol2,
-      detail: `unknown-type blackboard key from ${symbol2.nodeType}.${symbol2.portName}`
-    }),
-    sortText: `${BLACKBOARD_SORT_TEXT.unknownKey}-${symbol2.key}`
-  }));
-  items.push(...matchingKeyItems);
-  items.push(...unknownKeyItems);
+      detail: symbol2.scope === "global" ? `unknown-type global blackboard key from ${symbol2.nodeType}.${symbol2.portName}` : `unknown-type blackboard key from ${symbol2.nodeType}.${symbol2.portName}`
+    });
+    return item ? [
+      {
+        ...item,
+        sortText: `${BLACKBOARD_SORT_TEXT.unknownKey}-${symbol2.scope === "global" ? symbol2.identity : symbol2.key}`
+      }
+    ] : [];
+  });
+  items.push(...matchingKeyItems, ...unknownKeyItems);
   if (items.length > 0) {
     return uniqueItems(items);
   }
@@ -44060,7 +45022,9 @@ function getCompletions(context, input) {
     };
   }
   if (inspect.kind === "tag-name") {
-    return { items: uniqueItems(elementNameItems(context.semantic, inspect.element?.nameRange)) };
+    return {
+      items: uniqueItems(elementNameItems(context.semantic, inspect.element?.nameRange))
+    };
   }
   if (inspect.kind === "closing-tag-name") {
     return { items: uniqueItems(closingTagItems(inspect)) };
@@ -44069,6 +45033,63 @@ function getCompletions(context, input) {
 }
 
 // ../language-service/src/providers/definition.ts
+function uniqueLocations(locations) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const location of locations) {
+    const key = `${location.uri}:${location.range.start.offset}:${location.range.end.offset}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(location);
+  }
+  return result;
+}
+function getSubTreeModelDefinitionLocations(semantic, id, fallbackUri) {
+  return getNodeModelDefinitions(semantic, id).filter((definition) => definition.kind === "SubTree").map((definition) => {
+    if (definition.idRange) {
+      return {
+        uri: definition.uri || fallbackUri,
+        range: definition.idRange
+      };
+    }
+    if (definition.range) {
+      return {
+        uri: definition.uri || fallbackUri,
+        range: definition.range
+      };
+    }
+    return void 0;
+  }).filter((location) => Boolean(location));
+}
+function getBlackboardDefinitionLocations(documentView, identity, fallbackUri) {
+  if (!documentView) return [];
+  return uniqueLocations(
+    documentView.nodes.flatMap(
+      (node) => node.portBindings.flatMap(
+        (binding) => binding.blackboardReferences.filter((reference) => reference.identity === identity).map((reference) => ({
+          uri: fallbackUri,
+          range: reference.range
+        }))
+      )
+    )
+  );
+}
+function getWorkspaceBlackboardLocations(documentView, workspaceDocuments, semantic, config2, policy, identity, fallbackUri) {
+  const current = getBlackboardDefinitionLocations(documentView, identity, fallbackUri);
+  const workspace = (workspaceDocuments ?? []).flatMap((document) => {
+    if (document.uri === fallbackUri) return [];
+    const view = buildBtDocumentView(document, {
+      semantic,
+      config: config2,
+      policy
+    });
+    return getBlackboardDefinitionLocations(view, identity, document.uri);
+  });
+  return uniqueLocations([...current, ...workspace]);
+}
+function getDocumentBlackboardLocations(documentView, identity, fallbackUri) {
+  return getBlackboardDefinitionLocations(documentView, identity, fallbackUri);
+}
 function getDefinitionLocations(parsed, documentView, position, semantic, config2, policy, workspaceDocuments) {
   if (!parsed) return [];
   const inspect = inspectXmlCursor({
@@ -44094,27 +45115,45 @@ function getDefinitionLocations(parsed, documentView, position, semantic, config
     policy
   }) : void 0;
   if (element?.name === "SubTree" && attribute?.name === "ID") {
+    if (usage?.tagForm === "model-definition") {
+      return getBehaviorTrees(semantic, attribute.value).map((def) => def.idRange ? { uri: def.uri, range: def.idRange } : void 0).filter((location) => Boolean(location));
+    }
+    const subtreeModelDefinitions = getSubTreeModelDefinitionLocations(
+      semantic,
+      attribute.value,
+      parsed.uri
+    );
     const target = usage?.subtree?.target;
     if (target?.status === "resolved" && target.kind === "behavior-tree") {
       const behaviorTree = target.behaviorTree;
       if (behaviorTree.idRange) {
-        return [
+        return uniqueLocations([
           {
             uri: behaviorTree.uri,
             range: behaviorTree.idRange
-          }
-        ];
+          },
+          ...subtreeModelDefinitions
+        ]);
       }
+      return subtreeModelDefinitions;
     }
     if (target?.status === "ambiguous") {
-      return [...target.behaviorTrees, ...target.definitions].map(
-        (def) => def.idRange ? { uri: def.uri || parsed.uri, range: def.idRange } : def.range ? { uri: def.uri || parsed.uri, range: def.range } : void 0
-      ).filter((location) => Boolean(location));
+      return uniqueLocations(
+        [
+          ...target.behaviorTrees.map(
+            (def) => def.idRange ? { uri: def.uri || parsed.uri, range: def.idRange } : void 0
+          ),
+          ...subtreeModelDefinitions
+        ].filter((location) => Boolean(location))
+      );
     }
-    if (target?.status === "resolved" && target.kind === "node-model" && target.model.idRange) {
-      return [{ uri: target.model.uri || parsed.uri, range: target.model.idRange }];
+    if (target?.status === "resolved" && target.kind === "node-model") {
+      if (subtreeModelDefinitions.length > 0) return subtreeModelDefinitions;
+      if (target.model.idRange) {
+        return [{ uri: target.model.uri || parsed.uri, range: target.model.idRange }];
+      }
     }
-    return [];
+    return subtreeModelDefinitions;
   }
   if (element?.name === "root" && attribute?.name === "main_tree_to_execute") {
     return getBehaviorTrees(semantic, attribute.value).map((def) => def.idRange ? { uri: def.uri, range: def.idRange } : void 0).filter((location) => Boolean(location));
@@ -44127,6 +45166,20 @@ function getDefinitionLocations(parsed, documentView, position, semantic, config
   }
   if (attribute && element) {
     const binding = documentView ? findPortBindingAtPosition(documentView, position) : void 0;
+    const blackboardReference = binding?.blackboardReferences.find(
+      (reference) => position.offset >= reference.range.start.offset && position.offset <= reference.range.end.offset
+    );
+    if (blackboardReference) {
+      return blackboardReference.scope === "global" ? getWorkspaceBlackboardLocations(
+        documentView,
+        workspaceDocuments,
+        semantic,
+        config2,
+        policy,
+        blackboardReference.identity,
+        parsed.uri
+      ) : getDocumentBlackboardLocations(documentView, blackboardReference.identity, parsed.uri);
+    }
     if (binding?.declaredPort.status === "resolved") {
       const port = binding.declaredPort.port;
       if (port.nameRange) return [{ uri: port.uri || parsed.uri, range: port.nameRange }];
@@ -44170,12 +45223,16 @@ function getDefinition(context, input) {
         ]
       };
     }
-    if (symbol2.source.kind === "port-remap") {
+    if (symbol2.source.kind === "port-remap" || symbol2.source.kind === "global-blackboard-remap") {
       const source = symbol2.source;
+      const targetIdentity = makeBlackboardIdentity({
+        scope: source.kind === "global-blackboard-remap" ? "global" : "local",
+        key: symbol2.name
+      });
       const binding = context.documentView?.nodes.filter((node) => node.behaviorTree === scriptTarget.attributeContext.behaviorTree).flatMap((node) => node.portBindings).filter(
         (binding2) => binding2.declaredPort.status === "resolved"
       ).find(
-        (binding2) => binding2.declaredPort.port.name === source.portName && binding2.declaredPort.port.direction === source.direction && getRemappedKey(binding2.declaredPort.port.name, binding2.value) === symbol2.name
+        (binding2) => binding2.declaredPort.port.name === source.portName && binding2.declaredPort.port.direction === source.direction && binding2.blackboardReferences.some((reference) => reference.identity === targetIdentity)
       );
       const location = binding?.declaredPort.port.nameRange;
       if (location) {
@@ -44207,6 +45264,39 @@ function getDefinition(context, input) {
       }
     }
   }
+  if (scriptTarget?.reference.kind === "global-blackboard") {
+    const targetIdentity = makeBlackboardIdentity({
+      scope: "global",
+      key: scriptTarget.reference.key
+    });
+    const locations = getGlobalBlackboardReferenceLocations(context, scriptTarget.reference.key);
+    if (locations.length > 0) {
+      return {
+        locations
+      };
+    }
+    const symbol2 = scriptTarget.reference.symbol;
+    if (symbol2?.source.kind === "global-blackboard") {
+      const source = symbol2.source;
+      const declarationState = getBehaviorTreeScriptFlowStates(
+        context,
+        scriptTarget.attributeContext.behaviorTree
+      ).find((state) => state.id === source.originId);
+      const declarationContext = declarationState?.context ?? scriptTarget.attributeContext;
+      return {
+        locations: [
+          {
+            uri: context.document.uri,
+            range: mapDecodedAttributeRangeToDocumentRange(
+              context.parsed ?? { originalText: context.document.text },
+              declarationContext.attribute,
+              source.range
+            )
+          }
+        ]
+      };
+    }
+  }
   return {
     locations: getDefinitionLocations(
       context.parsed,
@@ -44293,6 +45383,18 @@ function getHover(context, input) {
 Value: \`${scriptTarget.reference.value}\``
       };
     }
+    if (scriptTarget.reference.kind === "global-blackboard") {
+      const symbol3 = scriptTarget.reference.symbol;
+      return {
+        range: scriptTarget.range,
+        contents: symbol3 ? [
+          `**Global Blackboard** \`@${scriptTarget.reference.key}\``,
+          "",
+          `Type: \`${formatScriptType3(symbol3.type)}\``,
+          `Source: ${describeScriptSymbol2(symbol3)}`
+        ].join("\n") : `**Global Blackboard** \`@${scriptTarget.reference.key}\``
+      };
+    }
     const symbol2 = scriptTarget.reference.symbol;
     return {
       range: scriptTarget.range,
@@ -44389,7 +45491,7 @@ Resolves to SubTree model in \`${target.model.uri || context.parsed?.uri || "wor
 function toReferenceLocations(context, id) {
   return getSubTreeReferences(context.semantic, id).filter((ref) => ref.parentBehaviorTreeId && ref.idRange).map((ref) => ({ uri: ref.uri, range: ref.idRange })).filter((location) => Boolean(location.range));
 }
-function uniqueLocations(locations) {
+function uniqueLocations2(locations) {
   const seen = /* @__PURE__ */ new Set();
   const result = [];
   for (const location of locations) {
@@ -44425,9 +45527,9 @@ function getReferences(context, input) {
   const scriptTarget = getScriptIdentifierTarget(context, input.position);
   if (scriptTarget) {
     return {
-      locations: uniqueLocations(
+      locations: uniqueLocations2(
         getScriptReferencesForSymbol(context, scriptTarget).map((occurrence) => ({
-          uri: context.document.uri,
+          uri: occurrence.uri,
           range: occurrence.documentRange
         }))
       )
@@ -44440,6 +45542,32 @@ function getReferences(context, input) {
   }) : void 0;
   const element = inspect && "element" in inspect ? inspect.element : void 0;
   const attribute = inspect && "attribute" in inspect ? inspect.attribute : void 0;
+  const binding = context.documentView && context.parsed ? context.documentView.nodes.flatMap((node) => node.portBindings).find(
+    (candidate) => candidate.attribute === attribute && input.position.offset >= (candidate.attribute.valueContentRange ?? candidate.attribute.valueRange).start.offset && input.position.offset <= (candidate.attribute.valueContentRange ?? candidate.attribute.valueRange).end.offset
+  ) : void 0;
+  const blackboardReference = binding?.blackboardReferences.find(
+    (reference) => input.position.offset >= reference.range.start.offset && input.position.offset <= reference.range.end.offset
+  );
+  if (blackboardReference) {
+    const identity = makeBlackboardIdentity({
+      scope: blackboardReference.scope,
+      key: blackboardReference.key
+    });
+    return {
+      locations: uniqueLocations2([
+        ...blackboardReference.scope === "global" ? getWorkspaceBlackboardLocations(
+          context.documentView,
+          context.workspace?.documents,
+          context.semantic,
+          context.config,
+          context.nodeUsagePolicy,
+          identity,
+          context.document.uri
+        ) : getDocumentBlackboardLocations(context.documentView, identity, context.document.uri),
+        ...blackboardReference.scope === "global" ? getGlobalBlackboardScriptLocations(context, blackboardReference.key) : []
+      ])
+    };
+  }
   if (element?.name === "BehaviorTree" && attribute?.name === "ID") {
     return {
       locations: toReferenceLocations(context, attribute.value)
@@ -44472,7 +45600,7 @@ function getReferences(context, input) {
   const ids = getReferencedSubTreeIds(context, defs);
   if (ids.length > 0) {
     return {
-      locations: uniqueLocations(ids.flatMap((id) => toReferenceLocations(context, id)))
+      locations: uniqueLocations2(ids.flatMap((id) => toReferenceLocations(context, id)))
     };
   }
   return { locations: [] };
@@ -45081,8 +46209,8 @@ function createNodeWorkspaceHost(cwd = process.cwd()) {
       try {
         await import_promises.default.access(fileUriToPath3(uri), import_node_fs.constants.F_OK);
         return true;
-      } catch (error51) {
-        if (error51.code !== "ENOENT") throw error51;
+      } catch (error52) {
+        if (error52.code !== "ENOENT") throw error52;
         return false;
       }
     },
@@ -45213,8 +46341,8 @@ function createNodeWorkspaceService(options = {}) {
         resolve(result) {
           resolveReload?.(result);
         },
-        reject(error51) {
-          rejectReload?.(error51);
+        reject(error52) {
+          rejectReload?.(error52);
         }
       };
     }
@@ -45223,8 +46351,8 @@ function createNodeWorkspaceService(options = {}) {
       const scheduled = pendingReload;
       void load(lastLoadOptions).then((result) => {
         scheduled?.resolve(result);
-      }).catch((error51) => {
-        scheduled?.reject(error51);
+      }).catch((error52) => {
+        scheduled?.reject(error52);
       }).finally(() => {
         if (pendingReload === scheduled) pendingReload = void 0;
       });
@@ -45724,6 +46852,7 @@ function handleGetChildCapability(workspace, params) {
 }
 
 // src/server.ts
+var SERVER_VERSION = true ? "0.1.3" : "unknown";
 var connection = (0, import_node4.createConnection)(import_node4.ProposedFeatures.all);
 var documents = new import_node4.TextDocuments(TextDocument);
 var openUris = /* @__PURE__ */ new Set();
@@ -46091,7 +47220,7 @@ connection.onInitialize((params) => {
   return {
     serverInfo: {
       name: "btxml",
-      version: "0.1.0"
+      version: SERVER_VERSION
     },
     capabilities: {
       textDocumentSync: import_node4.TextDocumentSyncKind.Incremental,
@@ -46250,8 +47379,8 @@ async function startLanguageServer() {
 }
 
 // src/main.ts
-startLanguageServer().catch((error51) => {
-  process.stderr.write(`${String(error51)}
+startLanguageServer().catch((error52) => {
+  process.stderr.write(`${String(error52)}
 `);
   process.exitCode = 1;
 });