npm - holosphere - Versions diffs - 1.3.0-alpha4 → 1.3.0-alpha7 - Mend

holosphere 1.3.0-alpha4 → 1.3.0-alpha7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/content.js +219 -46
package/federation.js +47 -13
package/global.js +49 -4
package/hologram.js +21 -4
package/holosphere-bundle.esm.js +532 -283
package/holosphere-bundle.js +532 -283
package/holosphere-bundle.min.js +8 -8
package/holosphere.d.ts +96 -9
package/holosphere.js +53 -8
package/package.json +1 -1
package/utils.js +29 -7

package/holosphere-bundle.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * HoloSphere Bundle v1.3.0-alpha4
+ * HoloSphere Bundle v1.3.0-alpha7
  * Holonic Geospatial Communication Infrastructure
  *
  * Includes:
@@ -9,7 +9,7 @@
  * - Ajv (JSON schema validation)
  *
  * Usage:
- * <script src="https://unpkg.com/holosphere@1.3.0-alpha4/holosphere-bundle.js"></script>
+ * <script src="https://unpkg.com/holosphere@1.3.0-alpha7/holosphere-bundle.js"></script>
  * <script>
  *   const hs = new HoloSphere('myapp');
  * </script>
@@ -55,9 +55,9 @@ var HoloSphere = (() => {
   ));
   var __toCommonJS = (mod2) => __copyProps(__defProp({}, "__esModule", { value: true }), mod2);
-  // node_modules/gun/gun.js
+  // node_modules/.pnpm/gun@0.2020.1241/node_modules/gun/gun.js
   var require_gun = __commonJS({
-    "node_modules/gun/gun.js"(exports, module) {
+    "node_modules/.pnpm/gun@0.2020.1241/node_modules/gun/gun.js"(exports, module) {
       (function() {
         function USE(arg, req) {
           return req ? __require(arg) : arg.slice ? USE[R(arg)] : function(mod2, path) {
@@ -3145,16 +3145,16 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/gun/browser.js
+  // node_modules/.pnpm/gun@0.2020.1241/node_modules/gun/browser.js
   var require_browser = __commonJS({
-    "node_modules/gun/browser.js"(exports, module) {
+    "node_modules/.pnpm/gun@0.2020.1241/node_modules/gun/browser.js"(exports, module) {
       module.exports = require_gun();
     }
   });
-  // node_modules/ajv/dist/compile/codegen/code.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/code.js
   var require_code = __commonJS({
-    "node_modules/ajv/dist/compile/codegen/code.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/code.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.regexpCode = exports.getEsmExportName = exports.getProperty = exports.safeStringify = exports.stringify = exports.strConcat = exports.addCodeArg = exports.str = exports._ = exports.nil = exports._Code = exports.Name = exports.IDENTIFIER = exports._CodeOrName = void 0;
@@ -3306,9 +3306,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/codegen/scope.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/scope.js
   var require_scope = __commonJS({
-    "node_modules/ajv/dist/compile/codegen/scope.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/scope.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.ValueScope = exports.ValueScopeName = exports.Scope = exports.varKinds = exports.UsedValueState = void 0;
@@ -3451,9 +3451,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/codegen/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/index.js
   var require_codegen = __commonJS({
-    "node_modules/ajv/dist/compile/codegen/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.or = exports.and = exports.not = exports.CodeGen = exports.operators = exports.varKinds = exports.ValueScopeName = exports.ValueScope = exports.Scope = exports.Name = exports.regexpCode = exports.stringify = exports.getProperty = exports.nil = exports.strConcat = exports.str = exports._ = void 0;
@@ -4171,9 +4171,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/util.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/util.js
   var require_util = __commonJS({
-    "node_modules/ajv/dist/compile/util.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/util.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.checkStrictMode = exports.getErrorPath = exports.Type = exports.useFunc = exports.setEvaluated = exports.evaluatedPropsToName = exports.mergeEvaluated = exports.eachItem = exports.unescapeJsonPointer = exports.escapeJsonPointer = exports.escapeFragment = exports.unescapeFragment = exports.schemaRefOrVal = exports.schemaHasRulesButRef = exports.schemaHasRules = exports.checkUnknownRules = exports.alwaysValidSchema = exports.toHash = void 0;
@@ -4338,9 +4338,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/names.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/names.js
   var require_names = __commonJS({
-    "node_modules/ajv/dist/compile/names.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/names.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -4377,9 +4377,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/errors.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/errors.js
   var require_errors = __commonJS({
-    "node_modules/ajv/dist/compile/errors.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/errors.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.extendErrors = exports.resetErrorsCount = exports.reportExtraError = exports.reportError = exports.keyword$DataError = exports.keywordError = void 0;
@@ -4499,9 +4499,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/boolSchema.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/boolSchema.js
   var require_boolSchema = __commonJS({
-    "node_modules/ajv/dist/compile/validate/boolSchema.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/boolSchema.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.boolOrEmptySchema = exports.topBoolOrEmptySchema = void 0;
@@ -4550,9 +4550,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/rules.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/rules.js
   var require_rules = __commonJS({
-    "node_modules/ajv/dist/compile/rules.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/rules.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.getRules = exports.isJSONType = void 0;
@@ -4581,9 +4581,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/applicability.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/applicability.js
   var require_applicability = __commonJS({
-    "node_modules/ajv/dist/compile/validate/applicability.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/applicability.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.shouldUseRule = exports.shouldUseGroup = exports.schemaHasRulesForType = void 0;
@@ -4604,9 +4604,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/dataType.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/dataType.js
   var require_dataType = __commonJS({
-    "node_modules/ajv/dist/compile/validate/dataType.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/dataType.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.reportTypeError = exports.checkDataTypes = exports.checkDataType = exports.coerceAndCheckDataType = exports.getJSONTypes = exports.getSchemaTypes = exports.DataType = void 0;
@@ -4788,9 +4788,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/defaults.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/defaults.js
   var require_defaults = __commonJS({
-    "node_modules/ajv/dist/compile/validate/defaults.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/defaults.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.assignDefaults = void 0;
@@ -4825,9 +4825,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/code.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/code.js
   var require_code2 = __commonJS({
-    "node_modules/ajv/dist/vocabularies/code.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/code.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.validateUnion = exports.validateArray = exports.usePattern = exports.callValidateCode = exports.schemaProperties = exports.allSchemaProperties = exports.noPropertyInData = exports.propertyInData = exports.isOwnProperty = exports.hasPropFunc = exports.reportMissingProp = exports.checkMissingProp = exports.checkReportMissingProp = void 0;
@@ -4958,9 +4958,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/keyword.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/keyword.js
   var require_keyword = __commonJS({
-    "node_modules/ajv/dist/compile/validate/keyword.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/keyword.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.validateKeywordUsage = exports.validSchemaType = exports.funcKeywordCode = exports.macroKeywordCode = void 0;
@@ -5076,9 +5076,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/subschema.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/subschema.js
   var require_subschema = __commonJS({
-    "node_modules/ajv/dist/compile/validate/subschema.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/subschema.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.extendSubschemaMode = exports.extendSubschemaData = exports.getSubschema = void 0;
@@ -5159,9 +5159,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/fast-deep-equal/index.js
+  // node_modules/.pnpm/fast-deep-equal@3.1.3/node_modules/fast-deep-equal/index.js
   var require_fast_deep_equal = __commonJS({
-    "node_modules/fast-deep-equal/index.js"(exports, module) {
+    "node_modules/.pnpm/fast-deep-equal@3.1.3/node_modules/fast-deep-equal/index.js"(exports, module) {
       "use strict";
       module.exports = function equal(a, b) {
         if (a === b) return true;
@@ -5194,9 +5194,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/json-schema-traverse/index.js
+  // node_modules/.pnpm/json-schema-traverse@1.0.0/node_modules/json-schema-traverse/index.js
   var require_json_schema_traverse = __commonJS({
-    "node_modules/json-schema-traverse/index.js"(exports, module) {
+    "node_modules/.pnpm/json-schema-traverse@1.0.0/node_modules/json-schema-traverse/index.js"(exports, module) {
       "use strict";
       var traverse = module.exports = function(schema, opts, cb) {
         if (typeof opts == "function") {
@@ -5282,9 +5282,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/resolve.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/resolve.js
   var require_resolve = __commonJS({
-    "node_modules/ajv/dist/compile/resolve.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/resolve.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.getSchemaRefs = exports.resolveUrl = exports.normalizeId = exports._getFullPath = exports.getFullPath = exports.inlineRef = void 0;
@@ -5438,9 +5438,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/validate/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/index.js
   var require_validate = __commonJS({
-    "node_modules/ajv/dist/compile/validate/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/validate/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.getData = exports.KeywordCxt = exports.validateFunctionCode = void 0;
@@ -5946,9 +5946,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/runtime/validation_error.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/validation_error.js
   var require_validation_error = __commonJS({
-    "node_modules/ajv/dist/runtime/validation_error.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/validation_error.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var ValidationError = class extends Error {
@@ -5962,9 +5962,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/ref_error.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/ref_error.js
   var require_ref_error = __commonJS({
-    "node_modules/ajv/dist/compile/ref_error.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/ref_error.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var resolve_1 = require_resolve();
@@ -5979,9 +5979,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/compile/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/index.js
   var require_compile = __commonJS({
-    "node_modules/ajv/dist/compile/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.resolveSchema = exports.getCompilingSchema = exports.resolveRef = exports.compileSchema = exports.SchemaEnv = void 0;
@@ -6203,9 +6203,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/data.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/data.json
   var require_data = __commonJS({
-    "node_modules/ajv/dist/refs/data.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/data.json"(exports, module) {
       module.exports = {
         $id: "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#",
         description: "Meta-schema for $data reference (JSON AnySchema extension proposal)",
@@ -6222,12 +6222,15 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/fast-uri/lib/utils.js
+  // node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js
   var require_utils = __commonJS({
-    "node_modules/fast-uri/lib/utils.js"(exports, module) {
+    "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js"(exports, module) {
       "use strict";
       var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
       var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
+      var isHexPair = RegExp.prototype.test.bind(/^[\da-f]{2}$/iu);
+      var isUnreserved = RegExp.prototype.test.bind(/^[\da-z\-._~]$/iu);
+      var isPathCharacter = RegExp.prototype.test.bind(/^[\da-z\-._~!$&'()*+,;=:@/]$/iu);
       function stringArrayToHexStripped(input) {
         let acc = "";
         let code = 0;
@@ -6420,27 +6423,77 @@ var HoloSphere = (() => {
         }
         return output.join("");
       }
-      function normalizeComponentEncoding(component, esc) {
-        const func = esc !== true ? escape : unescape;
-        if (component.scheme !== void 0) {
-          component.scheme = func(component.scheme);
-        }
-        if (component.userinfo !== void 0) {
-          component.userinfo = func(component.userinfo);
-        }
-        if (component.host !== void 0) {
-          component.host = func(component.host);
+      var HOST_DELIMS = { "@": "%40", "/": "%2F", "?": "%3F", "#": "%23", ":": "%3A" };
+      var HOST_DELIM_RE = /[@/?#:]/g;
+      var HOST_DELIM_NO_COLON_RE = /[@/?#]/g;
+      function reescapeHostDelimiters(host, isIP) {
+        const re = isIP ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
+        re.lastIndex = 0;
+        return host.replace(re, (ch) => HOST_DELIMS[ch]);
+      }
+      function normalizePercentEncoding(input, decodeUnreserved = false) {
+        if (input.indexOf("%") === -1) {
+          return input;
         }
-        if (component.path !== void 0) {
-          component.path = func(component.path);
+        let output = "";
+        for (let i = 0; i < input.length; i++) {
+          if (input[i] === "%" && i + 2 < input.length) {
+            const hex = input.slice(i + 1, i + 3);
+            if (isHexPair(hex)) {
+              const normalizedHex = hex.toUpperCase();
+              const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+              if (decodeUnreserved && isUnreserved(decoded)) {
+                output += decoded;
+              } else {
+                output += "%" + normalizedHex;
+              }
+              i += 2;
+              continue;
+            }
+          }
+          output += input[i];
         }
-        if (component.query !== void 0) {
-          component.query = func(component.query);
+        return output;
+      }
+      function normalizePathEncoding(input) {
+        let output = "";
+        for (let i = 0; i < input.length; i++) {
+          if (input[i] === "%" && i + 2 < input.length) {
+            const hex = input.slice(i + 1, i + 3);
+            if (isHexPair(hex)) {
+              const normalizedHex = hex.toUpperCase();
+              const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+              if (decoded !== "." && isUnreserved(decoded)) {
+                output += decoded;
+              } else {
+                output += "%" + normalizedHex;
+              }
+              i += 2;
+              continue;
+            }
+          }
+          if (isPathCharacter(input[i])) {
+            output += input[i];
+          } else {
+            output += escape(input[i]);
+          }
         }
-        if (component.fragment !== void 0) {
-          component.fragment = func(component.fragment);
+        return output;
+      }
+      function escapePreservingEscapes(input) {
+        let output = "";
+        for (let i = 0; i < input.length; i++) {
+          if (input[i] === "%" && i + 2 < input.length) {
+            const hex = input.slice(i + 1, i + 3);
+            if (isHexPair(hex)) {
+              output += "%" + hex.toUpperCase();
+              i += 2;
+              continue;
+            }
+          }
+          output += escape(input[i]);
         }
-        return component;
+        return output;
       }
       function recomposeAuthority(component) {
         const uriTokens = [];
@@ -6455,7 +6508,7 @@ var HoloSphere = (() => {
             if (ipV6res.isIPV6 === true) {
               host = `[${ipV6res.escapedHost}]`;
             } else {
-              host = component.host;
+              host = reescapeHostDelimiters(host, false);
             }
           }
           uriTokens.push(host);
@@ -6469,7 +6522,10 @@ var HoloSphere = (() => {
       module.exports = {
         nonSimpleDomain,
         recomposeAuthority,
-        normalizeComponentEncoding,
+        reescapeHostDelimiters,
+        normalizePercentEncoding,
+        normalizePathEncoding,
+        escapePreservingEscapes,
         removeDotSegments,
         isIPv4,
         isUUID,
@@ -6479,9 +6535,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/fast-uri/lib/schemes.js
+  // node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js
   var require_schemes = __commonJS({
-    "node_modules/fast-uri/lib/schemes.js"(exports, module) {
+    "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js"(exports, module) {
       "use strict";
       var { isUUID } = require_utils();
       var URN_REG = /([\da-z][\d\-a-z]{0,31}):((?:[\w!$'()*+,\-.:;=@]|%[\da-f]{2})+)/iu;
@@ -6689,16 +6745,16 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/fast-uri/index.js
+  // node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js
   var require_fast_uri = __commonJS({
-    "node_modules/fast-uri/index.js"(exports, module) {
+    "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js"(exports, module) {
       "use strict";
-      var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = require_utils();
+      var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils();
       var { SCHEMES, getSchemeHandler } = require_schemes();
       function normalize(uri, options) {
         if (typeof uri === "string") {
           uri = /** @type {T} */
-          serialize(parse2(uri, options), options);
+          normalizeString(uri, options);
         } else if (typeof uri === "object") {
           uri = /** @type {T} */
           parse2(serialize(uri, options), options);
@@ -6765,19 +6821,9 @@ var HoloSphere = (() => {
         return target;
       }
       function equal(uriA, uriB, options) {
-        if (typeof uriA === "string") {
-          uriA = unescape(uriA);
-          uriA = serialize(normalizeComponentEncoding(parse2(uriA, options), true), { ...options, skipEscape: true });
-        } else if (typeof uriA === "object") {
-          uriA = serialize(normalizeComponentEncoding(uriA, true), { ...options, skipEscape: true });
-        }
-        if (typeof uriB === "string") {
-          uriB = unescape(uriB);
-          uriB = serialize(normalizeComponentEncoding(parse2(uriB, options), true), { ...options, skipEscape: true });
-        } else if (typeof uriB === "object") {
-          uriB = serialize(normalizeComponentEncoding(uriB, true), { ...options, skipEscape: true });
-        }
-        return uriA.toLowerCase() === uriB.toLowerCase();
+        const normalizedA = normalizeComparableURI(uriA, options);
+        const normalizedB = normalizeComparableURI(uriB, options);
+        return normalizedA !== void 0 && normalizedB !== void 0 && normalizedA.toLowerCase() === normalizedB.toLowerCase();
       }
       function serialize(cmpts, opts) {
         const component = {
@@ -6802,12 +6848,12 @@ var HoloSphere = (() => {
         if (schemeHandler && schemeHandler.serialize) schemeHandler.serialize(component, options);
         if (component.path !== void 0) {
           if (!options.skipEscape) {
-            component.path = escape(component.path);
+            component.path = escapePreservingEscapes(component.path);
             if (component.scheme !== void 0) {
               component.path = component.path.split("%3A").join(":");
             }
           } else {
-            component.path = unescape(component.path);
+            component.path = normalizePercentEncoding(component.path);
           }
         }
         if (options.reference !== "suffix" && component.scheme) {
@@ -6842,7 +6888,16 @@ var HoloSphere = (() => {
         return uriTokens.join("");
       }
       var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
-      function parse2(uri, opts) {
+      function getParseError(parsed, matches) {
+        if (matches[2] !== void 0 && parsed.path && parsed.path[0] !== "/") {
+          return 'URI path must start with "/" when authority is present.';
+        }
+        if (typeof parsed.port === "number" && (parsed.port < 0 || parsed.port > 65535)) {
+          return "URI port is malformed.";
+        }
+        return void 0;
+      }
+      function parseWithStatus(uri, opts) {
         const options = Object.assign({}, opts);
         const parsed = {
           scheme: void 0,
@@ -6853,6 +6908,7 @@ var HoloSphere = (() => {
           query: void 0,
           fragment: void 0
         };
+        let malformedAuthorityOrPort = false;
         let isIP = false;
         if (options.reference === "suffix") {
           if (options.scheme) {
@@ -6873,6 +6929,11 @@ var HoloSphere = (() => {
           if (isNaN(parsed.port)) {
             parsed.port = matches[5];
           }
+          const parseError = getParseError(parsed, matches);
+          if (parseError !== void 0) {
+            parsed.error = parsed.error || parseError;
+            malformedAuthorityOrPort = true;
+          }
           if (parsed.host) {
             const ipv4result = isIPv4(parsed.host);
             if (ipv4result === false) {
@@ -6911,14 +6972,18 @@ var HoloSphere = (() => {
                 parsed.scheme = unescape(parsed.scheme);
               }
               if (parsed.host !== void 0) {
-                parsed.host = unescape(parsed.host);
+                parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP);
               }
             }
             if (parsed.path) {
-              parsed.path = escape(unescape(parsed.path));
+              parsed.path = normalizePathEncoding(parsed.path);
             }
             if (parsed.fragment) {
-              parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+              try {
+                parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+              } catch {
+                parsed.error = parsed.error || "URI malformed";
+              }
             }
           }
           if (schemeHandler && schemeHandler.parse) {
@@ -6927,7 +6992,29 @@ var HoloSphere = (() => {
         } else {
           parsed.error = parsed.error || "URI can not be parsed.";
         }
-        return parsed;
+        return { parsed, malformedAuthorityOrPort };
+      }
+      function parse2(uri, opts) {
+        return parseWithStatus(uri, opts).parsed;
+      }
+      function normalizeString(uri, opts) {
+        return normalizeStringWithStatus(uri, opts).normalized;
+      }
+      function normalizeStringWithStatus(uri, opts) {
+        const { parsed, malformedAuthorityOrPort } = parseWithStatus(uri, opts);
+        return {
+          normalized: malformedAuthorityOrPort ? uri : serialize(parsed, opts),
+          malformedAuthorityOrPort
+        };
+      }
+      function normalizeComparableURI(uri, opts) {
+        if (typeof uri === "string") {
+          const { normalized, malformedAuthorityOrPort } = normalizeStringWithStatus(uri, opts);
+          return malformedAuthorityOrPort ? void 0 : normalized;
+        }
+        if (typeof uri === "object") {
+          return serialize(uri, opts);
+        }
       }
       var fastUri = {
         SCHEMES,
@@ -6944,9 +7031,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/runtime/uri.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/uri.js
   var require_uri = __commonJS({
-    "node_modules/ajv/dist/runtime/uri.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/uri.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var uri = require_fast_uri();
@@ -6955,9 +7042,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/core.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/core.js
   var require_core = __commonJS({
-    "node_modules/ajv/dist/core.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/core.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.CodeGen = exports.Name = exports.nil = exports.stringify = exports.str = exports._ = exports.KeywordCxt = void 0;
@@ -7566,9 +7653,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/core/id.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/id.js
   var require_id = __commonJS({
-    "node_modules/ajv/dist/vocabularies/core/id.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/id.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var def = {
@@ -7581,9 +7668,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/core/ref.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/ref.js
   var require_ref = __commonJS({
-    "node_modules/ajv/dist/vocabularies/core/ref.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/ref.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.callRef = exports.getValidate = void 0;
@@ -7703,9 +7790,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/core/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/index.js
   var require_core2 = __commonJS({
-    "node_modules/ajv/dist/vocabularies/core/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/core/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var id_1 = require_id();
@@ -7724,9 +7811,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/limitNumber.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitNumber.js
   var require_limitNumber = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/limitNumber.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitNumber.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -7756,9 +7843,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/multipleOf.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/multipleOf.js
   var require_multipleOf = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/multipleOf.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/multipleOf.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -7784,9 +7871,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/runtime/ucs2length.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/ucs2length.js
   var require_ucs2length = __commonJS({
-    "node_modules/ajv/dist/runtime/ucs2length.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/ucs2length.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       function ucs2length(str) {
@@ -7810,9 +7897,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/limitLength.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitLength.js
   var require_limitLength = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/limitLength.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitLength.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -7842,9 +7929,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/pattern.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/pattern.js
   var require_pattern = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/pattern.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/pattern.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var code_1 = require_code2();
@@ -7879,9 +7966,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/limitProperties.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitProperties.js
   var require_limitProperties = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/limitProperties.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitProperties.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -7908,9 +7995,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/required.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/required.js
   var require_required = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/required.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/required.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var code_1 = require_code2();
@@ -7990,9 +8077,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/limitItems.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitItems.js
   var require_limitItems = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/limitItems.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitItems.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8019,9 +8106,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/runtime/equal.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/equal.js
   var require_equal = __commonJS({
-    "node_modules/ajv/dist/runtime/equal.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/runtime/equal.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var equal = require_fast_deep_equal();
@@ -8030,9 +8117,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/uniqueItems.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/uniqueItems.js
   var require_uniqueItems = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/uniqueItems.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/uniqueItems.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dataType_1 = require_dataType();
@@ -8097,9 +8184,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/const.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/const.js
   var require_const = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/const.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/const.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8126,9 +8213,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/enum.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/enum.js
   var require_enum = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/enum.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/enum.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8175,9 +8262,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/index.js
   var require_validation = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var limitNumber_1 = require_limitNumber();
@@ -8213,9 +8300,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/additionalItems.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/additionalItems.js
   var require_additionalItems = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/additionalItems.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/additionalItems.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.validateAdditionalItems = void 0;
@@ -8266,9 +8353,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/items.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/items.js
   var require_items = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/items.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/items.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.validateTuple = void 0;
@@ -8323,9 +8410,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/prefixItems.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/prefixItems.js
   var require_prefixItems = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/prefixItems.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/prefixItems.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var items_1 = require_items();
@@ -8340,9 +8427,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/items2020.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/items2020.js
   var require_items2020 = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/items2020.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/items2020.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8375,9 +8462,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/contains.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/contains.js
   var require_contains = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/contains.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/contains.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8469,9 +8556,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/dependencies.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/dependencies.js
   var require_dependencies = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/dependencies.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/dependencies.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.validateSchemaDeps = exports.validatePropertyDeps = exports.error = void 0;
@@ -8563,9 +8650,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/propertyNames.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/propertyNames.js
   var require_propertyNames = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/propertyNames.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/propertyNames.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8606,9 +8693,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/additionalProperties.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/additionalProperties.js
   var require_additionalProperties = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/additionalProperties.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/additionalProperties.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var code_1 = require_code2();
@@ -8712,9 +8799,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/properties.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/properties.js
   var require_properties = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/properties.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/properties.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var validate_1 = require_validate();
@@ -8770,9 +8857,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/patternProperties.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/patternProperties.js
   var require_patternProperties = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/patternProperties.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/patternProperties.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var code_1 = require_code2();
@@ -8844,9 +8931,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/not.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/not.js
   var require_not = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/not.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/not.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var util_1 = require_util();
@@ -8875,9 +8962,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/anyOf.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/anyOf.js
   var require_anyOf = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/anyOf.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/anyOf.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var code_1 = require_code2();
@@ -8892,9 +8979,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/oneOf.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/oneOf.js
   var require_oneOf = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/oneOf.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/oneOf.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -8950,9 +9037,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/allOf.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/allOf.js
   var require_allOf = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/allOf.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/allOf.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var util_1 = require_util();
@@ -8977,9 +9064,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/if.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/if.js
   var require_if = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/if.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/if.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -9046,9 +9133,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/thenElse.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/thenElse.js
   var require_thenElse = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/thenElse.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/thenElse.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var util_1 = require_util();
@@ -9064,9 +9151,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/index.js
   var require_applicator = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var additionalItems_1 = require_additionalItems();
@@ -9112,9 +9199,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/format/format.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/format/format.js
   var require_format = __commonJS({
-    "node_modules/ajv/dist/vocabularies/format/format.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/format/format.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -9202,9 +9289,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/format/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/format/index.js
   var require_format2 = __commonJS({
-    "node_modules/ajv/dist/vocabularies/format/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/format/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var format_1 = require_format();
@@ -9213,9 +9300,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/metadata.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/metadata.js
   var require_metadata = __commonJS({
-    "node_modules/ajv/dist/vocabularies/metadata.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/metadata.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.contentVocabulary = exports.metadataVocabulary = void 0;
@@ -9236,9 +9323,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/draft7.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/draft7.js
   var require_draft7 = __commonJS({
-    "node_modules/ajv/dist/vocabularies/draft7.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/draft7.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var core_1 = require_core2();
@@ -9258,9 +9345,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/dynamic/dynamicAnchor.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/dynamicAnchor.js
   var require_dynamicAnchor = __commonJS({
-    "node_modules/ajv/dist/vocabularies/dynamic/dynamicAnchor.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/dynamicAnchor.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.dynamicAnchor = void 0;
@@ -9293,9 +9380,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/dynamic/dynamicRef.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/dynamicRef.js
   var require_dynamicRef = __commonJS({
-    "node_modules/ajv/dist/vocabularies/dynamic/dynamicRef.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/dynamicRef.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.dynamicRef = void 0;
@@ -9339,9 +9426,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/dynamic/recursiveAnchor.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/recursiveAnchor.js
   var require_recursiveAnchor = __commonJS({
-    "node_modules/ajv/dist/vocabularies/dynamic/recursiveAnchor.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/recursiveAnchor.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dynamicAnchor_1 = require_dynamicAnchor();
@@ -9360,9 +9447,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/dynamic/recursiveRef.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/recursiveRef.js
   var require_recursiveRef = __commonJS({
-    "node_modules/ajv/dist/vocabularies/dynamic/recursiveRef.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/recursiveRef.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dynamicRef_1 = require_dynamicRef();
@@ -9375,9 +9462,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/dynamic/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/index.js
   var require_dynamic = __commonJS({
-    "node_modules/ajv/dist/vocabularies/dynamic/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/dynamic/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dynamicAnchor_1 = require_dynamicAnchor();
@@ -9389,9 +9476,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/dependentRequired.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/dependentRequired.js
   var require_dependentRequired = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/dependentRequired.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/dependentRequired.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dependencies_1 = require_dependencies();
@@ -9406,9 +9493,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/applicator/dependentSchemas.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/dependentSchemas.js
   var require_dependentSchemas = __commonJS({
-    "node_modules/ajv/dist/vocabularies/applicator/dependentSchemas.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/applicator/dependentSchemas.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dependencies_1 = require_dependencies();
@@ -9422,9 +9509,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/validation/limitContains.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitContains.js
   var require_limitContains = __commonJS({
-    "node_modules/ajv/dist/vocabularies/validation/limitContains.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/validation/limitContains.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var util_1 = require_util();
@@ -9442,9 +9529,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/next.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/next.js
   var require_next = __commonJS({
-    "node_modules/ajv/dist/vocabularies/next.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/next.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var dependentRequired_1 = require_dependentRequired();
@@ -9455,9 +9542,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedProperties.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedProperties.js
   var require_unevaluatedProperties = __commonJS({
-    "node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedProperties.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedProperties.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -9521,9 +9608,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedItems.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedItems.js
   var require_unevaluatedItems = __commonJS({
-    "node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedItems.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/unevaluatedItems.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -9565,9 +9652,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/unevaluated/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/index.js
   var require_unevaluated = __commonJS({
-    "node_modules/ajv/dist/vocabularies/unevaluated/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/unevaluated/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var unevaluatedProperties_1 = require_unevaluatedProperties();
@@ -9577,9 +9664,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/discriminator/types.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/discriminator/types.js
   var require_types = __commonJS({
-    "node_modules/ajv/dist/vocabularies/discriminator/types.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/discriminator/types.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.DiscrError = void 0;
@@ -9591,9 +9678,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/vocabularies/discriminator/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/discriminator/index.js
   var require_discriminator = __commonJS({
-    "node_modules/ajv/dist/vocabularies/discriminator/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/vocabularies/discriminator/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var codegen_1 = require_codegen();
@@ -9696,9 +9783,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/schema.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/schema.json
   var require_schema = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/schema.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/schema.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/schema",
@@ -9740,9 +9827,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/applicator.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/applicator.json
   var require_applicator2 = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/applicator.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/applicator.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/applicator",
@@ -9798,9 +9885,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/content.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/content.json
   var require_content = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/content.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/content.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/content",
@@ -9819,9 +9906,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/core.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/core.json
   var require_core3 = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/core.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/core.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/core",
@@ -9881,9 +9968,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/format.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/format.json
   var require_format3 = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/format.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/format.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/format",
@@ -9900,9 +9987,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/meta-data.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/meta-data.json
   var require_meta_data = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/meta-data.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/meta-data.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/meta-data",
@@ -9941,9 +10028,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/meta/validation.json
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/validation.json
   var require_validation2 = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/meta/validation.json"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/meta/validation.json"(exports, module) {
       module.exports = {
         $schema: "https://json-schema.org/draft/2019-09/schema",
         $id: "https://json-schema.org/draft/2019-09/meta/validation",
@@ -10036,9 +10123,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/refs/json-schema-2019-09/index.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/index.js
   var require_json_schema_2019_09 = __commonJS({
-    "node_modules/ajv/dist/refs/json-schema-2019-09/index.js"(exports) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/refs/json-schema-2019-09/index.js"(exports) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       var metaSchema = require_schema();
@@ -10069,9 +10156,9 @@ var HoloSphere = (() => {
     }
   });
-  // node_modules/ajv/dist/2019.js
+  // node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/2019.js
   var require__ = __commonJS({
-    "node_modules/ajv/dist/2019.js"(exports, module) {
+    "node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/2019.js"(exports, module) {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.MissingRefError = exports.ValidationError = exports.CodeGen = exports.Name = exports.nil = exports.stringify = exports.str = exports._ = exports.KeywordCxt = exports.Ajv2019 = void 0;
@@ -10165,7 +10252,7 @@ var HoloSphere = (() => {
     version: () => version
   });
-  // node_modules/h3-js/dist/browser/h3-js.es.js
+  // node_modules/.pnpm/h3-js@4.4.0/node_modules/h3-js/dist/browser/h3-js.es.js
   var libh3 = (function(libh32) {
     libh32 = libh32 || {};
     var Module = typeof libh32 !== "undefined" ? libh32 : {};
@@ -24328,9 +24415,19 @@ var HoloSphere = (() => {
           }
         );
         if (originalData && !originalData._invalidHologram) {
-          return attachHologramMeta(originalData, hologram.soul);
+          const withMeta = attachHologramMeta(originalData, hologram.soul);
+          if (withMeta._hologram?.sourceHolon && typeof holoInstance.getHolonName === "function") {
+            try {
+              const sourceHolonName = await holoInstance.getHolonName(withMeta._hologram.sourceHolon);
+              if (sourceHolonName) {
+                withMeta._hologram = { ...withMeta._hologram, sourceHolonName };
+              }
+            } catch {
+            }
+          }
+          return withMeta;
         } else {
-          console.warn(`!!! Original data NOT FOUND for soul: ${hologram.soul}. Removing broken hologram.`);
+          console.warn(`Could not resolve hologram soul: ${hologram.soul} (target not present locally)`);
           return null;
         }
       } else {
@@ -24668,7 +24765,14 @@ var HoloSphere = (() => {
       includeFederated = true,
       resolveReferences = true,
       maxFederatedSpaces = -1,
-      timeout = 1e4
+      timeout = 1e4,
+      // When `resolveReferences` is on, source-soul fetches that fail get
+      // replaced with `{ id, _hologram: { isHologram: false, error } }`
+      // error stubs (federation.js around line 654). By default we filter
+      // those out of the response so consumers never render broken-card
+      // placeholders. Set `includeUnresolvedStubs: true` if you actually
+      // want to surface the failure to the user (e.g. an admin/debug view).
+      includeUnresolvedStubs = false
     } = options;
     console.log(`resolveReferences option: ${resolveReferences}`);
     console.log(`Querying specific IDs:`, queryIds ? queryIds.join(", ") : "No (fetching all)");
@@ -24847,9 +24951,13 @@ var HoloSphere = (() => {
         };
         return base;
       });
-      return aggregatedData;
+      return includeUnresolvedStubs ? aggregatedData : aggregatedData.filter(isResolved);
     }
-    return result;
+    return includeUnresolvedStubs ? result : result.filter(isResolved);
+  }
+  function isResolved(item) {
+    if (!item || typeof item !== "object") return false;
+    return item._hologram?.isHologram !== false;
   }
   async function propagate(holosphere, holon, lens, data, options = {}) {
     if (!holosphere || !holon || !lens || !data) {
@@ -24877,7 +24985,7 @@ var HoloSphere = (() => {
     try {
       const fedInfo = await getFederation(holosphere, holon, password);
       if (fedInfo && fedInfo.outbound && fedInfo.outbound.length > 0) {
-        let spaces = fedInfo.outbound;
+        let spaces = fedInfo.outbound.filter((s) => String(s) !== String(holon));
         if (targetSpaces && Array.isArray(targetSpaces) && targetSpaces.length > 0) {
           spaces = spaces.filter((space) => targetSpaces.includes(space));
         }
@@ -24930,6 +25038,10 @@ var HoloSphere = (() => {
                     }
                   };
                 }
+                if (String(targetSpace) === String(holon)) {
+                  result.skipped++;
+                  return true;
+                }
                 await holosphere.put(targetSpace, lens, payloadToPut, null, {
                   disableHologramRedirection: true,
                   autoPropagate: false
@@ -25278,6 +25390,40 @@ var HoloSphere = (() => {
   }
   // content.js
+  var READ_TIMEOUT_MS = 8e3;
+  var WRITE_TIMEOUT_MS = 5e3;
+  function onceWithTimeout(node, timeoutMs = READ_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+      let done = false;
+      const finish = (v) => {
+        if (!done) {
+          done = true;
+          resolve(v);
+        }
+      };
+      node.once((data) => finish(data));
+      if (timeoutMs > 0) {
+        setTimeout(() => finish(null), timeoutMs);
+      }
+    });
+  }
+  function withWriteTimeout(promise, timeoutMs, queuedResult) {
+    if (!timeoutMs || timeoutMs <= 0) return promise;
+    return new Promise((resolve, reject) => {
+      let done = false;
+      const finish = (fn, val) => {
+        if (!done) {
+          done = true;
+          fn(val);
+        }
+      };
+      promise.then(
+        (v) => finish(resolve, v),
+        (e) => finish(reject, e)
+      );
+      setTimeout(() => finish(resolve, queuedResult), timeoutMs);
+    });
+  }
   function sanitizeForStorage(value, path = "", seen = /* @__PURE__ */ new WeakSet(), warnings = []) {
     if (value === null) return null;
     const t = typeof value;
@@ -25324,7 +25470,11 @@ var HoloSphere = (() => {
     if (!holon || !lens) {
       throw new Error("put: Missing required holon or lens parameters:", holon, lens);
     }
-    const { disableHologramRedirection = false } = options;
+    const {
+      disableHologramRedirection = false,
+      timeout: writeTimeoutOverride
+    } = options;
+    const writeTimeoutMs = writeTimeoutOverride !== void 0 ? writeTimeoutOverride : WRITE_TIMEOUT_MS;
     let targetHolon = holon;
     let targetLens = lens;
     let targetKey = data.id;
@@ -25412,7 +25562,7 @@ var HoloSphere = (() => {
           });
         });
       }
-      return new Promise((resolve, reject) => {
+      const ackPromise = new Promise((resolve, reject) => {
         try {
           const sanitizeWarnings = [];
           let dataToStore = sanitizeForStorage(data, "", /* @__PURE__ */ new WeakSet(), sanitizeWarnings) || {};
@@ -25424,6 +25574,7 @@ var HoloSphere = (() => {
           }
           if (dataToStore._meta !== void 0) delete dataToStore._meta;
           if (dataToStore._hologram !== void 0) delete dataToStore._hologram;
+          if (!isHologram2 && dataToStore._federation !== void 0) delete dataToStore._federation;
           const payload = JSON.stringify(dataToStore);
           const putCallback = async (ack) => {
             if (ack.err) {
@@ -25444,16 +25595,17 @@ var HoloSphere = (() => {
                 }
               }
               let updatedHolograms = [];
-              if (!isHologram2 && !options.isHologramUpdate) {
+              const currentDataSoul = `${holoInstance.appname}/${targetHolon}/${targetLens}/${targetKey}`;
+              const cascadeVisited = new Set(options._cascadeVisited || []);
+              if (!cascadeVisited.has(currentDataSoul)) {
+                cascadeVisited.add(currentDataSoul);
                 try {
-                  const currentDataSoul = `${holoInstance.appname}/${targetHolon}/${targetLens}/${targetKey}`;
                   const currentNodeRef = holoInstance.getNodeRef(currentDataSoul);
                   await new Promise((resolveHologramUpdate) => {
                     currentNodeRef.get("_holograms").once(async (hologramsSet) => {
                       if (hologramsSet) {
                         const hologramSouls = Object.keys(hologramsSet).filter(
-                          (k) => k !== "_" && hologramsSet[k] === true
-                          // Only active holograms (deleted ones are null/removed)
+                          (k) => k !== "_" && hologramsSet[k] === true && !cascadeVisited.has(k)
                         );
                         if (hologramSouls.length > 0) {
                           const updatePromises = hologramSouls.map(async (hologramSoul) => {
@@ -25482,8 +25634,12 @@ var HoloSphere = (() => {
                                       // Don't auto-propagate hologram updates
                                       disableHologramRedirection: true,
                                       // Prevent redirection when updating holograms
-                                      isHologramUpdate: true
-                                      // Prevent recursive hologram updates
+                                      isHologramUpdate: true,
+                                      // Carry the visited set forward so the
+                                      // recursive put keeps cascading through
+                                      // this hop's `_holograms` set without
+                                      // looping back through us.
+                                      _cascadeVisited: cascadeVisited
                                     }
                                   );
                                   updatedHolograms.push({
@@ -25561,6 +25717,16 @@ var HoloSphere = (() => {
           reject(error);
         }
       });
+      return withWriteTimeout(ackPromise, writeTimeoutMs, {
+        success: true,
+        queued: true,
+        isHologramAtPath: isHologram2,
+        pathHolon: targetHolon,
+        pathLens: targetLens,
+        pathKey: targetKey,
+        propagationResult: null,
+        updatedHolograms: []
+      });
     } catch (error) {
       console.error("Error in put:", error);
       throw error;
@@ -25571,7 +25737,19 @@ var HoloSphere = (() => {
       console.error("get: Missing required parameters");
       return null;
     }
-    const { resolveHolograms = true, validationOptions = {}, visited } = options;
+    const {
+      resolveHolograms = true,
+      validationOptions = {},
+      visited,
+      timeout = READ_TIMEOUT_MS,
+      // `_deleted: true` is the soft-tombstone convention used by the bot,
+      // the web dashboard, and the MCP council tools. Pre-this fix the
+      // library was unaware of it and every caller filtered defensively.
+      // Now `get` returns `null` for tombstoned records by default; pass
+      // `includeDeleted: true` to surface them (admin/debug views,
+      // history reconstruction, etc.).
+      includeDeleted = false
+    } = options;
     let schema = null;
     if (holoInstance.strict) {
       schema = await holoInstance.getSchema(lens);
@@ -25607,6 +25785,10 @@ var HoloSphere = (() => {
               resolve(null);
               return;
             }
+            if (!includeDeleted && parsed._deleted === true) {
+              resolve(null);
+              return;
+            }
             if (resolveHolograms && holoInstance.isHologram(parsed)) {
               const resolvedValue = await holoInstance.resolveHologram(parsed, {
                 followHolograms: resolveHolograms,
@@ -25615,13 +25797,7 @@ var HoloSphere = (() => {
                 currentDepth: options.currentDepth || 0
               });
               if (resolvedValue === null) {
-                console.warn(`Broken hologram detected at ${holon}/${lens}/${key}. Removing it...`);
-                try {
-                  await holoInstance.delete(holon, lens, key, password);
-                  console.log(`Successfully removed broken hologram from ${holon}/${lens}/${key}`);
-                } catch (cleanupError) {
-                  console.error(`Failed to remove broken hologram at ${holon}/${lens}/${key}:`, cleanupError);
-                }
+                console.warn(`Hologram at ${holon}/${lens}/${key} did not resolve (soul=${parsed.soul}); skipping.`);
                 resolve(null);
                 return;
               }
@@ -25651,17 +25827,23 @@ var HoloSphere = (() => {
           }
         };
         const dataPath = password ? user.get("private").get(lens).get(key) : holoInstance.gun.get(holoInstance.appname).get(holon).get(lens).get(key);
-        dataPath.once(handleData);
+        onceWithTimeout(dataPath, timeout).then(handleData);
       });
     } catch (error) {
       console.error("Error in get:", error);
       return null;
     }
   }
-  async function getAll(holoInstance, holon, lens, password = null) {
+  async function getAll(holoInstance, holon, lens, password = null, options = {}) {
     if (!holon || !lens) {
       throw new Error("getAll: Missing required parameters");
     }
+    const {
+      timeout = READ_TIMEOUT_MS,
+      // See `get` above: `_deleted: true` records are dropped from the
+      // response unless the caller opts in.
+      includeDeleted = false
+    } = options;
     const schema = await holoInstance.getSchema(lens);
     if (!schema && holoInstance.strict) {
       throw new Error("getAll: Schema required in strict mode");
@@ -25713,7 +25895,7 @@ var HoloSphere = (() => {
         const output = /* @__PURE__ */ new Map();
         const pendingProcessing = [];
         const dataPath = password ? user.get("private").get(lens) : holoInstance.gun.get(holoInstance.appname).get(holon).get(lens);
-        const shallowOnce = () => new Promise((res) => dataPath.once((d) => res(d)));
+        const shallowOnce = () => onceWithTimeout(dataPath, timeout);
         const processShallow = (data) => {
           if (!data) {
             resolve([]);
@@ -25736,6 +25918,7 @@ var HoloSphere = (() => {
             try {
               const parsed = await holoInstance.parse(itemData);
               if (!parsed || !parsed.id) return;
+              if (!includeDeleted && parsed._deleted === true) return;
               if (holoInstance.isHologram(parsed)) {
                 try {
                   const resolved = await holoInstance.resolveHologram(parsed, {
@@ -25744,12 +25927,7 @@ var HoloSphere = (() => {
                     currentDepth: 0
                   });
                   if (resolved === null) {
-                    console.warn(`Broken hologram detected in getAll for key ${key}. Removing it...`);
-                    try {
-                      await holoInstance.delete(holon, lens, key, password);
-                    } catch (cleanupError) {
-                      console.error(`Failed to remove broken hologram at ${holon}/${lens}/${key}:`, cleanupError);
-                    }
+                    console.warn(`Hologram at ${holon}/${lens}/${key} did not resolve (soul=${parsed.soul}); skipping.`);
                     return;
                   }
                   if (resolved && resolved !== parsed) {
@@ -25785,11 +25963,7 @@ var HoloSphere = (() => {
             if (typeof inline !== "object" || inline === null) {
               return processItem(inline, key);
             }
-            return new Promise((resolveItem) => {
-              dataPath.get(key).once((itemData) => {
-                processItem(itemData, key).then(resolveItem, resolveItem);
-              });
-            });
+            return onceWithTimeout(dataPath.get(key), timeout).then((itemData) => processItem(itemData, key));
           })).then(() => resolve(Array.from(output.values())));
         };
         (async () => {
@@ -26225,7 +26399,25 @@ var HoloSphere = (() => {
   }
   // global.js
-  async function putGlobal(holoInstance, tableName, data, password = null) {
+  var WRITE_TIMEOUT_MS2 = 5e3;
+  function withWriteTimeout2(promise, timeoutMs, queuedResult) {
+    if (!timeoutMs || timeoutMs <= 0) return promise;
+    return new Promise((resolve, reject) => {
+      let done = false;
+      const finish = (fn, val) => {
+        if (!done) {
+          done = true;
+          fn(val);
+        }
+      };
+      promise.then(
+        (v) => finish(resolve, v),
+        (e) => finish(reject, e)
+      );
+      setTimeout(() => finish(resolve, queuedResult), timeoutMs);
+    });
+  }
+  async function putGlobal(holoInstance, tableName, data, password = null, options = {}) {
     try {
       if (!tableName || !data) {
         throw new Error("Table name and data are required");
@@ -26272,7 +26464,8 @@ var HoloSphere = (() => {
           });
         });
       }
-      return new Promise((resolve, reject) => {
+      const writeTimeoutMs = options.timeout !== void 0 ? options.timeout : WRITE_TIMEOUT_MS2;
+      const ackPromise = new Promise((resolve, reject) => {
         try {
           let dataToStore = { ...data };
           if (dataToStore._meta !== void 0) {
@@ -26334,6 +26527,17 @@ var HoloSphere = (() => {
           reject(error);
         }
       });
+      const ACK_OK = Symbol("ackOk");
+      return withWriteTimeout2(
+        ackPromise.then(() => ACK_OK),
+        writeTimeoutMs,
+        void 0
+      ).then((result) => {
+        if (result !== ACK_OK) {
+          console.warn(`putGlobal: no ack within ${writeTimeoutMs}ms for table=${tableName} \u2014 write queued locally, will replay on reconnect`);
+        }
+        return void 0;
+      });
     } catch (error) {
       console.error("Error in putGlobal:", error);
       throw error;
@@ -26793,7 +26997,7 @@ var HoloSphere = (() => {
       throw error;
     }
   }
-  async function subscribeGlobal(holoInstance, tableName, key, callback, options = {}) {
+  function subscribeGlobal(holoInstance, tableName, key, callback, options = {}) {
     const dataPath = holoInstance.gun.get(holoInstance.appname).get(tableName);
     let active = true;
     if (key) {
@@ -27038,7 +27242,7 @@ var HoloSphere = (() => {
     }
     return list;
   }
-  async function subscribe(holoInstance, holon, lens, callback) {
+  function subscribe(holoInstance, holon, lens, callback) {
     if (!holon || !lens) {
       throw new Error("subscribe: Missing holon or lens parameters:", holon, lens);
     }
@@ -27061,6 +27265,10 @@ var HoloSphere = (() => {
                 parsed = resolved;
               }
             }
+            if (parsed !== null && (typeof parsed !== "object" || Array.isArray(parsed))) {
+              console.warn(`[holosphere.subscribe] dropping non-object payload at ${holon}/${lens}/${key}:`, typeof parsed);
+              return;
+            }
             if (holoInstance.subscriptions[subscriptionId]) {
               callback(parsed, key);
             }
@@ -27080,7 +27288,7 @@ var HoloSphere = (() => {
         // Store the listener too (optional, maybe needed for close?)
       };
       return {
-        unsubscribe: async () => {
+        unsubscribe: () => {
           const sub = holoInstance.subscriptions[subscriptionId];
           if (!sub) {
             return;
@@ -27206,10 +27414,10 @@ var HoloSphere = (() => {
     return `${holoInstance.appname}:${holonId}`;
   }
-  // node_modules/@noble/hashes/esm/crypto.js
+  // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/crypto.js
   var crypto = typeof globalThis === "object" && "crypto" in globalThis ? globalThis.crypto : void 0;
-  // node_modules/@noble/hashes/esm/utils.js
+  // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/utils.js
   function isBytes(a) {
     return a instanceof Uint8Array || ArrayBuffer.isView(a) && a.constructor.name === "Uint8Array";
   }
@@ -27345,7 +27553,7 @@ var HoloSphere = (() => {
     throw new Error("crypto.getRandomValues must be defined");
   }
-  // node_modules/@noble/hashes/esm/_md.js
+  // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/_md.js
   function setBigUint64(view, byteOffset, value, isLE) {
     if (typeof view.setBigUint64 === "function")
       return view.setBigUint64(byteOffset, value, isLE);
@@ -27465,7 +27673,7 @@ var HoloSphere = (() => {
     1541459225
   ]);
-  // node_modules/@noble/hashes/esm/sha2.js
+  // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/sha2.js
   var SHA256_K = /* @__PURE__ */ Uint32Array.from([
     1116352408,
     1899447441,
@@ -27605,7 +27813,7 @@ var HoloSphere = (() => {
   };
   var sha256 = /* @__PURE__ */ createHasher(() => new SHA256());
-  // node_modules/@noble/hashes/esm/hmac.js
+  // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/hmac.js
   var HMAC = class extends Hash {
     constructor(hash, _key) {
       super();
@@ -27673,7 +27881,7 @@ var HoloSphere = (() => {
   var hmac = (hash, key, message) => new HMAC(hash, key).update(message).digest();
   hmac.create = (hash, key) => new HMAC(hash, key);
-  // node_modules/@noble/curves/esm/utils.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/utils.js
   var _0n = /* @__PURE__ */ BigInt(0);
   var _1n = /* @__PURE__ */ BigInt(1);
   function _abool2(value, title = "") {
@@ -27826,7 +28034,7 @@ var HoloSphere = (() => {
     };
   }
-  // node_modules/@noble/curves/esm/abstract/modular.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/abstract/modular.js
   var _0n2 = BigInt(0);
   var _1n2 = BigInt(1);
   var _2n = /* @__PURE__ */ BigInt(2);
@@ -28171,7 +28379,7 @@ var HoloSphere = (() => {
     return isLE ? numberToBytesLE(reduced, fieldLen) : numberToBytesBE(reduced, fieldLen);
   }
-  // node_modules/@noble/curves/esm/abstract/curve.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/abstract/curve.js
   var _0n3 = BigInt(0);
   var _1n3 = BigInt(1);
   function negateCt(condition, item) {
@@ -28449,7 +28657,7 @@ var HoloSphere = (() => {
     return { CURVE, Fp, Fn };
   }
-  // node_modules/@noble/curves/esm/abstract/weierstrass.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/abstract/weierstrass.js
   var divNearest = (num, den) => (num + (num >= 0 ? den : -den) / _2n2) / den;
   function _splitEndoScalar(k, basis, n) {
     const [[a1, b1], [a2, b2]] = basis;
@@ -29463,13 +29671,13 @@ var HoloSphere = (() => {
     return _ecdsa_new_output_to_legacy(c, signs);
   }
-  // node_modules/@noble/curves/esm/_shortw_utils.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/_shortw_utils.js
   function createCurve(curveDef, defHash) {
     const create = (hash) => weierstrass({ ...curveDef, hash });
     return { ...create(defHash), create };
   }
-  // node_modules/@noble/curves/esm/secp256k1.js
+  // node_modules/.pnpm/@noble+curves@1.9.7/node_modules/@noble/curves/esm/secp256k1.js
   var secp256k1_CURVE = {
     p: BigInt("0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffefffffc2f"),
     n: BigInt("0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141"),
@@ -29512,7 +29720,7 @@ var HoloSphere = (() => {
   var Fpk1 = Field(secp256k1_CURVE.p, { sqrt: sqrtMod });
   var secp256k1 = createCurve({ ...secp256k1_CURVE, Fp: Fpk1, lowS: true, endo: secp256k1_ENDO }, sha256);
-  // node_modules/@scure/base/lib/esm/index.js
+  // node_modules/.pnpm/@scure+base@1.2.6/node_modules/@scure/base/lib/esm/index.js
   function isBytes2(a) {
     return a instanceof Uint8Array || ArrayBuffer.isView(a) && a.constructor.name === "Uint8Array";
   }
@@ -30330,6 +30538,7 @@ var HoloSphere = (() => {
       this.openai = null;
       this.subscriptions = {};
       this.schemaCache = /* @__PURE__ */ new Map();
+      this._holonNameCache = /* @__PURE__ */ new Map();
       this._allowedAuthors = /* @__PURE__ */ new Set();
     }
     /**
@@ -30383,8 +30592,8 @@ var HoloSphere = (() => {
       }
       return get(this, holon, lens, key, password, options);
     }
-    async getAll(holon, lens, password = null) {
-      return getAll(this, holon, lens, password);
+    async getAll(holon, lens, password = null, options = {}) {
+      return getAll(this, holon, lens, password, options);
     }
     async parse(rawData) {
       return parse(this, rawData);
@@ -30412,14 +30621,14 @@ var HoloSphere = (() => {
       return deleteNode(this, holon, lens, key);
     }
     // ================================ GLOBAL FUNCTIONS ================================
-    async putGlobal(tableName, data, password = null) {
-      return putGlobal(this, tableName, data, password);
+    async putGlobal(tableName, data, password = null, options = {}) {
+      return putGlobal(this, tableName, data, password, options);
     }
     /**
      * v2-compatible alias for putGlobal (no password param)
      */
-    async writeGlobal(tableName, data) {
-      return putGlobal(this, tableName, data, null);
+    async writeGlobal(tableName, data, options = {}) {
+      return putGlobal(this, tableName, data, null, options);
     }
     async getGlobal(tableName, key, password = null) {
       return getGlobal(this, tableName, key, password);
@@ -30436,8 +30645,10 @@ var HoloSphere = (() => {
     /**
      * Subscribe to real-time changes in a global table.
      * v2-compatible: subscribeGlobal(lens, key, callback, options)
+     *
+     * Returns synchronously — see {@link subscribe}.
      */
-    async subscribeGlobal(lens, keyOrCallback, callbackOrOptions, options = {}) {
+    subscribeGlobal(lens, keyOrCallback, callbackOrOptions, options = {}) {
       let key, callback;
       if (typeof keyOrCallback === "function") {
         callback = keyOrCallback;
@@ -30493,12 +30704,50 @@ var HoloSphere = (() => {
     getHolonScalespace(holon) {
       return getHolonScalespace(holon);
     }
-    async subscribe(holon, lens, callback) {
+    /**
+     * Subscribe to real-time changes for a holon/lens.
+     *
+     * Synchronous return: `{ unsubscribe: () => void }`. Callers do not
+     * need to `await` — both `const s = holosphere.subscribe(...)` and
+     * `const s = await holosphere.subscribe(...)` yield the same shape.
+     */
+    subscribe(holon, lens, callback) {
       return subscribe(this, holon, lens, callback);
     }
     notifySubscribers(data) {
       return notifySubscribers(this, data);
     }
+    /**
+     * Resolve a holon's display name from its `settings/<holon>` record.
+     * Cached per-instance so repeated lookups (e.g. one per hologram in a
+     * federated batch) only fetch once. Returns `null` when no name is set.
+     *
+     * Used internally by `resolveHologram` to stamp
+     * `_hologram.sourceHolonName` so every consumer of a resolved hologram
+     * already has the display name without a second round-trip.
+     */
+    async getHolonName(holonId) {
+      if (!holonId) return null;
+      const key = String(holonId);
+      if (this._holonNameCache.has(key)) return this._holonNameCache.get(key);
+      try {
+        const settings = await this.get(key, "settings", key);
+        let name = null;
+        if (settings) {
+          if (Array.isArray(settings)) {
+            const found = settings.find((s) => s && typeof s.name === "string" && s.name.trim() !== "");
+            name = found ? found.name : null;
+          } else if (typeof settings.name === "string" && settings.name.trim() !== "") {
+            name = settings.name;
+          }
+        }
+        this._holonNameCache.set(key, name);
+        return name;
+      } catch {
+        this._holonNameCache.set(key, null);
+        return null;
+      }
+    }
     generateId() {
       return generateId();
     }