lanka 2.0.0 → 2.1.0

package/dist/chunk-24MUFFHF.js

@@ -0,0 +1,43 @@
+import {
+  findExportedClass
+} from "./chunk-JZJ6GXX3.js";
+import {
+  ALankaLocator
+} from "./chunk-N3275IPH.js";
+
+// src/locator/singleton/lanka-singleton-locator/LankaSingletonLocator.ts
+import * as SingletonsModule from "@lanka_di/Singletons";
+var LankaSingletonLocator = class extends ALankaLocator {
+  singletonIndexModule;
+  constructor(config) {
+    super({
+      findClassByName: (className) => {
+        return findExportedClass(SingletonsModule, className) ?? (this.singletonIndexModule ? findExportedClass(this.singletonIndexModule, className) : void 0);
+      },
+      createInstance: (Class) => {
+        return new Class();
+      },
+      notFoundError: (className, propertyName) => `Singleton "${className}" (accessed as "${propertyName}") not found. Make sure the class is exported from @lanka_di/Singletons.ts or registered via registerSingleton method.`
+    });
+    this.singletonIndexModule = config?.singletonIndexModule;
+  }
+  /**
+   * Creates a NEW service object, bypassing the locator's cache.
+   *
+   * For scopes: they take the class from here and set the lifetime themselves.
+   * The root cache is untouched — otherwise the first resolution inside a scope
+   * would replace the application's root object.
+   */
+  createScopedInstance(className, propertyName) {
+    const Class = this.classFor(className);
+    if (!Class) {
+      throw new Error(this.config.notFoundError(className, propertyName));
+    }
+    return this.config.createInstance(Class);
+  }
+};
+
+export {
+  LankaSingletonLocator
+};
+//# sourceMappingURL=chunk-24MUFFHF.js.map

package/dist/chunk-24MUFFHF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/singleton/lanka-singleton-locator/LankaSingletonLocator.ts"],"sourcesContent":["import { ALankaLocator } from \"../../_abstractions/lanka-locator/ALankaLocator\";\nimport { findExportedClass } from \"../../_internal/find-exported-class/findExportedClass\";\n/**\n * Classes come from the consumer's barrel.\n *\n * Adding one is ONE export line: types are inferred, autocomplete works, and no\n * list has to be maintained. A list maintained by hand is a list that eventually\n * falls behind the code.\n */\nimport * as SingletonsModule from \"@lanka_di/Singletons\";\n\n/**\n * LankaSingletonLocator configuration.\n */\nexport interface ILankaSingletonLocatorConfig {\n\t/** The module holding singleton classes — the consumer's barrel. */\n\tsingletonIndexModule?: Record<string, unknown>;\n}\n\n/**\n * Resolves singletons by property name (camelCase) or class name (PascalCase),\n * constructing them on first use and caching them.\n *\n * A class arrives either from the consumer's barrel or registered by hand — the\n * latter for tests and for objects that arrive already built.\n */\nexport class LankaSingletonLocator extends ALankaLocator<unknown> {\n\tprivate readonly singletonIndexModule?: Record<string, unknown>;\n\n\tconstructor(config?: ILankaSingletonLocatorConfig) {\n\t\tsuper({\n\t\t\tfindClassByName: (className: string) => {\n\t\t\t\t// Order: the application's barrel, then an extra module if one was\n\t\t\t\t// given. Hand-registered classes are read by `ALankaLocator` itself,\n\t\t\t\t// ahead of this callback — they used to be read here, and the copy is\n\t\t\t\t// what let the gateway and scenario locators forget them entirely.\n\t\t\t\t//\n\t\t\t\t// Each source is checked ONCE, by export key. A fallback pass over\n\t\t\t\t// `Class.name` looks for something a built bundle no longer has:\n\t\t\t\t// minification loses class names exactly as it loses export names.\n\t\t\t\treturn (\n\t\t\t\t\tfindExportedClass<unknown>(SingletonsModule, className) ??\n\t\t\t\t\t(this.singletonIndexModule\n\t\t\t\t\t\t? findExportedClass<unknown>(this.singletonIndexModule, className)\n\t\t\t\t\t\t: undefined)\n\t\t\t\t);\n\t\t\t},\n\t\t\tcreateInstance: (Class) => {\n\t\t\t\treturn new Class();\n\t\t\t},\n\t\t\tnotFoundError: (className, propertyName) =>\n\t\t\t\t`Singleton \"${className}\" (accessed as \"${propertyName}\") not found. ` +\n\t\t\t\t`Make sure the class is exported from @lanka_di/Singletons.ts or registered via registerSingleton method.`,\n\t\t});\n\n\t\tthis.singletonIndexModule = config?.singletonIndexModule;\n\t}\n\n\t/**\n\t * Creates a NEW service object, bypassing the locator's cache.\n\t *\n\t * For scopes: they take the class from here and set the lifetime themselves.\n\t * The root cache is untouched — otherwise the first resolution inside a scope\n\t * would replace the application's root object.\n\t */\n\tpublic createScopedInstance(className: string, propertyName: string): unknown {\n\t\t// `classFor`, not `config.findClassByName`: a hand-registered class must\n\t\t// resolve inside a scope exactly as it does at the root.\n\t\tconst Class = this.classFor(className);\n\t\tif (!Class) {\n\t\t\tthrow new Error(this.config.notFoundError(className, propertyName));\n\t\t}\n\t\treturn this.config.createInstance(Class);\n\t}\n}\n"],"mappings":";;;;;;;;AASA,YAAY,sBAAsB;AAiB3B,IAAM,wBAAN,cAAoC,cAAuB;AAAA,EAChD;AAAA,EAEjB,YAAY,QAAuC;AAClD,UAAM;AAAA,MACL,iBAAiB,CAAC,cAAsB;AASvC,eACC,kBAA2B,kBAAkB,SAAS,MACrD,KAAK,uBACH,kBAA2B,KAAK,sBAAsB,SAAS,IAC/D;AAAA,MAEL;AAAA,MACA,gBAAgB,CAAC,UAAU;AAC1B,eAAO,IAAI,MAAM;AAAA,MAClB;AAAA,MACA,eAAe,CAAC,WAAW,iBAC1B,cAAc,SAAS,mBAAmB,YAAY;AAAA,IAExD,CAAC;AAED,SAAK,uBAAuB,QAAQ;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,qBAAqB,WAAmB,cAA+B;AAG7E,UAAM,QAAQ,KAAK,SAAS,SAAS;AACrC,QAAI,CAAC,OAAO;AACX,YAAM,IAAI,MAAM,KAAK,OAAO,cAAc,WAAW,YAAY,CAAC;AAAA,IACnE;AACA,WAAO,KAAK,OAAO,eAAe,KAAK;AAAA,EACxC;AACD;","names":[]}

package/dist/chunk-3R2NO47A.js

@@ -0,0 +1,35 @@
+import {
+  findExportedClass
+} from "./chunk-JZJ6GXX3.js";
+import {
+  ALankaLocator
+} from "./chunk-N3275IPH.js";
+
+// src/locator/shared-store/lanka-shared-store-locator/LankaSharedStoreLocator.ts
+import * as SharedStoresModule from "@lanka_di/SharedStores";
+var LankaSharedStoreLocator = class extends ALankaLocator {
+  sharedStoreIndexModule;
+  constructor(config) {
+    super({
+      findClassByName: (className) => {
+        return findExportedClass(
+          SharedStoresModule,
+          className
+        ) ?? (this.sharedStoreIndexModule ? findExportedClass(
+          this.sharedStoreIndexModule,
+          className
+        ) : void 0);
+      },
+      createInstance: (Class) => {
+        return new Class();
+      },
+      notFoundError: (className, propertyName) => `SharedStore "${className}" (accessed as "${propertyName}") not found. Make sure the class extends ALankaSharedStore and is exported from @lanka_di/SharedStores.ts or registered via registerSharedStore method.`
+    });
+    this.sharedStoreIndexModule = config?.sharedStoreIndexModule;
+  }
+};
+
+export {
+  LankaSharedStoreLocator
+};
+//# sourceMappingURL=chunk-3R2NO47A.js.map

package/dist/chunk-3R2NO47A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/shared-store/lanka-shared-store-locator/LankaSharedStoreLocator.ts"],"sourcesContent":["import { ALankaLocator } from \"../../_abstractions/lanka-locator/ALankaLocator\";\nimport { findExportedClass } from \"../../_internal/find-exported-class/findExportedClass\";\nimport { ALankaSharedStore } from \"../../../viewmodel/_abstractions/lanka-shared-store/ALankaSharedStore\";\nimport * as SharedStoresModule from \"@lanka_di/SharedStores\";\n\ntype TSharedStoreState = object;\n\n/**\n * LankaSharedStoreLocator configuration.\n */\nexport interface ILankaSharedStoreLocatorConfig {\n\t/** The module holding shared store classes — the consumer's barrel. */\n\tsharedStoreIndexModule?: Record<string, unknown>;\n}\n\n/**\n * Resolves shared stores by property name (camelCase) or class name\n * (PascalCase), constructing them on first use and caching them.\n */\nexport class LankaSharedStoreLocator extends ALankaLocator<ALankaSharedStore<TSharedStoreState>> {\n\tprivate readonly sharedStoreIndexModule?: Record<string, unknown>;\n\n\tconstructor(config?: ILankaSharedStoreLocatorConfig) {\n\t\tsuper({\n\t\t\tfindClassByName: (className: string) => {\n\t\t\t\t// Hand-registered classes are read by `ALankaLocator` itself, ahead of\n\t\t\t\t// this callback. This is only the barrel.\n\t\t\t\treturn (\n\t\t\t\t\tfindExportedClass<ALankaSharedStore<TSharedStoreState>>(\n\t\t\t\t\t\tSharedStoresModule,\n\t\t\t\t\t\tclassName,\n\t\t\t\t\t) ??\n\t\t\t\t\t(this.sharedStoreIndexModule\n\t\t\t\t\t\t? findExportedClass<ALankaSharedStore<TSharedStoreState>>(\n\t\t\t\t\t\t\t\tthis.sharedStoreIndexModule,\n\t\t\t\t\t\t\t\tclassName,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: undefined)\n\t\t\t\t);\n\t\t\t},\n\t\t\tcreateInstance: (Class) => {\n\t\t\t\treturn new Class();\n\t\t\t},\n\t\t\tnotFoundError: (className, propertyName) =>\n\t\t\t\t`SharedStore \"${className}\" (accessed as \"${propertyName}\") not found. ` +\n\t\t\t\t`Make sure the class extends ALankaSharedStore and is exported from @lanka_di/SharedStores.ts ` +\n\t\t\t\t`or registered via registerSharedStore method.`,\n\t\t});\n\n\t\tthis.sharedStoreIndexModule = config?.sharedStoreIndexModule;\n\t}\n}\n"],"mappings":";;;;;;;;AAGA,YAAY,wBAAwB;AAgB7B,IAAM,0BAAN,cAAsC,cAAoD;AAAA,EAC/E;AAAA,EAEjB,YAAY,QAAyC;AACpD,UAAM;AAAA,MACL,iBAAiB,CAAC,cAAsB;AAGvC,eACC;AAAA,UACC;AAAA,UACA;AAAA,QACD,MACC,KAAK,yBACH;AAAA,UACA,KAAK;AAAA,UACL;AAAA,QACD,IACC;AAAA,MAEL;AAAA,MACA,gBAAgB,CAAC,UAAU;AAC1B,eAAO,IAAI,MAAM;AAAA,MAClB;AAAA,MACA,eAAe,CAAC,WAAW,iBAC1B,gBAAgB,SAAS,mBAAmB,YAAY;AAAA,IAG1D,CAAC;AAED,SAAK,yBAAyB,QAAQ;AAAA,EACvC;AACD;","names":[]}

package/dist/{chunk-UMPSR4US.js → chunk-42CWYVZJ.js}

@@ -1,26 +1,10 @@
 import {
   ALankaScenario,
   LankaScenariosRegistry
-} from "./chunk-EYDMBI5T.js";
+} from "./chunk-NWEHOMTS.js";
 import {
-  ALankaLocator,
-  caseConvert,
-  findExportedClass
-} from "./chunk-UE2C76OR.js";
-import {
-  lankaLogger
-} from "./chunk-FII3PW2G.js";
-
-// src/locator/gateway/lanka-gateway-locator/LankaGatewayLocator.ts
-import * as GatewaysModule from "@lanka_di/Gateways";
-var LankaGatewayLocator = class extends ALankaLocator {
-  constructor() {
-    super({
-      findClassByName: (gatewayName) => findExportedClass(GatewaysModule, gatewayName),
-      notFoundError: (gatewayName, propertyName) => `Gateway "${gatewayName}" (accessed as "${propertyName}") not found. Make sure the gateway class extends ALankaGateway and is exported from lankaGateways.ts.`
-    });
-  }
-};
+  ALankaLocator
+} from "./chunk-N3275IPH.js";
 
 // src/locator/scenario/lanka-scenario-locator/LankaScenarioLocator.ts
 import * as ScenariosModule from "@lanka_di/Scenarios";
@@ -54,6 +38,45 @@ var LankaScenarioLocator = class extends ALankaLocator {
   get registry() {
     return LankaScenariosRegistry.getInstance();
   }
+  /**
+   * Every constructible class the consumer's barrel exports.
+   *
+   * Published so that this file stays the ONE module in the framework that reads
+   * `@lanka_di/Scenarios`. `LankaScenarioBootstrap` used to read it too, and
+   * that second reader is what made `lanka/scenario` — the entry a consumer's
+   * scenario class imports `ALankaScenario` from — part of the import cycle the
+   * inversion creates. A bundler is free to order the chunks behind that entry
+   * however it likes, and when it put the barrel first the consumer's class
+   * extended `undefined`. `lanka/locator` carries the cycle instead, and no
+   * scenario class imports it.
+   *
+   * Not a filter on "is a scenario": an export that is not a function has no
+   * chance of being one, and anything further is decided by CONSTRUCTING it,
+   * which is the caller's job and the only honest test.
+   *
+   * ## Why the values are widened to `unknown` first
+   *
+   * A type predicate has to be assignable to the type it narrows, and the type
+   * of what this reads is the CONSUMER'S — whatever their `Scenarios` barrel
+   * happens to export. A real scenario class is `typeof TheirScenario`, which
+   * carries the statics `ALankaScenario` declares, and `new () => ILankaScenario`
+   * has none of them: the predicate is not assignable to it, and the file does
+   * not compile in any project whose barrel has a scenario in it.
+   *
+   * It compiled here for one reason: this repository's fixture barrel says
+   * `export {}`, so `Object.values` is `never[]` and every predicate is
+   * vacuously assignable. `_playgrounds/node` is where it failed, because that
+   * is a barrel with a real class in it — the same blind spot, in the same
+   * shape, as the empty probe barrels that let the 2.0.0 chunk cycle ship.
+   *
+   * `unknown` is also what this honestly knows. The framework cannot see a
+   * consumer's types; it sees exports and asks whether each is a function.
+   */
+  getDeclaredScenarioClasses() {
+    return Object.values(ScenariosModule).filter(
+      (exported) => typeof exported === "function"
+    );
+  }
   constructor() {
     super({
       findClassByName: (scenarioName) => {
@@ -93,47 +116,7 @@ var LankaScenarioLocator = class extends ALankaLocator {
   }
 };
 
-// src/locator/_factories/create-lanka-scope/createLankaScope.ts
-function createLankaScope(singletons) {
-  const instances = /* @__PURE__ */ new Map();
-  let disposed = false;
-  return {
-    resolve(propertyName) {
-      if (disposed) {
-        throw new Error(
-          `The scope is closed: "${propertyName}" can no longer be resolved in it. This is usually a scope reference that outlived the screen that created it.`
-        );
-      }
-      const className = caseConvert(propertyName, "pascalCase");
-      if (instances.has(className)) return instances.get(className);
-      const instance = singletons.createScopedInstance(className, propertyName);
-      instances.set(className, instance);
-      return instance;
-    },
-    dispose() {
-      if (disposed) return;
-      disposed = true;
-      for (const [name, instance] of instances) {
-        const disposable = instance;
-        if (typeof disposable.dispose !== "function") continue;
-        try {
-          disposable.dispose();
-        } catch (error) {
-          lankaLogger.printBootstrapLog(
-            `Failed to dispose "${name}" in the scope`,
-            error instanceof Error ? error.message : String(error)
-          );
-        }
-      }
-      instances.clear();
-    },
-    isDisposed: () => disposed
-  };
-}
-
 export {
-  LankaGatewayLocator,
-  LankaScenarioLocator,
-  createLankaScope
+  LankaScenarioLocator
 };
-//# sourceMappingURL=chunk-UMPSR4US.js.map
+//# sourceMappingURL=chunk-42CWYVZJ.js.map

package/dist/chunk-42CWYVZJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/scenario/lanka-scenario-locator/LankaScenarioLocator.ts"],"sourcesContent":["import { LankaScenariosRegistry } from \"../../../scenario/_registries/lanka-scenarios-registry/LankaScenariosRegistry\";\nimport { ILankaScenario } from \"../../../scenario/_interfaces/ILankaScenario\";\nimport { ALankaScenario } from \"../../../scenario/_abstractions/lanka-scenario/ALankaScenario\";\nimport { ALankaLocator } from \"../../_abstractions/lanka-locator/ALankaLocator\";\n/**\n * Classes come from the consumer's barrel.\n *\n * Adding one is ONE export line: types are inferred, autocomplete works, and no\n * list has to be maintained.\n */\nimport * as ScenariosModule from \"@lanka_di/Scenarios\";\n\n/**\n * The barrel's class whose INSTANCE carries this name, when the export key does\n * not.\n *\n * A pooled instance answers for its class without constructing another: the\n * pool is never drained, so a lookup that constructed every class on every miss\n * grew it by the whole barrel each time a bad name was asked for. Only a class\n * the pool has never seen is constructed here — once, and it joins the pool.\n */\nconst findScenarioClassByInstanceName = (\n\tscenarioName: string,\n): (new () => ILankaScenario<unknown>) | undefined => {\n\tconst pooled = ALankaScenario.getAutoRegisteredScenarios();\n\n\tfor (const value of Object.values(ScenariosModule)) {\n\t\tif (typeof value !== \"function\" || !value.prototype) continue;\n\n\t\tconst Class = value as new () => ALankaScenario<unknown>;\n\t\tconst instance =\n\t\t\tpooled.find((scenario) => scenario.constructor === Class) ?? construct(Class);\n\t\tif (instance?.name === scenarioName) return Class;\n\t}\n\n\treturn undefined;\n};\n\n/** A new instance, or `undefined` for an export that is not constructible. */\nconst construct = (\n\tClass: new () => ALankaScenario<unknown>,\n): ALankaScenario<unknown> | undefined => {\n\ttry {\n\t\treturn new Class();\n\t} catch {\n\t\treturn undefined;\n\t}\n};\n\n/**\n * Resolves scenarios by property name (camelCase) or scenario name\n * (PascalCase).\n *\n * Looks in the registry, then in the self-registration pool, and failing both\n * constructs the scenario from the consumer's barrel on first use.\n */\nexport class LankaScenarioLocator extends ALankaLocator<ILankaScenario<unknown>> {\n\t/**\n\t * The registry is read LAZILY rather than in a field initialiser.\n\t *\n\t * The locator is constructed INSIDE `createLanka`, before the instance becomes\n\t * active. A field initialiser would ask for the active instance at that moment\n\t * and fail with \"no instance yet\" while the instance being created is on the\n\t * stack. Deferred reading resolves it: by the first scenario resolution an\n\t * active instance exists.\n\t */\n\tprivate get registry(): LankaScenariosRegistry {\n\t\treturn LankaScenariosRegistry.getInstance();\n\t}\n\n\t/**\n\t * Every constructible class the consumer's barrel exports.\n\t *\n\t * Published so that this file stays the ONE module in the framework that reads\n\t * `@lanka_di/Scenarios`. `LankaScenarioBootstrap` used to read it too, and\n\t * that second reader is what made `lanka/scenario` — the entry a consumer's\n\t * scenario class imports `ALankaScenario` from — part of the import cycle the\n\t * inversion creates. A bundler is free to order the chunks behind that entry\n\t * however it likes, and when it put the barrel first the consumer's class\n\t * extended `undefined`. `lanka/locator` carries the cycle instead, and no\n\t * scenario class imports it.\n\t *\n\t * Not a filter on \"is a scenario\": an export that is not a function has no\n\t * chance of being one, and anything further is decided by CONSTRUCTING it,\n\t * which is the caller's job and the only honest test.\n\t *\n\t * ## Why the values are widened to `unknown` first\n\t *\n\t * A type predicate has to be assignable to the type it narrows, and the type\n\t * of what this reads is the CONSUMER'S — whatever their `Scenarios` barrel\n\t * happens to export. A real scenario class is `typeof TheirScenario`, which\n\t * carries the statics `ALankaScenario` declares, and `new () => ILankaScenario`\n\t * has none of them: the predicate is not assignable to it, and the file does\n\t * not compile in any project whose barrel has a scenario in it.\n\t *\n\t * It compiled here for one reason: this repository's fixture barrel says\n\t * `export {}`, so `Object.values` is `never[]` and every predicate is\n\t * vacuously assignable. `_playgrounds/node` is where it failed, because that\n\t * is a barrel with a real class in it — the same blind spot, in the same\n\t * shape, as the empty probe barrels that let the 2.0.0 chunk cycle ship.\n\t *\n\t * `unknown` is also what this honestly knows. The framework cannot see a\n\t * consumer's types; it sees exports and asks whether each is a function.\n\t */\n\tpublic getDeclaredScenarioClasses(): readonly (new () => ILankaScenario<unknown>)[] {\n\t\treturn (Object.values(ScenariosModule) as readonly unknown[]).filter(\n\t\t\t(exported): exported is new () => ILankaScenario<unknown> =>\n\t\t\t\ttypeof exported === \"function\",\n\t\t);\n\t}\n\n\tconstructor() {\n\t\tsuper({\n\t\t\tfindClassByName: (scenarioName: string) => {\n\t\t\t\t// By export key first: an instance name does not always survive minification.\n\t\t\t\tif (scenarioName in ScenariosModule) {\n\t\t\t\t\t// `as unknown` before the guards, exactly as in the singleton locator.\n\t\t\t\t\t// An EMPTY barrel — what the scaffolder writes, and what a new project\n\t\t\t\t\t// has until its first scenario — makes the module's keys `never`, so\n\t\t\t\t\t// an indexed access is `never` and reading `.prototype` off it does\n\t\t\t\t\t// not compile.\n\t\t\t\t\tconst ScenarioClass = ScenariosModule[\n\t\t\t\t\t\tscenarioName as keyof typeof ScenariosModule\n\t\t\t\t\t] as unknown;\n\t\t\t\t\tif (\n\t\t\t\t\t\ttypeof ScenarioClass === \"function\" &&\n\t\t\t\t\t\t\"prototype\" in ScenarioClass &&\n\t\t\t\t\t\tScenarioClass.prototype\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn ScenarioClass as new () => ILankaScenario<unknown>;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t// Fallback: look up by instance name.\n\t\t\t\treturn findScenarioClassByInstanceName(scenarioName);\n\t\t\t},\n\t\t\tgetInstanceByName: (scenarioName: string) => {\n\t\t\t\t// The registry first.\n\t\t\t\tconst registered = this.registry.getScenarioByName(scenarioName);\n\t\t\t\tif (registered) {\n\t\t\t\t\treturn registered;\n\t\t\t\t}\n\n\t\t\t\t// Then those that registered themselves.\n\t\t\t\tconst autoRegistered = ALankaScenario.getAutoRegisteredScenarios();\n\t\t\t\tconst scenario = autoRegistered.find((s) => s.name === scenarioName);\n\n\t\t\t\tif (scenario) {\n\t\t\t\t\tif (!this.registry.isRegistered(scenarioName)) {\n\t\t\t\t\t\tthis.registry.register(scenario);\n\t\t\t\t\t}\n\t\t\t\t\treturn scenario;\n\t\t\t\t}\n\n\t\t\t\t// Then finding the class by name and constructing it.\n\t\t\t\treturn undefined;\n\t\t\t},\n\t\t\tcreateInstance: (ScenarioClass) => {\n\t\t\t\tconst instance = new ScenarioClass();\n\t\t\t\tconst scenarioName = instance.name;\n\t\t\t\tif (!this.registry.isRegistered(scenarioName)) {\n\t\t\t\t\tthis.registry.register(instance);\n\t\t\t\t}\n\t\t\t\treturn instance;\n\t\t\t},\n\t\t\tnotFoundError: (scenarioName, propertyName) =>\n\t\t\t\t`Scenario \"${scenarioName}\" (accessed as \"${propertyName}\") not found. ` +\n\t\t\t\t`Make sure the scenario class extends ALankaScenario and has name=\"${scenarioName}\".`,\n\t\t});\n\t}\n}\n"],"mappings":";;;;;;;;;AAUA,YAAY,qBAAqB;AAWjC,IAAM,kCAAkC,CACvC,iBACqD;AACrD,QAAM,SAAS,eAAe,2BAA2B;AAEzD,aAAW,SAAS,OAAO,OAAO,eAAe,GAAG;AACnD,QAAI,OAAO,UAAU,cAAc,CAAC,MAAM,UAAW;AAErD,UAAM,QAAQ;AACd,UAAM,WACL,OAAO,KAAK,CAAC,aAAa,SAAS,gBAAgB,KAAK,KAAK,UAAU,KAAK;AAC7E,QAAI,UAAU,SAAS,aAAc,QAAO;AAAA,EAC7C;AAEA,SAAO;AACR;AAGA,IAAM,YAAY,CACjB,UACyC;AACzC,MAAI;AACH,WAAO,IAAI,MAAM;AAAA,EAClB,QAAQ;AACP,WAAO;AAAA,EACR;AACD;AASO,IAAM,uBAAN,cAAmC,cAAuC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUhF,IAAY,WAAmC;AAC9C,WAAO,uBAAuB,YAAY;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoCO,6BAA6E;AACnF,WAAQ,OAAO,OAAO,eAAe,EAAyB;AAAA,MAC7D,CAAC,aACA,OAAO,aAAa;AAAA,IACtB;AAAA,EACD;AAAA,EAEA,cAAc;AACb,UAAM;AAAA,MACL,iBAAiB,CAAC,iBAAyB;AAE1C,YAAI,gBAAgB,iBAAiB;AAMpC,gBAAM,gBAAgB,gBACrB,YACD;AACA,cACC,OAAO,kBAAkB,cACzB,eAAe,iBACf,cAAc,WACb;AACD,mBAAO;AAAA,UACR;AAAA,QACD;AAEA,eAAO,gCAAgC,YAAY;AAAA,MACpD;AAAA,MACA,mBAAmB,CAAC,iBAAyB;AAE5C,cAAM,aAAa,KAAK,SAAS,kBAAkB,YAAY;AAC/D,YAAI,YAAY;AACf,iBAAO;AAAA,QACR;AAGA,cAAM,iBAAiB,eAAe,2BAA2B;AACjE,cAAM,WAAW,eAAe,KAAK,CAAC,MAAM,EAAE,SAAS,YAAY;AAEnE,YAAI,UAAU;AACb,cAAI,CAAC,KAAK,SAAS,aAAa,YAAY,GAAG;AAC9C,iBAAK,SAAS,SAAS,QAAQ;AAAA,UAChC;AACA,iBAAO;AAAA,QACR;AAGA,eAAO;AAAA,MACR;AAAA,MACA,gBAAgB,CAAC,kBAAkB;AAClC,cAAM,WAAW,IAAI,cAAc;AACnC,cAAM,eAAe,SAAS;AAC9B,YAAI,CAAC,KAAK,SAAS,aAAa,YAAY,GAAG;AAC9C,eAAK,SAAS,SAAS,QAAQ;AAAA,QAChC;AACA,eAAO;AAAA,MACR;AAAA,MACA,eAAe,CAAC,cAAc,iBAC7B,aAAa,YAAY,mBAAmB,YAAY,mFACa,YAAY;AAAA,IACnF,CAAC;AAAA,EACF;AACD;","names":[]}

package/dist/chunk-BMF4TM2Z.js

@@ -0,0 +1,22 @@
+import {
+  findExportedClass
+} from "./chunk-JZJ6GXX3.js";
+import {
+  ALankaLocator
+} from "./chunk-N3275IPH.js";
+
+// src/locator/gateway/lanka-gateway-locator/LankaGatewayLocator.ts
+import * as GatewaysModule from "@lanka_di/Gateways";
+var LankaGatewayLocator = class extends ALankaLocator {
+  constructor() {
+    super({
+      findClassByName: (gatewayName) => findExportedClass(GatewaysModule, gatewayName),
+      notFoundError: (gatewayName, propertyName) => `Gateway "${gatewayName}" (accessed as "${propertyName}") not found. Make sure the gateway class extends ALankaGateway and is exported from lankaGateways.ts.`
+    });
+  }
+};
+
+export {
+  LankaGatewayLocator
+};
+//# sourceMappingURL=chunk-BMF4TM2Z.js.map

package/dist/chunk-BMF4TM2Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/gateway/lanka-gateway-locator/LankaGatewayLocator.ts"],"sourcesContent":["import * as GatewaysModule from \"@lanka_di/Gateways\";\nimport type { ALankaGateway } from \"../../../gateway/_abstractions/lanka-gateway/ALankaGateway\";\nimport { ALankaLocator } from \"../../_abstractions/lanka-locator/ALankaLocator\";\nimport { findExportedClass } from \"../../_internal/find-exported-class/findExportedClass\";\n\n/**\n * Resolves a gateway by property name (camelCase) or class name (PascalCase),\n * constructing it lazily and caching the instance.\n *\n * Adding a gateway takes one export line in `@lanka_di/Gateways`: types are\n * inferred and nothing is registered.\n */\nexport class LankaGatewayLocator extends ALankaLocator<ALankaGateway<unknown>> {\n\tconstructor() {\n\t\tsuper({\n\t\t\tfindClassByName: (gatewayName: string) =>\n\t\t\t\tfindExportedClass<ALankaGateway<unknown>>(GatewaysModule, gatewayName),\n\t\t\tnotFoundError: (gatewayName, propertyName) =>\n\t\t\t\t`Gateway \"${gatewayName}\" (accessed as \"${propertyName}\") not found. ` +\n\t\t\t\t`Make sure the gateway class extends ALankaGateway and is exported from lankaGateways.ts.`,\n\t\t});\n\t}\n}\n"],"mappings":";;;;;;;;AAAA,YAAY,oBAAoB;AAYzB,IAAM,sBAAN,cAAkC,cAAsC;AAAA,EAC9E,cAAc;AACb,UAAM;AAAA,MACL,iBAAiB,CAAC,gBACjB,kBAA0C,gBAAgB,WAAW;AAAA,MACtE,eAAe,CAAC,aAAa,iBAC5B,YAAY,WAAW,mBAAmB,YAAY;AAAA,IAExD,CAAC;AAAA,EACF;AACD;","names":[]}

package/dist/chunk-JZJ6GXX3.js

@@ -0,0 +1,12 @@
+// src/locator/_internal/find-exported-class/findExportedClass.ts
+function findExportedClass(module, exportName) {
+  if (!(exportName in module)) return void 0;
+  if (!Object.hasOwn(module, exportName)) return void 0;
+  const candidate = module[exportName];
+  return typeof candidate === "function" && candidate.prototype ? candidate : void 0;
+}
+
+export {
+  findExportedClass
+};
+//# sourceMappingURL=chunk-JZJ6GXX3.js.map

package/dist/chunk-JZJ6GXX3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/_internal/find-exported-class/findExportedClass.ts"],"sourcesContent":["/**\n * Finds a class in a module's ES namespace by name.\n *\n * An ES namespace is an ordinary object and `module[name]` is enough. Walking\n * `Reflect.ownKeys`, reading property descriptors and wrapping field access in\n * `try/catch` guards against what does not happen.\n *\n * ## Why a fallback pass over `Class.name` is worse than useless\n *\n * It is written for the case where the export name was lost to minification. But\n * `Class.name`.\n *\n * minification loses `Class.name` too — so the fallback looks for something a\n * built bundle no longer has, creating an impression of protection where there\n * is none.\n *\n * Resolution still works when the export name differs from the class name, which\n * `locator.contract.test.ts` pins: the lookup is by EXPORT KEY, and that is what\n * the consumer writes in the barrel.\n */\nexport function findExportedClass<TInstance>(\n\tmodule: object,\n\texportName: string,\n): (new () => TInstance) | undefined {\n\t// `in` first, then indexing. An ES namespace answers `undefined` for a missing\n\t// key, but a mocked module does not: vitest returns a proxy that THROWS on an\n\t// unknown key.\n\tif (!(exportName in module)) return undefined;\n\n\t// OWN properties only, and `in` alone was not enough. It walks the prototype\n\t// chain, so `\"constructor\" in module` is true for any plain object and\n\t// `module.constructor` is `Object` — a function WITH a prototype, which both\n\t// checks below accept. The locator would have handed back a class the barrel\n\t// never exported. `toString` and its siblings only escaped by luck: built-in\n\t// methods have no `.prototype`.\n\t//\n\t// It is asked SECOND, never first: `in` is what tolerates a vitest module\n\t// proxy, and this narrowing is only ever consulted for a key that already\n\t// exists. A real ES namespace has a null prototype, so nothing changes there.\n\tif (!Object.hasOwn(module, exportName)) return undefined;\n\n\tconst candidate = (module as Record<string, unknown>)[exportName];\n\n\t// `typeof === \"function\"` would also admit a plain function: it has a\n\t// `prototype` too. They cannot be told apart before calling, and that is a\n\t// deliberate boundary — the locator trusts the barrel, and `@lankajs/tool-di`\n\t// verifies the barrel.\n\treturn typeof candidate === \"function\" && candidate.prototype\n\t\t? (candidate as new () => TInstance)\n\t\t: undefined;\n}\n"],"mappings":";AAoBO,SAAS,kBACf,QACA,YACoC;AAIpC,MAAI,EAAE,cAAc,QAAS,QAAO;AAYpC,MAAI,CAAC,OAAO,OAAO,QAAQ,UAAU,EAAG,QAAO;AAE/C,QAAM,YAAa,OAAmC,UAAU;AAMhE,SAAO,OAAO,cAAc,cAAc,UAAU,YAChD,YACD;AACJ;","names":[]}

package/dist/{chunk-EYDMBI5T.js → chunk-MKKMTLOY.js}

@@ -1,3 +1,9 @@
+import {
+  ALankaScenario,
+  LankaScenarioVMRegistry,
+  LankaScenariosRegistry,
+  lankaEventBus
+} from "./chunk-NWEHOMTS.js";
 import {
   lankaLogger
 } from "./chunk-FII3PW2G.js";
@@ -6,309 +12,7 @@ import {
   requireActiveRuntime
 } from "./chunk-XGMXT4XZ.js";
 
-// src/scenario/event-bus/_facades/lanka-event-bus/lankaEventBus.ts
-var bus = () => requireActiveRuntime().eventBus;
-var lankaEventBus = Object.freeze({
-  enableLogs: () => {
-    bus().enableLogs();
-  },
-  disableLogs: () => {
-    bus().disableLogs();
-  },
-  registerEvent: (eventType, metadata) => {
-    bus().registerEvent(eventType, metadata);
-  },
-  getRegisteredEvents: () => bus().getRegisteredEvents(),
-  getEventInfo: (eventType) => bus().getEventInfo(eventType),
-  getSubscriptions: (eventType) => bus().getSubscriptions(eventType),
-  subscribe: (eventType, callback, options) => bus().subscribe(eventType, callback, options),
-  unsubscribe: (eventType, callback) => {
-    bus().unsubscribe(eventType, callback);
-  },
-  dispatch: (eventType, data, usedBy) => {
-    bus().dispatch(eventType, data, usedBy);
-  },
-  addMiddleware: (middleware) => {
-    bus().addMiddleware(middleware);
-  },
-  removeMiddleware: (middleware) => {
-    bus().removeMiddleware(middleware);
-  },
-  addObserver: (observer) => {
-    bus().addObserver(observer);
-  },
-  removeObserver: (observer) => {
-    bus().removeObserver(observer);
-  },
-  getEventLogs: (eventType, limit = 100) => bus().getEventLogs(eventType, limit),
-  clearEvent: (eventType) => {
-    bus().clearEvent(eventType);
-  },
-  clearAllEvents: () => {
-    bus().clearAllEvents();
-  },
-  reset: () => {
-    bus().reset();
-  }
-});
-
-// src/scenario/_registries/lanka-scenario-vm-registry/LankaScenarioVMRegistry.ts
-var LankaScenarioVMRegistry = class {
-  registeredViewModels = /* @__PURE__ */ new Set();
-  /**
-   * Public: the registry belongs to a framework instance rather than to the
-   * module.
-   */
-  constructor() {
-  }
-  /**
-   * The active instance's registry, for callers that cannot hold one — the
-   * static `LankaScenarioBootstrap`. Instance holders read `lanka.viewModels`.
-   */
-  static getInstance() {
-    return requireActiveRuntime().viewModels;
-  }
-  /** Whether this ViewModel is already registered. */
-  isRegistered(viewModel) {
-    return this.registeredViewModels.has(viewModel);
-  }
-  /**
-   * Registers a ViewModel.
-   *
-   * @returns `false` when it was already registered
-   */
-  register(viewModel) {
-    if (this.registeredViewModels.has(viewModel)) {
-      return false;
-    }
-    this.registeredViewModels.add(viewModel);
-    return true;
-  }
-  /** Removes a ViewModel from the registry. */
-  unregister(viewModel) {
-    this.registeredViewModels.delete(viewModel);
-  }
-  /** Every registered ViewModel. */
-  getAllViewModels() {
-    return Array.from(this.registeredViewModels);
-  }
-  /**
-   * Clears every registered ViewModel. Required by tests.
-   */
-  clear() {
-    this.registeredViewModels.clear();
-  }
-  /**
-   * Unsubscribes every registered ViewModel from its scenarios and clears the
-   * registry.
-   *
-   * Without it tests are not isolated: a subscription leaks from test to test.
-   */
-  resetAll() {
-    this.registeredViewModels.forEach((vm) => {
-      try {
-        vm.resetScenario();
-      } catch {
-      }
-    });
-    this.clear();
-  }
-};
-
-// src/scenario/_registries/lanka-scenarios-registry/LankaScenariosRegistry.ts
-var release = (scenario) => {
-  if (!scenario.cleanup) return;
-  try {
-    scenario.cleanup();
-  } catch (error) {
-    lankaLogger.printScenarioLog(`Error cleaning up scenario "${scenario.name}":`, error);
-  }
-};
-var LankaScenariosRegistry = class {
-  registeredScenarios = /* @__PURE__ */ new Map();
-  scenarioMetadata = /* @__PURE__ */ new Map();
-  /**
-   * Public: the registry belongs to a framework instance rather than to the
-   * module.
-   */
-  constructor() {
-  }
-  /**
-   * The active instance's registry, for callers that cannot hold one:
-   * `ALankaScenario` (a base class the consumer extends) and the static
-   * `LankaScenarioBootstrap`. Instance holders read `lanka.scenarios`.
-   */
-  static getInstance() {
-    return requireActiveRuntime().scenarios;
-  }
-  /**
-   * Registers a scenario by hand.
-   *
-   * @param scenario What to register
-   * @returns `false` when it was already registered
-   */
-  register(scenario) {
-    if (this.registeredScenarios.has(scenario.name)) {
-      return false;
-    }
-    this.registeredScenarios.set(scenario.name, scenario);
-    this.scenarioMetadata.set(scenario.name, {
-      scenario,
-      name: scenario.name,
-      eventType: scenario.eventType,
-      dataTypeName: scenario.dataTypeName,
-      isRegistered: true
-    });
-    return true;
-  }
-  /**
-   * Removes a scenario, calling its `cleanup` if it declared one.
-   *
-   * @param scenarioName Name of the scenario to unregister
-   * @returns true if unregistered successfully, false if not found
-   */
-  unregister(scenarioName) {
-    const scenario = this.registeredScenarios.get(scenarioName);
-    if (!scenario) {
-      return false;
-    }
-    const metadata = this.scenarioMetadata.get(scenarioName);
-    if (metadata) {
-      metadata.isRegistered = false;
-    }
-    this.registeredScenarios.delete(scenarioName);
-    release(scenario);
-    return true;
-  }
-  /**
-   * Get metadata for a specific scenario
-   * @param scenarioName Name of the scenario
-   * @returns Scenario metadata or undefined if not found
-   */
-  getMetadata(scenarioName) {
-    return this.scenarioMetadata.get(scenarioName);
-  }
-  /** Every registered scenario. */
-  getAllScenarios() {
-    return Array.from(this.registeredScenarios.values());
-  }
-  /** Metadata of every scenario. */
-  getAllMetadata() {
-    return Array.from(this.scenarioMetadata.values());
-  }
-  /** Whether a scenario with this name is registered. */
-  isRegistered(scenarioName) {
-    return this.registeredScenarios.has(scenarioName);
-  }
-  /**
-   * Collects every scenario that registered itself at construction.
-   */
-  collectAutoRegisteredScenarios() {
-    const autoRegistered = ALankaScenario.getAutoRegisteredScenarios();
-    autoRegistered.forEach((scenario) => {
-      if (!this.registeredScenarios.has(scenario.name)) {
-        this.register(scenario);
-      }
-    });
-  }
-  /**
-   * A scenario by name.
-   *
-   * @returns `undefined` when there is none
-   */
-  getScenarioByName(scenarioName) {
-    return this.registeredScenarios.get(scenarioName);
-  }
-  /** Every registered ViewModel. */
-  getAllViewModels() {
-    return LankaScenarioVMRegistry.getInstance().getAllViewModels();
-  }
-  /**
-   * Removes every scenario, calling each one's `cleanup`.
-   *
-   * What `dispose()` and the between-tests reset go through: `initialize` ran
-   * for every scenario at bootstrap, and this is the one moment its mirror
-   * image can run for all of them.
-   */
-  clear() {
-    const scenarios = [...this.registeredScenarios.values()];
-    this.registeredScenarios.clear();
-    this.scenarioMetadata.clear();
-    for (const scenario of scenarios) release(scenario);
-  }
-};
-
-// src/scenario/_abstractions/lanka-scenario/ALankaScenario.ts
-var ALankaScenario = class _ALankaScenario {
-  /** A subclass sets this to opt out of self-registration. */
-  static skipAutoRegistration;
-  /**
-   * The self-registration pool.
-   *
-   * Class-level deliberately: a registry of DEFINITIONS, not runtime state. The
-   * classes come from one barrel and both framework instances must see the same
-   * list — splitting it would be divergence, not isolation.
-   */
-  static autoRegisteredScenarios = /* @__PURE__ */ new Set();
-  /** Registers the scenario itself unless the subclass opted out. */
-  constructor() {
-    const constructor = this.constructor;
-    if (!constructor.skipAutoRegistration) {
-      _ALankaScenario.autoRegisteredScenarios.add(this);
-    }
-  }
-  /**
-   * Every scenario that registered itself.
-   *
-   * @internal
-   */
-  static getAutoRegisteredScenarios() {
-    return Array.from(_ALankaScenario.autoRegisteredScenarios);
-  }
-  /**
-   * Clears the auto-registration pool. Required by tests.
-   * @internal
-   */
-  static clearAutoRegisteredScenarios() {
-    _ALankaScenario.autoRegisteredScenarios.clear();
-  }
-  /**
-   * Registers the scenario by hand.
-   *
-   * @returns `false` when it was already registered
-   */
-  register() {
-    return LankaScenariosRegistry.getInstance().register(this);
-  }
-  /**
-   * Removes the scenario from the registry.
-   *
-   * @returns `false` when it was not there
-   */
-  unregister() {
-    return LankaScenariosRegistry.getInstance().unregister(this.name);
-  }
-  trigger(data) {
-    lankaLogger.printScenarioLog("TRIGGER Scenario", this.name, data);
-    lankaEventBus.dispatch(this.eventType, data, this.name);
-  }
-  /**
-   * Subscribes a handler and returns an unsubscribe function.
-   *
-   * Without the return, unsubscribing is possible only by callback identity, and
-   * every ViewModel factory has to keep a map of references for it.
-   */
-  subscribe(callback, options) {
-    lankaLogger.printScenarioLog("SUBSCRIBE Scenario", this.name, this.dataTypeName);
-    return lankaEventBus.subscribe(this.eventType, callback, {
-      ...options,
-      usedBy: options?.usedBy ?? this.name
-    });
-  }
-};
-
 // src/scenario/lanka-scenario-bootstrap/LankaScenarioBootstrap.ts
-import * as ScenariosModule from "@lanka_di/Scenarios";
 var LankaScenarioBootstrap = class {
   /**
    * The bootstrapped flag and the set of initialised VMs live on the INSTANCE.
@@ -327,11 +31,11 @@ var LankaScenarioBootstrap = class {
     const pooled = new Set(
       ALankaScenario.getAutoRegisteredScenarios().map((scenario) => scenario.constructor)
     );
-    for (const exported of Object.values(ScenariosModule)) {
-      if (typeof exported !== "function") continue;
-      if (pooled.has(exported)) continue;
+    const declared = requireActiveRuntime().locators.scenarios.getDeclaredScenarioClasses();
+    for (const Scenario of declared) {
+      if (pooled.has(Scenario)) continue;
       try {
-        new exported();
+        new Scenario();
       } catch {
       }
     }
@@ -541,10 +245,6 @@ var LankaScenarioBootstrap = class {
 var lankaScenarioBootstrap = new LankaScenarioBootstrap();
 
 export {
-  lankaEventBus,
-  ALankaScenario,
-  LankaScenarioVMRegistry,
-  LankaScenariosRegistry,
   lankaScenarioBootstrap
 };
-//# sourceMappingURL=chunk-EYDMBI5T.js.map
+//# sourceMappingURL=chunk-MKKMTLOY.js.map