@layerzerolabs/base-definitions 0.2.5 → 0.2.7

package/.turbo/turbo-build.log

@@ -4,51 +4,51 @@
 
 CLI Building entry: src/definitions.ts, src/index.ts, src/lzyringe.ts, src/registrarBuilder.ts, src/utils.ts
 CLI Using tsconfig: tsconfig.json
-CLI tsup v8.4.0
+CLI tsup v8.5.1
 CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions/tsup.config.ts
 CLI Target: ES2023
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
+CJS dist/definitions.cjs          742.00 B
+CJS dist/lzyringe.cjs             302.00 B
+CJS dist/index.cjs                1.42 KB
+CJS dist/JKTGUQY4.cjs             1.70 KB
+CJS dist/utils.cjs                341.00 B
+CJS dist/registrarBuilder.cjs     481.00 B
+CJS dist/3AKKEY5J.cjs             6.27 KB
+CJS dist/OIBEOODK.cjs             812.00 B
+CJS dist/VTYVOFLM.cjs             1.68 KB
+CJS dist/YJF4D23A.cjs             245.00 B
+CJS dist/definitions.cjs.map      76.00 B
+CJS dist/lzyringe.cjs.map         73.00 B
+CJS dist/index.cjs.map            70.00 B
+CJS dist/registrarBuilder.cjs.map 81.00 B
+CJS dist/3AKKEY5J.cjs.map         17.00 KB
+CJS dist/OIBEOODK.cjs.map         1.83 KB
+CJS dist/VTYVOFLM.cjs.map         14.00 KB
+CJS dist/YJF4D23A.cjs.map         73.00 B
+CJS dist/JKTGUQY4.cjs.map         3.78 KB
+CJS dist/utils.cjs.map            70.00 B
+CJS ⚡️ Build success in 166ms
 ESM dist/index.js                389.00 B
 ESM dist/lzyringe.js             146.00 B
-ESM dist/registrarBuilder.js     191.00 B
 ESM dist/definitions.js          216.00 B
 ESM dist/JJBD65HU.js             1.65 KB
-ESM dist/4DUQS2FO.js             4.51 KB
+ESM dist/registrarBuilder.js     191.00 B
+ESM dist/H6QNIXMU.js             6.07 KB
 ESM dist/utils.js                173.00 B
 ESM dist/EAPC6542.js             733.00 B
-ESM dist/NQBJGAQC.js             1.47 KB
 ESM dist/VUOMXK5T.js             222.00 B
+ESM dist/NQBJGAQC.js             1.47 KB
 ESM dist/index.js.map            69.00 B
 ESM dist/lzyringe.js.map         72.00 B
-ESM dist/registrarBuilder.js.map 80.00 B
 ESM dist/definitions.js.map      75.00 B
 ESM dist/JJBD65HU.js.map         3.78 KB
-ESM dist/4DUQS2FO.js.map         12.78 KB
+ESM dist/H6QNIXMU.js.map         16.99 KB
+ESM dist/registrarBuilder.js.map 80.00 B
 ESM dist/utils.js.map            69.00 B
 ESM dist/EAPC6542.js.map         1.82 KB
-ESM dist/NQBJGAQC.js.map         13.99 KB
 ESM dist/VUOMXK5T.js.map         72.00 B
-ESM ⚡️ Build success in 331ms
-CJS dist/lzyringe.cjs             302.00 B
-CJS dist/JKTGUQY4.cjs             1.70 KB
-CJS dist/registrarBuilder.cjs     478.00 B
-CJS dist/OIBEOODK.cjs             812.00 B
-CJS dist/O7HENH25.cjs             4.66 KB
-CJS dist/utils.cjs                341.00 B
-CJS dist/YJF4D23A.cjs             245.00 B
-CJS dist/VTYVOFLM.cjs             1.68 KB
-CJS dist/index.cjs                1.42 KB
-CJS dist/definitions.cjs          742.00 B
-CJS dist/lzyringe.cjs.map         73.00 B
-CJS dist/OIBEOODK.cjs.map         1.83 KB
-CJS dist/JKTGUQY4.cjs.map         3.78 KB
-CJS dist/O7HENH25.cjs.map         12.79 KB
-CJS dist/utils.cjs.map            70.00 B
-CJS dist/YJF4D23A.cjs.map         73.00 B
-CJS dist/VTYVOFLM.cjs.map         14.00 KB
-CJS dist/registrarBuilder.cjs.map 81.00 B
-CJS dist/index.cjs.map            70.00 B
-CJS dist/definitions.cjs.map      76.00 B
-CJS ⚡️ Build success in 332ms
+ESM dist/NQBJGAQC.js.map         13.99 KB
+ESM ⚡️ Build success in 167ms

package/.turbo/turbo-lint.log

@@ -2,3 +2,7 @@
 > @layerzerolabs/base-definitions@0.0.2 lint /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 > eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)
 
+(node:23094) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1764985257978 is not specified and it doesn't parse as CommonJS.
+Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
+To eliminate this warning, add "type": "module" to /home/runner/work/monorepo-internal/monorepo-internal/package.json.
+(Use `node --trace-warnings ...` to show where the warning was created)

package/.turbo/turbo-test.log

@@ -5,13 +5,13 @@
 Testing types with tsc and vue-tsc is an experimental feature.
 Breaking changes might not follow SemVer, please pin Vitest's version when using it.
 
- RUN  v3.2.3 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
+ RUN  v3.2.4 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 
- ✓ test/registrarBuilder.test.ts (4 tests) 11ms
+ ✓ test/registrarBuilder.test.ts (7 tests) 11ms
 
  Test Files  1 passed (1)
-      Tests  4 passed (4)
+      Tests  7 passed (7)
 Type Errors  no errors
-   Start at  19:04:05
-   Duration  802ms (transform 161ms, setup 0ms, collect 136ms, tests 11ms, environment 0ms, prepare 218ms)
+   Start at  01:44:45
+   Duration  575ms (transform 107ms, setup 0ms, collect 99ms, tests 11ms, environment 0ms, prepare 126ms)
 

package/dist/{O7HENH25.cjs → 3AKKEY5J.cjs}

@@ -1,6 +1,7 @@
 'use strict';
 
 var YJF4D23A_cjs = require('./YJF4D23A.cjs');
+var dependencyGraph = require('@layerzerolabs/dependency-graph');
 var dfs = require('@layerzerolabs/dfs');
 
 var RegistrarBuilder = class {
@@ -8,13 +9,24 @@ var RegistrarBuilder = class {
     YJF4D23A_cjs.__name(this, "RegistrarBuilder");
   }
   defaultHandler;
+  namedHandlers = {};
+  classHandlers = [];
+  classAliases = [];
+  getEntrypoints = /* @__PURE__ */ YJF4D23A_cjs.__name((node) => [
+    node
+  ], "getEntrypoints");
   constructor() {
     this.defaultHandler = async (node) => {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  classHandlers = [];
-  classAliases = [];
+  addNamedHandler(node, fn) {
+    if (this.namedHandlers[node.name]) {
+      throw new Error(`Cannot define a named handler for an identifier that already has a handler: ${node.name}`);
+    }
+    this.namedHandlers[node.name] = fn;
+    return this;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -93,6 +105,14 @@ var RegistrarBuilder = class {
     });
     return this;
   }
+  /**
+   * Set a custom entrypoint getter function. By default, the entrypoint getter
+   * returns the node passed in as the sole entrypoint.
+   */
+  setEntrypointsGetter(fn) {
+    this.getEntrypoints = fn;
+    return this;
+  }
   /**
    * Add a default function fn to be used on nodes whose types do not have handlers.
    * If this is not set, the default behaviour will be to throw
@@ -112,6 +132,19 @@ var RegistrarBuilder = class {
       return node;
     }, "mergedNodePrehandler");
     const mergedNodeHandler = /* @__PURE__ */ YJF4D23A_cjs.__name(async (node, ancestry) => {
+      if (node.name === "_virtualEntrypoint") {
+        return {
+          key: node.name,
+          value: void 0
+        };
+      }
+      const namedHandler = this.namedHandlers[node.name];
+      if (namedHandler) {
+        return {
+          key: node.name,
+          value: await namedHandler(node, ancestry)
+        };
+      }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
         if (node instanceof nodeClass) {
           return {
@@ -126,7 +159,24 @@ var RegistrarBuilder = class {
       };
     }, "mergedNodeHandler");
     return {
-      traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)(), "traverseDependencies")
+      traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => {
+        const entrypoints = this.getEntrypoints(node);
+        if (entrypoints.length === 1) return await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)();
+        const dependencies = entrypoints.reduce((acc, cur) => {
+          acc[cur.name] = cur;
+          return acc;
+        }, {});
+        let VirtualNode = class VirtualNode extends dependencyGraph.DependencyNode {
+          static {
+            YJF4D23A_cjs.__name(this, "VirtualNode");
+          }
+        };
+        const virtualEntrypoint = new VirtualNode({
+          name: "_virtualEntrypoint",
+          dependencies
+        });
+        return await dfs.dfs(virtualEntrypoint, mergedNodeHandler, mergedNodePrehandler)();
+      }, "traverseDependencies")
     };
   }
 };
@@ -146,5 +196,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ YJF4D23A_cjs.__name((...registr
 
 exports.RegistrarBuilder = RegistrarBuilder;
 exports.multiplexOrderedRegistrars = multiplexOrderedRegistrars;
-//# sourceMappingURL=O7HENH25.cjs.map
-//# sourceMappingURL=O7HENH25.cjs.map
+//# sourceMappingURL=3AKKEY5J.cjs.map
+//# sourceMappingURL=3AKKEY5J.cjs.map

package/dist/3AKKEY5J.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","namedHandlers","classHandlers","classAliases","getEntrypoints","node","Error","JSON","stringify","addNamedHandler","fn","name","addClassHandler","nodeClass","identifier","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","__name","ancestry","key","value","undefined","namedHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"3AKKEY5J.cjs","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n\n    protected namedHandlers: Record<\n        string,\n        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>\n    > = {};\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\n    }[] = [];\n\n    protected getEntrypoints: (node: DependencyNode) => DependencyNode[] = (node) => [node];\n\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    public addNamedHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, fn: Function) {\n        if (this.namedHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a named handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.namedHandlers[node.name] = fn as unknown as (\n            node: DependencyNode,\n            ancestry: DependencyNode[],\n        ) => Promise<any>;\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['namedHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>, ancestry: DependencyNode[]) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n        });\n\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]) {\n        this.getEntrypoints = fn;\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {\n            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const namedHandler = this.namedHandlers[node.name];\n            if (namedHandler) {\n                return {\n                    key: node.name,\n                    value: await namedHandler(node, ancestry),\n                };\n            }\n\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) => {\n                const entrypoints = this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/{4DUQS2FO.js → H6QNIXMU.js}

@@ -1,4 +1,5 @@
 import { __name } from './VUOMXK5T.js';
+import { DependencyNode } from '@layerzerolabs/dependency-graph';
 import { dfs } from '@layerzerolabs/dfs';
 
 var RegistrarBuilder = class {
@@ -6,13 +7,24 @@ var RegistrarBuilder = class {
     __name(this, "RegistrarBuilder");
   }
   defaultHandler;
+  namedHandlers = {};
+  classHandlers = [];
+  classAliases = [];
+  getEntrypoints = /* @__PURE__ */ __name((node) => [
+    node
+  ], "getEntrypoints");
   constructor() {
     this.defaultHandler = async (node) => {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  classHandlers = [];
-  classAliases = [];
+  addNamedHandler(node, fn) {
+    if (this.namedHandlers[node.name]) {
+      throw new Error(`Cannot define a named handler for an identifier that already has a handler: ${node.name}`);
+    }
+    this.namedHandlers[node.name] = fn;
+    return this;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -91,6 +103,14 @@ var RegistrarBuilder = class {
     });
     return this;
   }
+  /**
+   * Set a custom entrypoint getter function. By default, the entrypoint getter
+   * returns the node passed in as the sole entrypoint.
+   */
+  setEntrypointsGetter(fn) {
+    this.getEntrypoints = fn;
+    return this;
+  }
   /**
    * Add a default function fn to be used on nodes whose types do not have handlers.
    * If this is not set, the default behaviour will be to throw
@@ -110,6 +130,19 @@ var RegistrarBuilder = class {
       return node;
     }, "mergedNodePrehandler");
     const mergedNodeHandler = /* @__PURE__ */ __name(async (node, ancestry) => {
+      if (node.name === "_virtualEntrypoint") {
+        return {
+          key: node.name,
+          value: void 0
+        };
+      }
+      const namedHandler = this.namedHandlers[node.name];
+      if (namedHandler) {
+        return {
+          key: node.name,
+          value: await namedHandler(node, ancestry)
+        };
+      }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
         if (node instanceof nodeClass) {
           return {
@@ -124,7 +157,24 @@ var RegistrarBuilder = class {
       };
     }, "mergedNodeHandler");
     return {
-      traverseDependencies: /* @__PURE__ */ __name(async (node) => await dfs(node, mergedNodeHandler, mergedNodePrehandler)(), "traverseDependencies")
+      traverseDependencies: /* @__PURE__ */ __name(async (node) => {
+        const entrypoints = this.getEntrypoints(node);
+        if (entrypoints.length === 1) return await dfs(node, mergedNodeHandler, mergedNodePrehandler)();
+        const dependencies = entrypoints.reduce((acc, cur) => {
+          acc[cur.name] = cur;
+          return acc;
+        }, {});
+        let VirtualNode = class VirtualNode extends DependencyNode {
+          static {
+            __name(this, "VirtualNode");
+          }
+        };
+        const virtualEntrypoint = new VirtualNode({
+          name: "_virtualEntrypoint",
+          dependencies
+        });
+        return await dfs(virtualEntrypoint, mergedNodeHandler, mergedNodePrehandler)();
+      }, "traverseDependencies")
     };
   }
 };
@@ -143,5 +193,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
 }, "multiplexOrderedRegistrars");
 
 export { RegistrarBuilder, multiplexOrderedRegistrars };
-//# sourceMappingURL=4DUQS2FO.js.map
-//# sourceMappingURL=4DUQS2FO.js.map
+//# sourceMappingURL=H6QNIXMU.js.map
+//# sourceMappingURL=H6QNIXMU.js.map

package/dist/H6QNIXMU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","namedHandlers","classHandlers","classAliases","getEntrypoints","node","Error","JSON","stringify","addNamedHandler","fn","name","addClassHandler","nodeClass","identifier","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","ancestry","key","value","undefined","namedHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"H6QNIXMU.js","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n\n    protected namedHandlers: Record<\n        string,\n        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>\n    > = {};\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\n    }[] = [];\n\n    protected getEntrypoints: (node: DependencyNode) => DependencyNode[] = (node) => [node];\n\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    public addNamedHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, fn: Function) {\n        if (this.namedHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a named handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.namedHandlers[node.name] = fn as unknown as (\n            node: DependencyNode,\n            ancestry: DependencyNode[],\n        ) => Promise<any>;\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['namedHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>, ancestry: DependencyNode[]) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n        });\n\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]) {\n        this.getEntrypoints = fn;\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {\n            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const namedHandler = this.namedHandlers[node.name];\n            if (namedHandler) {\n                return {\n                    key: node.name,\n                    value: await namedHandler(node, ancestry),\n                };\n            }\n\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) => {\n                const entrypoints = this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var JKTGUQY4_cjs = require('./JKTGUQY4.cjs');
-var O7HENH25_cjs = require('./O7HENH25.cjs');
+var _3AKKEY5J_cjs = require('./3AKKEY5J.cjs');
 var OIBEOODK_cjs = require('./OIBEOODK.cjs');
 var VTYVOFLM_cjs = require('./VTYVOFLM.cjs');
 require('./YJF4D23A.cjs');
@@ -14,11 +14,11 @@ Object.defineProperty(exports, "DependencyStore", {
 });
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return O7HENH25_cjs.RegistrarBuilder; }
+  get: function () { return _3AKKEY5J_cjs.RegistrarBuilder; }
 });
 Object.defineProperty(exports, "multiplexOrderedRegistrars", {
   enumerable: true,
-  get: function () { return O7HENH25_cjs.multiplexOrderedRegistrars; }
+  get: function () { return _3AKKEY5J_cjs.multiplexOrderedRegistrars; }
 });
 Object.defineProperty(exports, "extractSchemaFromFactory", {
   enumerable: true,

package/dist/index.js

@@ -1,5 +1,5 @@
 export { DependencyStore } from './JJBD65HU.js';
-export { RegistrarBuilder, multiplexOrderedRegistrars } from './4DUQS2FO.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './H6QNIXMU.js';
 export { extractSchemaFromFactory } from './EAPC6542.js';
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions } from './NQBJGAQC.js';
 import './VUOMXK5T.js';

package/dist/registrarBuilder.cjs

@@ -1,17 +1,17 @@
 'use strict';
 
-var O7HENH25_cjs = require('./O7HENH25.cjs');
+var _3AKKEY5J_cjs = require('./3AKKEY5J.cjs');
 require('./YJF4D23A.cjs');
 
 
 
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return O7HENH25_cjs.RegistrarBuilder; }
+  get: function () { return _3AKKEY5J_cjs.RegistrarBuilder; }
 });
 Object.defineProperty(exports, "multiplexOrderedRegistrars", {
   enumerable: true,
-  get: function () { return O7HENH25_cjs.multiplexOrderedRegistrars; }
+  get: function () { return _3AKKEY5J_cjs.multiplexOrderedRegistrars; }
 });
 //# sourceMappingURL=registrarBuilder.cjs.map
 //# sourceMappingURL=registrarBuilder.cjs.map

package/dist/registrarBuilder.d.ts

@@ -1,4 +1,4 @@
-import type { DependencyNode } from '@layerzerolabs/dependency-graph';
+import { DependencyNode } from '@layerzerolabs/dependency-graph';
 import type { Registrar } from '@layerzerolabs/dfs';
 export type { Registrar };
 type NodeClass = new (...args: any[]) => DependencyNode;
@@ -18,7 +18,7 @@ type AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;
  */
 export declare class RegistrarBuilder<_ReturnTypes> {
     protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;
-    constructor();
+    protected namedHandlers: Record<string, (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>>;
     protected classHandlers: {
         nodeClass: AbstractNodeClass;
         identifier: string;
@@ -28,6 +28,13 @@ export declare class RegistrarBuilder<_ReturnTypes> {
         fromNodeClass: AbstractNodeClass;
         getToNode: (from: DependencyNode) => DependencyNode;
     }[];
+    protected getEntrypoints: (node: DependencyNode) => DependencyNode[];
+    constructor();
+    addNamedHandler<Node extends DependencyNode, Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>>(node: DependencyNode, fn: Function): RegistrarBuilder<_ReturnTypes & {
+        ["namedHandlers"]: {
+            [nodeName: string]: Awaited<ReturnType<Function>>;
+        };
+    }>;
     /**
      * Add a function fn to be called on all nodes of class
      * @param nodeClass
@@ -51,6 +58,11 @@ export declare class RegistrarBuilder<_ReturnTypes> {
      * @param getToNode method that returns the *to* part of the alias
      */
     addClassAlias<FromNodeClass extends AbstractNodeClass>(fromNodeClass: FromNodeClass, getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode): this;
+    /**
+     * Set a custom entrypoint getter function. By default, the entrypoint getter
+     * returns the node passed in as the sole entrypoint.
+     */
+    setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]): this;
     /**
      * Add a default function fn to be used on nodes whose types do not have handlers.
      * If this is not set, the default behaviour will be to throw

package/dist/registrarBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,KAAK,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AACxD,KAAK,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;;IAS7F,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC1E,EAAE,CAAM;IAET,SAAS,CAAC,YAAY,EAAE;QACpB,aAAa,EAAE,iBAAiB,CAAC;QACjC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;KACvD,EAAE,CAAM;IAET;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG,EACtF,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAmBxC,EAAE;;;IAoCvB;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,aAAa,SAAS,iBAAiB,EACxD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,cAAc;IAuChF;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG;IAKxE,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CA8B1C;AAED,eAAO,MAAM,0BAA0B,GACnC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAE1D,GAAG,YAAY,CAAC,kBAGX,CAAC,6DAA6D,IAAI,mFAET,GAAG,oBAgBpE,CAAC"}
+{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,KAAK,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AACxD,KAAK,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7F,SAAS,CAAC,aAAa,EAAE,MAAM,CAC3B,MAAM,EACN,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CACrE,CAAM;IAEP,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC1E,EAAE,CAAM;IAET,SAAS,CAAC,YAAY,EAAE;QACpB,aAAa,EAAE,iBAAiB,CAAC;QACjC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;KACvD,EAAE,CAAM;IAET,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,EAAE,CAAoB;;IAUjF,eAAe,CAClB,IAAI,SAAS,cAAc,EAC3B,QAAQ,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC3E,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,GAUjB,gBAAgB,CAC3B,YAAY,GAAG;QACX,CAAC,eAAe,CAAC,EAAE;YAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;SAAE,CAAC;KAC5E,CACJ;IAGL;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG,EACtF,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAmBxC,EAAE;;;IAoCvB;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,aAAa,SAAS,iBAAiB,EACxD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,cAAc;IAuChF;;;OAGG;IACI,oBAAoB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,EAAE;IAK1E;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG;IAKxE,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CAkE1C;AAED,eAAO,MAAM,0BAA0B,GACnC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAE1D,GAAG,YAAY,CAAC,kBAGX,CAAC,6DAA6D,IAAI,mFAET,GAAG,oBAgBpE,CAAC"}

package/dist/registrarBuilder.js

@@ -1,4 +1,4 @@
-export { RegistrarBuilder, multiplexOrderedRegistrars } from './4DUQS2FO.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './H6QNIXMU.js';
 import './VUOMXK5T.js';
 //# sourceMappingURL=registrarBuilder.js.map
 //# sourceMappingURL=registrarBuilder.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/base-definitions",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -15,16 +15,16 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "zod": "3.25.56",
-    "@layerzerolabs/common-utils": "0.2.5",
-    "@layerzerolabs/dependency-graph": "0.2.5",
-    "@layerzerolabs/typescript-utils": "0.2.5",
-    "@layerzerolabs/dfs": "0.2.5"
+    "@layerzerolabs/common-utils": "0.2.7",
+    "@layerzerolabs/dependency-graph": "0.2.7",
+    "@layerzerolabs/dfs": "0.2.7",
+    "@layerzerolabs/typescript-utils": "0.2.7"
   },
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.3",
-    "@layerzerolabs/tsup-configuration": "0.2.5",
-    "@layerzerolabs/typescript-configuration": "0.2.5"
+    "@layerzerolabs/tsup-configuration": "0.2.7",
+    "@layerzerolabs/typescript-configuration": "0.2.7"
   },
   "publishConfig": {
     "access": "restricted",

package/src/registrarBuilder.ts

@@ -1,4 +1,5 @@
-import type { DependencyNode } from '@layerzerolabs/dependency-graph';
+import type { Dependencies } from '@layerzerolabs/dependency-graph';
+import { DependencyNode } from '@layerzerolabs/dependency-graph';
 import type { Registrar } from '@layerzerolabs/dfs';
 import { dfs } from '@layerzerolabs/dfs';
 export type { Registrar };
@@ -21,13 +22,11 @@ type AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;
  */
 export class RegistrarBuilder<_ReturnTypes> {
     protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;
-    constructor() {
-        this.defaultHandler = async (node: DependencyNode) => {
-            throw new Error(
-                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,
-            );
-        };
-    }
+
+    protected namedHandlers: Record<
+        string,
+        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>
+    > = {};
 
     protected classHandlers: {
         nodeClass: AbstractNodeClass;
@@ -40,6 +39,36 @@ export class RegistrarBuilder<_ReturnTypes> {
         getToNode: (from: DependencyNode) => DependencyNode;
     }[] = [];
 
+    protected getEntrypoints: (node: DependencyNode) => DependencyNode[] = (node) => [node];
+
+    constructor() {
+        this.defaultHandler = async (node: DependencyNode) => {
+            throw new Error(
+                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,
+            );
+        };
+    }
+
+    public addNamedHandler<
+        Node extends DependencyNode,
+        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,
+    >(node: DependencyNode, fn: Function) {
+        if (this.namedHandlers[node.name]) {
+            throw new Error(
+                `Cannot define a named handler for an identifier that already has a handler: ${node.name}`,
+            );
+        }
+        this.namedHandlers[node.name] = fn as unknown as (
+            node: DependencyNode,
+            ancestry: DependencyNode[],
+        ) => Promise<any>;
+        return this as RegistrarBuilder<
+            _ReturnTypes & {
+                ['namedHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };
+            }
+        >;
+    }
+
     /**
      * Add a function fn to be called on all nodes of class
      * @param nodeClass
@@ -159,6 +188,15 @@ export class RegistrarBuilder<_ReturnTypes> {
         return this;
     }
 
+    /**
+     * Set a custom entrypoint getter function. By default, the entrypoint getter
+     * returns the node passed in as the sole entrypoint.
+     */
+    public setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]) {
+        this.getEntrypoints = fn;
+        return this;
+    }
+
     /**
      * Add a default function fn to be used on nodes whose types do not have handlers.
      * If this is not set, the default behaviour will be to throw
@@ -180,6 +218,21 @@ export class RegistrarBuilder<_ReturnTypes> {
         };
 
         const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {
+            if (node.name === '_virtualEntrypoint') {
+                return {
+                    key: node.name,
+                    value: undefined,
+                };
+            }
+
+            const namedHandler = this.namedHandlers[node.name];
+            if (namedHandler) {
+                return {
+                    key: node.name,
+                    value: await namedHandler(node, ancestry),
+                };
+            }
+
             for (const { nodeClass, identifier, fn } of this.classHandlers) {
                 if (node instanceof nodeClass) {
                     return {
@@ -195,8 +248,29 @@ export class RegistrarBuilder<_ReturnTypes> {
             };
         };
         return {
-            traverseDependencies: async (node: DependencyNode) =>
-                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),
+            traverseDependencies: async (node: DependencyNode) => {
+                const entrypoints = this.getEntrypoints(node);
+                if (entrypoints.length === 1)
+                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();
+
+                const dependencies = entrypoints.reduce((acc, cur) => {
+                    acc[cur.name] = cur;
+                    return acc;
+                }, {} as Dependencies);
+
+                class VirtualNode extends DependencyNode {}
+
+                const virtualEntrypoint = new VirtualNode({
+                    name: '_virtualEntrypoint',
+                    dependencies,
+                });
+
+                return await dfs<_ReturnTypes>(
+                    virtualEntrypoint,
+                    mergedNodeHandler,
+                    mergedNodePrehandler,
+                )();
+            },
         };
     }
 }

package/test/registrarBuilder.test.ts

@@ -120,3 +120,56 @@ describe('Registrar builder', () => {
         });
     });
 });
+
+describe('Named handlers', () => {
+    test('Named handlers should take priority over class handlers', async () => {
+        let classHandlerCalled = false;
+        let namedHandlerCalled = false;
+
+        const builder = new RegistrarBuilder()
+            .addClassHandler(SimpleClassA, 'simpleA', async () => {
+                classHandlerCalled = true;
+                return 'from-class';
+            })
+            .addNamedHandler(mySimpleClassA1, async () => {
+                namedHandlerCalled = true;
+                return 'from-named';
+            })
+            .build();
+
+        await builder.traverseDependencies(mySimpleClassA1);
+
+        expect(namedHandlerCalled).toBe(true);
+        expect(classHandlerCalled).toBe(false);
+    });
+
+    test('Named handlers should be invoked with correct arguments and return values', async () => {
+        let receivedNode: DependencyNode | undefined;
+        let receivedAncestry: DependencyNode[] | undefined;
+
+        const builder = new RegistrarBuilder()
+            .addNamedHandler(mySimpleClassA1, async (node, ancestry) => {
+                receivedNode = node;
+                receivedAncestry = ancestry;
+                return 'named-result';
+            })
+            .build();
+
+        const result = await builder.traverseDependencies(mySimpleClassA1);
+
+        expect(receivedNode).toBe(mySimpleClassA1);
+        expect(receivedAncestry).toStrictEqual([]);
+        // Result is grouped by handler identifier (node name for named handlers)
+        expect(result).toStrictEqual({ MySimpleClassA: { MySimpleClassA: 'named-result' } });
+    });
+
+    test('Registering duplicate named handlers should throw', () => {
+        expect(() => {
+            new RegistrarBuilder()
+                .addNamedHandler(mySimpleClassA1, async () => 'first')
+                .addNamedHandler(mySimpleClassA1, async () => 'second');
+        }).toThrow(
+            'Cannot define a named handler for an identifier that already has a handler: MySimpleClassA',
+        );
+    });
+});

package/dist/4DUQS2FO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","node","Error","JSON","stringify","classHandlers","classAliases","addClassHandler","nodeClass","identifier","fn","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","ancestry","key","value","traverseDependencies","dfs","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","acc","name","registrar","result"],"mappings":"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","file":"4DUQS2FO.js","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\n    }[] = [];\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>, ancestry: DependencyNode[]) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n        });\n\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/O7HENH25.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","node","Error","JSON","stringify","classHandlers","classAliases","addClassHandler","nodeClass","identifier","fn","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","__name","ancestry","key","value","traverseDependencies","dfs","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","acc","name","registrar","result"],"mappings":"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","file":"O7HENH25.cjs","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\n    }[] = [];\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>, ancestry: DependencyNode[]) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n        });\n\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}