lanka 2.1.0 → 2.2.1

package/dist/chunk-M4BK6GBV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/viewmodel/_internal/lanka-vm-recipes/lankaVMRecipes.ts","../src/locator/_factories/create-lanka-scope/createLankaScope.ts"],"sourcesContent":["import type { ILankaReadableVM } from \"../../_interfaces/ILankaReadableVM\";\nimport type { ILankaScenarioVM } from \"../../../scenario/_interfaces/ILankaScenarioVM\";\n\n/** What a definition actually holds, kept where a consumer cannot reach it. */\nexport interface ILankaVMRecipe {\n\treadonly name: string;\n\treadonly build: () => ILankaReadableVM<object>;\n}\n\n/**\n * What `defineLankaVM` writes and `resolveLankaVM` reads.\n *\n * One object rather than two exported maps, because a file here holds one\n * runtime identity — and because the two halves are one mechanism: a recipe\n * nobody can resolve and an instance map keyed by nothing are each meaningless\n * alone.\n *\n * ## Weak at both ends, and both ends matter\n *\n * `recipes` is weak so a definition dropped by its module takes its recipe with\n * it. `instances` is weak in the SCOPE so a finished request's ViewModels go\n * when its scope does, and weak in the DEFINITION because the published type\n * invites `defineLankaVM({...})` written inline in a component or a loop — in a\n * browser the scope key is the framework instance and lives as long as the tab,\n * so a strong inner map would hold every inline definition and its ViewModel\n * for the life of the page.\n *\n * ## `owned` is the one strong set, and it is drained\n *\n * A scope handed to `resolveLankaVM` must be able to take its ViewModels OFF the\n * bus when it closes, and a WeakMap cannot be walked. So what a scope built is\n * also kept in a Set it can read — strong, because the scope must find these\n * even when nothing else holds them — and `release` hands the set over and\n * forgets it, so a closed scope keeps nothing alive.\n */\nexport const lankaVMRecipes = {\n\trecipes: new WeakMap<object, ILankaVMRecipe>(),\n\tinstances: new WeakMap<object, WeakMap<object, ILankaReadableVM<object>>>(),\n\towned: new WeakMap<object, Set<ILankaScenarioVM>>(),\n\n\t/** The instances belonging to one scope, created on first use. */\n\tforScope(scope: object): WeakMap<object, ILankaReadableVM<object>> {\n\t\tconst existing = this.instances.get(scope);\n\n\t\tif (existing) return existing;\n\n\t\tconst created = new WeakMap<object, ILankaReadableVM<object>>();\n\n\t\tthis.instances.set(scope, created);\n\n\t\treturn created;\n\t},\n\t/** Records that `scope` built a ViewModel that registered for scenarios. */\n\town(scope: object, viewModel: ILankaScenarioVM): void {\n\t\tconst set = this.owned.get(scope) ?? new Set<ILankaScenarioVM>();\n\t\tset.add(viewModel);\n\t\tthis.owned.set(scope, set);\n\t},\n\t/** Everything `scope` owns, handed over once; the scope then holds nothing. */\n\trelease(scope: object): ILankaScenarioVM[] {\n\t\tconst set = this.owned.get(scope);\n\t\tthis.owned.delete(scope);\n\t\tthis.instances.delete(scope);\n\t\treturn set ? [...set] : [];\n\t},\n};\n","import { caseConvert } from \"../../../_internal/case-convert/caseConvert\";\nimport { lankaLogger } from \"../../../logger/lanka-logger/LankaLogger\";\nimport { lankaVMRecipes } from \"../../../viewmodel/_internal/lanka-vm-recipes/lankaVMRecipes\";\nimport type { LankaScenarioVMRegistry } from \"../../../scenario/_registries/lanka-scenario-vm-registry/LankaScenarioVMRegistry\";\nimport type { LankaSingletonLocator } from \"../../singleton/lanka-singleton-locator/LankaSingletonLocator\";\n\n/**\n * A service lifetime other than \"as long as the application lives\".\n *\n * Everything resolved through `lankaSingletons.*` is a singleton for the life of\n * the app. Per-route, per-session and per-modal lifetimes otherwise rest on\n * discipline: every ViewModel calling `resetScenario()` and writing its own\n * `onReset`, in any of which it can be forgotten.\n *\n * A scope provides the same by construction: an object created in it goes away\n * with it, and nobody has to remember.\n *\n * ## What a scope does NOT do\n *\n * It does not shadow root objects and does not take them on close. It takes only\n * ITS OWN — the ones it created. A scope taking others' would be more dangerous\n * than no scopes at all: closing a screen would break the app.\n *\n * The same rule decides how a ViewModel becomes a scope's own: it is RESOLVED\n * in it, `resolveLankaVM(definition, { scope })`, never captured by having been\n * built while some callback ran. Those leave with the scope too — off the bus\n * and out of the registry.\n */\nexport interface ILankaScope {\n\t/** Resolves a service in this scope, creating it on first use. */\n\tresolve<TInstance>(propertyName: string): TInstance;\n\t/** Disposes everything this scope created and closes it. Idempotent. */\n\tdispose(): void;\n\t/** Whether the scope is closed. */\n\tisDisposed(): boolean;\n}\n\n/** A service may have a `dispose` — or may not. */\ninterface IMaybeDisposable {\n\tdispose?: () => void;\n}\n\nexport function createLankaScope(\n\tsingletons: LankaSingletonLocator,\n\tviewModels: LankaScenarioVMRegistry,\n): ILankaScope {\n\tconst instances = new Map<string, unknown>();\n\tlet disposed = false;\n\n\tconst scope: ILankaScope = {\n\t\tresolve<TInstance>(propertyName: string): TInstance {\n\t\t\tif (disposed) {\n\t\t\t\t// Resolving from a closed scope is almost always a reference leaked from\n\t\t\t\t// an already-unmounted screen. Silently handing out an object would\n\t\t\t\t// extend the life of what was closed, invisibly.\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`The scope is closed: \"${propertyName}\" can no longer be resolved in it. ` +\n\t\t\t\t\t\t`This is usually a scope reference that outlived the screen that created it.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst className = caseConvert(propertyName, \"pascalCase\");\n\t\t\tif (instances.has(className)) return instances.get(className) as TInstance;\n\n\t\t\t// The class comes from the root locator while the OBJECT is created here:\n\t\t\t// a scope is a different lifetime, not a different set of services.\n\t\t\tconst instance = singletons.createScopedInstance(className, propertyName);\n\t\t\tinstances.set(className, instance);\n\t\t\treturn instance as TInstance;\n\t\t},\n\n\t\tdispose(): void {\n\t\t\tif (disposed) return;\n\t\t\tdisposed = true;\n\n\t\t\t// ViewModels first: a handler may still reach a service below.\n\t\t\tfor (const viewModel of lankaVMRecipes.release(scope)) {\n\t\t\t\ttry {\n\t\t\t\t\tviewModel.resetScenario();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlankaLogger.printBootstrapLog(\n\t\t\t\t\t\t\"Failed to reset a ViewModel's scenarios in the scope\",\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tviewModels.unregister(viewModel);\n\t\t\t}\n\n\t\t\tfor (const [name, instance] of instances) {\n\t\t\t\tconst disposable = instance as IMaybeDisposable;\n\t\t\t\tif (typeof disposable.dispose !== \"function\") continue;\n\t\t\t\ttry {\n\t\t\t\t\tdisposable.dispose();\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// One failure must not leave the rest alive: that is exactly what a\n\t\t\t\t\t// scope exists to prevent.\n\t\t\t\t\tlankaLogger.printBootstrapLog(\n\t\t\t\t\t\t`Failed to dispose \"${name}\" in the scope`,\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tinstances.clear();\n\t\t},\n\n\t\tisDisposed: () => disposed,\n\t};\n\n\treturn scope;\n}\n"],"mappings":";;;;;;;;AAmCO,IAAM,iBAAiB;AAAA,EAC7B,SAAS,oBAAI,QAAgC;AAAA,EAC7C,WAAW,oBAAI,QAA2D;AAAA,EAC1E,OAAO,oBAAI,QAAuC;AAAA;AAAA,EAGlD,SAAS,OAA0D;AAClE,UAAM,WAAW,KAAK,UAAU,IAAI,KAAK;AAEzC,QAAI,SAAU,QAAO;AAErB,UAAM,UAAU,oBAAI,QAA0C;AAE9D,SAAK,UAAU,IAAI,OAAO,OAAO;AAEjC,WAAO;AAAA,EACR;AAAA;AAAA,EAEA,IAAI,OAAe,WAAmC;AACrD,UAAM,MAAM,KAAK,MAAM,IAAI,KAAK,KAAK,oBAAI,IAAsB;AAC/D,QAAI,IAAI,SAAS;AACjB,SAAK,MAAM,IAAI,OAAO,GAAG;AAAA,EAC1B;AAAA;AAAA,EAEA,QAAQ,OAAmC;AAC1C,UAAM,MAAM,KAAK,MAAM,IAAI,KAAK;AAChC,SAAK,MAAM,OAAO,KAAK;AACvB,SAAK,UAAU,OAAO,KAAK;AAC3B,WAAO,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;AAAA,EAC1B;AACD;;;ACvBO,SAAS,iBACf,YACA,YACc;AACd,QAAM,YAAY,oBAAI,IAAqB;AAC3C,MAAI,WAAW;AAEf,QAAM,QAAqB;AAAA,IAC1B,QAAmB,cAAiC;AACnD,UAAI,UAAU;AAIb,cAAM,IAAI;AAAA,UACT,yBAAyB,YAAY;AAAA,QAEtC;AAAA,MACD;AAEA,YAAM,YAAY,YAAY,cAAc,YAAY;AACxD,UAAI,UAAU,IAAI,SAAS,EAAG,QAAO,UAAU,IAAI,SAAS;AAI5D,YAAM,WAAW,WAAW,qBAAqB,WAAW,YAAY;AACxE,gBAAU,IAAI,WAAW,QAAQ;AACjC,aAAO;AAAA,IACR;AAAA,IAEA,UAAgB;AACf,UAAI,SAAU;AACd,iBAAW;AAGX,iBAAW,aAAa,eAAe,QAAQ,KAAK,GAAG;AACtD,YAAI;AACH,oBAAU,cAAc;AAAA,QACzB,SAAS,OAAO;AACf,sBAAY;AAAA,YACX;AAAA,YACA,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UACtD;AAAA,QACD;AACA,mBAAW,WAAW,SAAS;AAAA,MAChC;AAEA,iBAAW,CAAC,MAAM,QAAQ,KAAK,WAAW;AACzC,cAAM,aAAa;AACnB,YAAI,OAAO,WAAW,YAAY,WAAY;AAC9C,YAAI;AACH,qBAAW,QAAQ;AAAA,QACpB,SAAS,OAAO;AAGf,sBAAY;AAAA,YACX,sBAAsB,IAAI;AAAA,YAC1B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UACtD;AAAA,QACD;AAAA,MACD;AAEA,gBAAU,MAAM;AAAA,IACjB;AAAA,IAEA,YAAY,MAAM;AAAA,EACnB;AAEA,SAAO;AACR;","names":[]}

package/dist/{chunk-BHQ2SQ7P.js → chunk-NMFNEVNE.js}

@@ -1,6 +1,6 @@
 import {
   requireActiveRuntime
-} from "./chunk-XGMXT4XZ.js";
+} from "./chunk-XTVEHYIZ.js";
 
 // src/gateway/inflight/lankaHttpInFlight.ts
 function createInFlightCounter() {
@@ -36,4 +36,4 @@ export {
   createInFlightCounter,
   lankaHttpInFlight
 };
-//# sourceMappingURL=chunk-BHQ2SQ7P.js.map
+//# sourceMappingURL=chunk-NMFNEVNE.js.map

package/dist/{chunk-7DQUF2QR.js → chunk-SP5OUTWF.js}

@@ -1,6 +1,6 @@
 import {
   getActiveRuntime
-} from "./chunk-XGMXT4XZ.js";
+} from "./chunk-XTVEHYIZ.js";
 
 // src/config/get-lanka-flags/getLankaFlags.ts
 function getLankaFlags() {
@@ -10,4 +10,4 @@ function getLankaFlags() {
 export {
   getLankaFlags
 };
-//# sourceMappingURL=chunk-7DQUF2QR.js.map
+//# sourceMappingURL=chunk-SP5OUTWF.js.map

package/dist/chunk-XTVEHYIZ.js

@@ -0,0 +1,89 @@
+// src/_internal/active-runtime/lankaCopies.ts
+var COPIES = /* @__PURE__ */ Symbol.for("lanka.copies");
+var copies = () => {
+  const global = globalThis;
+  return global[COPIES] ??= /* @__PURE__ */ new Set();
+};
+var thisCopy = null;
+var warned = false;
+var otherCopies = () => [...copies()].filter((copy) => copy !== thisCopy);
+var anotherIsRunning = () => otherCopies().some((copy) => copy() !== null);
+var warnOnce = () => {
+  if (warned) return;
+  warned = true;
+  console.warn(
+    "[lanka] two copies of lanka are on this page. Each copy has its own runtime, so a scenario triggered through one never reaches a ViewModel registered with the other. If the modules on this page are meant to share state, ship ONE lanka: a singleton in Module Federation's `shared`, an import map, or `lanka` external in every module's build. If they are meant to be isolated, this is expected."
+  );
+};
+var join = (state) => {
+  thisCopy = state;
+  copies().add(state);
+  if (otherCopies().some((copy) => copy() === true)) warnOnce();
+};
+var noteActivation = (isDevelopment) => {
+  if (thisCopy) copies().add(thisCopy);
+  if (isDevelopment && anotherIsRunning()) warnOnce();
+};
+var lankaCopies = Object.freeze({ join, noteActivation, anotherIsRunning });
+
+// src/_internal/active-runtime/activeRuntime.ts
+var active = null;
+var resolveRuntime = null;
+var resolveScope = null;
+var hadInstance = false;
+function setActiveLankaRuntime(runtime) {
+  active = runtime;
+  if (runtime) {
+    hadInstance = true;
+    lankaCopies.noteActivation(runtime.getFlags().isDevelopment === true);
+  }
+}
+lankaCopies.join(() => active === null ? null : active.getFlags().isDevelopment === true);
+function setLankaRuntimeResolver(resolver) {
+  resolveRuntime = resolver;
+}
+function getLankaProcessRuntime() {
+  return active;
+}
+function getActiveRuntime() {
+  return resolveRuntime ? resolveRuntime() : active;
+}
+function setLankaScopeResolver(resolver) {
+  resolveScope = resolver;
+}
+function hasLankaScopeResolver() {
+  return resolveScope !== null;
+}
+function getActiveLankaScope() {
+  return resolveScope ? resolveScope() : null;
+}
+var RELOADED_UNDER_AN_OPEN_PAGE = "a dev server kept this page open while lanka was upgraded or reinstalled, and a module loaded since then got the new files: reload the page";
+function noInstanceMessage() {
+  if (resolveRuntime) {
+    return "lanka has no instance for this call. A runtime resolver is installed and answered with none, which on a server means the code ran outside a request scope \u2014 start one, or do this work inside it.";
+  }
+  if (lankaCopies.anotherIsRunning()) {
+    return `lanka used before an instance existed in THIS copy of the package, while another copy of lanka on this page has one. Either the module calling it bundled its own lanka \u2014 ship one: a singleton in Module Federation's \`shared\`, an import map, or \`lanka\` external in its build \u2014 or ${RELOADED_UNDER_AN_OPEN_PAGE}.`;
+  }
+  if (hadInstance) {
+    return "lanka has no instance: one was active in this copy and has been cleared \u2014 disposed, or deactivated by whatever manages instances here \u2014 and none has been activated since. Either the call outlived it (a timer, a subscription or a pending request still running after dispose), or a new one is due: createLanka({ host }) and activate it.";
+  }
+  return `lanka used before an instance existed. Call createLanka({ host }) and activate it. If that already ran on this page, it ran in another evaluation of lanka and this one started empty \u2014 most often, ${RELOADED_UNDER_AN_OPEN_PAGE}; or a module bundled a copy older than lanka 2.2.0, which does not announce itself to this one.`;
+}
+function requireActiveRuntime() {
+  const runtime = resolveRuntime ? resolveRuntime() : active;
+  if (!runtime) throw new Error(noInstanceMessage());
+  return runtime;
+}
+
+export {
+  setActiveLankaRuntime,
+  setLankaRuntimeResolver,
+  getLankaProcessRuntime,
+  getActiveRuntime,
+  setLankaScopeResolver,
+  hasLankaScopeResolver,
+  getActiveLankaScope,
+  requireActiveRuntime
+};
+//# sourceMappingURL=chunk-XTVEHYIZ.js.map

package/dist/chunk-XTVEHYIZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/_internal/active-runtime/lankaCopies.ts","../src/_internal/active-runtime/activeRuntime.ts"],"sourcesContent":["/**\n * Which COPIES of the package are on this page, and whether any of them runs.\n *\n * A copy is one evaluation of this module — one bundle's `lanka`. Two instances\n * of one copy are the isolation `createLanka` promises; two copies are what a\n * build produces when separately bundled modules each carry their own `lanka`,\n * and then each copy's pointer knows only its own runtime. A scenario triggered\n * through one never reaches a ViewModel registered with the other, and nothing\n * anywhere reports it.\n *\n * The only place two copies can meet is the global object, under a name every\n * copy agrees on without importing anything: `Symbol.for`.\n *\n * Dependency-free for the same reason `activeRuntime.ts` is — it imports nothing\n * and adds no edge to the module graph. That is also what keeps hot reload from\n * reading as a second copy: an update re-evaluates the edited module and its\n * IMPORTERS, and a module that imports nothing is on no such path unless it is\n * the file being edited. A full reload starts a new global object.\n */\n\n/**\n * One copy, as the others see it: `null` while it has no runtime, otherwise\n * whether that runtime runs in development.\n */\nexport type TLankaCopyState = () => boolean | null;\n\nconst COPIES = Symbol.for(\"lanka.copies\");\n\nconst copies = (): Set<TLankaCopyState> => {\n\tconst global = globalThis as Record<symbol, Set<TLankaCopyState> | undefined>;\n\treturn (global[COPIES] ??= new Set<TLankaCopyState>());\n};\n\nlet thisCopy: TLankaCopyState | null = null;\nlet warned = false;\n\nconst otherCopies = (): TLankaCopyState[] => [...copies()].filter((copy) => copy !== thisCopy);\n\n/** Whether a copy of the package other than this one has a runtime. */\nconst anotherIsRunning = (): boolean => otherCopies().some((copy) => copy() !== null);\n\n/**\n * Once per copy, and only in development: a production page with two copies may\n * be two isolated applications on purpose, and the reader who can fix a build\n * is the one running it locally.\n */\nconst warnOnce = (): void => {\n\tif (warned) return;\n\n\twarned = true;\n\tconsole.warn(\n\t\t\"[lanka] two copies of lanka are on this page. Each copy has its own \" +\n\t\t\t\"runtime, so a scenario triggered through one never reaches a ViewModel \" +\n\t\t\t\"registered with the other. If the modules on this page are meant to share \" +\n\t\t\t\"state, ship ONE lanka: a singleton in Module Federation's `shared`, an \" +\n\t\t\t\"import map, or `lanka` external in every module's build. If they are \" +\n\t\t\t\"meant to be isolated, this is expected.\",\n\t);\n};\n\n/**\n * Puts this copy on the page's list, when the copy LOADS.\n *\n * Loading is the one moment a copy that is never started does anything the page\n * can see — and never starting is the commonest form of the accident: the shell\n * started lanka, a module bundled its own and saw no reason to. Whether to warn\n * is the RUNNING copy's call, since this one has no flags yet.\n */\nconst join = (state: TLankaCopyState): void => {\n\tthisCopy = state;\n\tcopies().add(state);\n\n\tif (otherCopies().some((copy) => copy() === true)) warnOnce();\n};\n\n/**\n * Called on every activation, which is not a hot path: `createLanka`, its\n * `bootstrap`, and one instance per request on a server.\n */\nconst noteActivation = (isDevelopment: boolean): void => {\n\t// Re-added, not assumed: whatever cleared the global list — a test between\n\t// cases — must not make a running copy invisible to the next one.\n\tif (thisCopy) copies().add(thisCopy);\n\n\tif (isDevelopment && anotherIsRunning()) warnOnce();\n};\n\n/**\n * The three questions a copy asks of the page, as one table: they share this\n * copy's identity and its one warning, so they are one subject.\n */\nexport const lankaCopies = Object.freeze({ join, noteActivation, anotherIsRunning });\n","import type { LankaEventBusInstance } from \"../../scenario/event-bus/lanka-event-bus-instance/LankaEventBusInstance\";\nimport type { LankaScenariosRegistry } from \"../../scenario/_registries/lanka-scenarios-registry/LankaScenariosRegistry\";\nimport type { LankaScenarioVMRegistry } from \"../../scenario/_registries/lanka-scenario-vm-registry/LankaScenarioVMRegistry\";\nimport type { ILankaRuntimeConfig } from \"../../config/_interfaces/ILankaRuntimeConfig\";\nimport type { ILankaInFlightCounter } from \"../../gateway/inflight/lankaHttpInFlight\";\nimport type { ILankaScenarioVM } from \"../../scenario/_interfaces/ILankaScenarioVM\";\nimport type { TLankaRequestMiddleware } from \"../../gateway/request/lankaRequestMiddleware\";\nimport type { LankaGatewayLocator } from \"../../locator/gateway/lanka-gateway-locator/LankaGatewayLocator\";\nimport type { LankaScenarioLocator } from \"../../locator/scenario/lanka-scenario-locator/LankaScenarioLocator\";\nimport type { LankaSingletonLocator } from \"../../locator/singleton/lanka-singleton-locator/LankaSingletonLocator\";\nimport type { LankaSharedStoreLocator } from \"../../locator/shared-store/lanka-shared-store-locator/LankaSharedStoreLocator\";\nimport { lankaCopies } from \"./lankaCopies\";\n\n/**\n * The pointer to the framework instance that ambient facades resolve to.\n *\n * ## Why this module is separate and imports no value\n *\n * Framework state belongs to an instance (`createLanka`), but the callers of\n * `lankaEventBus.dispatch`, `getLankaFlags()`, `lankaSingletons.foo`, `lankaHttpInFlight` —\n * the ambient facades cannot hold one — a user-extended `ALankaScenario`, the\n * static `LankaScenarioBootstrap` — so they ask which instance is active.\n *\n * The module is dependency-free DELIBERATELY: every import here is `import type`\n * and disappears at compile time, except `lankaCopies`, which imports nothing\n * itself. Otherwise there would be a cycle\n * `createLanka → locator → gateway → config → createLanka`, and module\n * evaluation order would start deciding what ends up `undefined`.\n *\n * This is still a global pointer. Real isolation belongs to whoever holds an\n * instance: their own bus, registries and counter. The facades serve ONE active\n * instance — exactly what an application with one needs.\n */\nexport interface ILankaRuntime {\n\treadonly eventBus: LankaEventBusInstance;\n\treadonly scenarios: LankaScenariosRegistry;\n\treadonly viewModels: LankaScenarioVMRegistry;\n\treadonly inFlight: ILankaInFlightCounter;\n\t/**\n\t * Request wrappers, in registration order: the first wraps them all.\n\t *\n\t * An array, not a set: order carries meaning — retry must sit outside request\n\t * signing, or the second attempt goes out unsigned.\n\t */\n\treadonly requestMiddleware: readonly TLankaRequestMiddleware[];\n\t/** Default response deadline. `undefined` means no limit. */\n\treadonly requestTimeoutMs: number | undefined;\n\treadonly locators: {\n\t\treadonly gateways: LankaGatewayLocator;\n\t\treadonly scenarios: LankaScenarioLocator;\n\t\treadonly singletons: LankaSingletonLocator;\n\t\treadonly sharedStores: LankaSharedStoreLocator;\n\t};\n\treadonly config: ILankaRuntimeConfig;\n\t/**\n\t * Bootstrap state of the scenario layer.\n\t *\n\t * A mutable object rather than contract fields: `LankaScenarioBootstrap` is an\n\t * ambient facade and must write here without holding an instance.\n\t */\n\treadonly scenarioState: {\n\t\tbootstrapped: boolean;\n\t\tinitialized: WeakSet<ILankaScenarioVM>;\n\t};\n\tsetConfig(patch: ILankaRuntimeConfig): void;\n\tgetFlags(): NonNullable<ILankaRuntimeConfig[\"flags\"]>;\n}\n\n/**\n * How \"which instance is active\" is answered.\n *\n * A strategy, because the answer depends on where the code runs. In a browser\n * there is one instance per document and a module-level pointer IS the answer. In\n * a server process there is one instance per REQUEST, and a module-level pointer\n * is the bug: the last request to start would answer for all of them.\n */\nexport type TLankaRuntimeResolver = () => ILankaRuntime | null;\n\n/**\n * How \"which SCOPE is this\" is answered, which is a different question.\n *\n * `TLankaRuntimeResolver` answers which framework INSTANCE serves a call, and on\n * a server that is one per request. This answers which unit of work the call\n * belongs to, and the two are not interchangeable: `runInLankaServerScope`\n * creates its instance INSIDE the scope, and `createLanka` activates every\n * instance it builds — so the process pointer and the scope's runtime are the\n * same object during a request, and nothing downstream can tell \"inside a\n * scope\" from \"after one ended\".\n *\n * That distinction is what a per-scope lifetime needs. Without it a call made\n * outside every request resolves against the LAST request's runtime and is\n * handed the last stranger's state, which is the failure a scope exists to\n * abolish.\n *\n * Core ships no resolver here either, and knows only that the question exists.\n */\nexport type TLankaScopeResolver = () => object | null;\n\nlet active: ILankaRuntime | null = null;\nlet resolveRuntime: TLankaRuntimeResolver | null = null;\nlet resolveScope: TLankaScopeResolver | null = null;\n\n/**\n * Whether THIS copy has ever had an instance — what tells \"not yet\" from \"no\n * longer\" when a call finds none. Without it the one message named a missing\n * `createLanka` for a page that had been rendering off one for minutes.\n */\nlet hadInstance = false;\n\nexport function setActiveLankaRuntime(runtime: ILankaRuntime | null): void {\n\tactive = runtime;\n\n\tif (runtime) {\n\t\thadInstance = true;\n\t\tlankaCopies.noteActivation(runtime.getFlags().isDevelopment === true);\n\t}\n}\n\n// What another copy of the package asks this one, registered as this copy loads.\nlankaCopies.join(() => (active === null ? null : active.getFlags().isDevelopment === true));\n\n/**\n * Replaces the strategy, or restores the default one with `null`.\n *\n * The installed resolver is the WHOLE answer — the module-level pointer is not\n * consulted behind it. That is deliberate: a fallback would turn \"this ran\n * outside a request\" from a loud error into one request quietly reading another\n * request's instance, which is the failure this seam exists to make impossible.\n *\n * Core ships no resolver and knows of none. What installs one is a package that\n * knows the shape of a request; core knows only that the question has more than\n * one answer.\n */\nexport function setLankaRuntimeResolver(resolver: TLankaRuntimeResolver | null): void {\n\tresolveRuntime = resolver;\n}\n\n/**\n * The PROCESS's own instance, read without asking the strategy.\n *\n * `getActiveRuntime` consults the installed resolver and is the answer for\n * almost everything. This is the one question it cannot answer: what a call\n * would have resolved to if nobody had installed a resolver at all.\n *\n * It exists for a resolver that wants to DEFER. A server's resolver answers from\n * its request scope, and a process that also holds an ambient instance — a\n * worker with a cache, a dev server between reloads, a suite between cases —\n * has a right answer outside every scope that the resolver cannot see. Without\n * this, the first request in such a process makes every later ambient call fail\n * for the life of it.\n *\n * Not a fallback inside `getActiveRuntime`, deliberately: a resolver that wants\n * to defer says so, and one that wants a call outside its scope to fail loudly\n * goes on failing loudly. The choice belongs to whoever knows what a scope is.\n */\nexport function getLankaProcessRuntime(): ILankaRuntime | null {\n\treturn active;\n}\n\nexport function getActiveRuntime(): ILankaRuntime | null {\n\treturn resolveRuntime ? resolveRuntime() : active;\n}\n\n/**\n * Installs the strategy that says which unit of work a call belongs to.\n *\n * Installed by whoever knows what a scope IS — `@lankajs/host` wraps a request\n * in `AsyncLocalStorage` and answers from its store. A browser installs none,\n * and that is the right answer there: a tab is one scope for its whole life.\n */\nexport function setLankaScopeResolver(resolver: TLankaScopeResolver | null): void {\n\tresolveScope = resolver;\n}\n\n/** Whether anything at all knows how to answer \"which scope\". */\nexport function hasLankaScopeResolver(): boolean {\n\treturn resolveScope !== null;\n}\n\n/**\n * The current unit of work, or `null`.\n *\n * `null` means two different things and the caller has to tell them apart with\n * `hasLankaScopeResolver`: with no resolver installed there are no scopes and a\n * process-wide lifetime is correct; with one installed it means this call ran\n * OUTSIDE every scope, which on a server is a mistake worth failing on.\n */\nexport function getActiveLankaScope(): object | null {\n\treturn resolveScope ? resolveScope() : null;\n}\n\n/**\n * The same page keeping a stale evaluation of lanka beside a fresh one, which\n * is not a bundling accident: a dev server kept the page open while lanka was\n * upgraded or reinstalled, and a module loaded afterwards got the new files.\n */\nconst RELOADED_UNDER_AN_OPEN_PAGE =\n\t\"a dev server kept this page open while lanka was upgraded or reinstalled, and \" +\n\t\"a module loaded since then got the new files: reload the page\";\n\n/**\n * Why a call found no instance — four different causes, each with its own fix.\n *\n * Out of line, and only ever built on the way to a throw: the success path of\n * `requireActiveRuntime` stays exactly what it was.\n */\nfunction noInstanceMessage(): string {\n\tif (resolveRuntime) {\n\t\treturn (\n\t\t\t\"lanka has no instance for this call. A runtime resolver is installed and \" +\n\t\t\t\"answered with none, which on a server means the code ran outside a \" +\n\t\t\t\"request scope — start one, or do this work inside it.\"\n\t\t);\n\t}\n\n\tif (lankaCopies.anotherIsRunning()) {\n\t\treturn (\n\t\t\t\"lanka used before an instance existed in THIS copy of the package, while \" +\n\t\t\t\"another copy of lanka on this page has one. Either the module calling it \" +\n\t\t\t\"bundled its own lanka — ship one: a singleton in Module Federation's \" +\n\t\t\t\"`shared`, an import map, or `lanka` external in its build — or \" +\n\t\t\t`${RELOADED_UNDER_AN_OPEN_PAGE}.`\n\t\t);\n\t}\n\n\tif (hadInstance) {\n\t\treturn (\n\t\t\t\"lanka has no instance: one was active in this copy and has been cleared — \" +\n\t\t\t\"disposed, or deactivated by whatever manages instances here — and none has \" +\n\t\t\t\"been activated since. Either the call outlived it (a timer, a subscription \" +\n\t\t\t\"or a pending request still running after dispose), or a new one is due: \" +\n\t\t\t\"createLanka({ host }) and activate it.\"\n\t\t);\n\t}\n\n\t// A copy from before 2.2.0 never announces itself, so a stale one beside\n\t// this fresh one lands here rather than in the branch above.\n\treturn (\n\t\t\"lanka used before an instance existed. Call createLanka({ host }) and activate \" +\n\t\t\"it. If that already ran on this page, it ran in another evaluation of lanka \" +\n\t\t\"and this one started empty — most often, \" +\n\t\t`${RELOADED_UNDER_AN_OPEN_PAGE}; or a module bundled a copy older than lanka ` +\n\t\t\"2.2.0, which does not announce itself to this one.\"\n\t);\n}\n\n/**\n * The active instance, or a loud failure.\n *\n * No fallback, deliberately, for the same reason `getLankaHost` has none: an\n * instance created silently on the fly would mean subscriptions went to one bus\n * and events to another, and the divergence would surface three layers away.\n */\nexport function requireActiveRuntime(): ILankaRuntime {\n\t// The strategy is read here rather than through `getActiveRuntime()`: this is\n\t// the hottest path in the framework — every ambient facade, every request,\n\t// every dispatch — and a call that only forwards is a call that shows up in\n\t// `perf/`.\n\tconst runtime = resolveRuntime ? resolveRuntime() : active;\n\n\tif (!runtime) throw new Error(noInstanceMessage());\n\n\treturn runtime;\n}\n"],"mappings":";AA0BA,IAAM,SAAS,uBAAO,IAAI,cAAc;AAExC,IAAM,SAAS,MAA4B;AAC1C,QAAM,SAAS;AACf,SAAQ,OAAO,MAAM,MAAM,oBAAI,IAAqB;AACrD;AAEA,IAAI,WAAmC;AACvC,IAAI,SAAS;AAEb,IAAM,cAAc,MAAyB,CAAC,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,SAAS,QAAQ;AAG7F,IAAM,mBAAmB,MAAe,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,MAAM,IAAI;AAOpF,IAAM,WAAW,MAAY;AAC5B,MAAI,OAAQ;AAEZ,WAAS;AACT,UAAQ;AAAA,IACP;AAAA,EAMD;AACD;AAUA,IAAM,OAAO,CAAC,UAAiC;AAC9C,aAAW;AACX,SAAO,EAAE,IAAI,KAAK;AAElB,MAAI,YAAY,EAAE,KAAK,CAAC,SAAS,KAAK,MAAM,IAAI,EAAG,UAAS;AAC7D;AAMA,IAAM,iBAAiB,CAAC,kBAAiC;AAGxD,MAAI,SAAU,QAAO,EAAE,IAAI,QAAQ;AAEnC,MAAI,iBAAiB,iBAAiB,EAAG,UAAS;AACnD;AAMO,IAAM,cAAc,OAAO,OAAO,EAAE,MAAM,gBAAgB,iBAAiB,CAAC;;;ACOnF,IAAI,SAA+B;AACnC,IAAI,iBAA+C;AACnD,IAAI,eAA2C;AAO/C,IAAI,cAAc;AAEX,SAAS,sBAAsB,SAAqC;AAC1E,WAAS;AAET,MAAI,SAAS;AACZ,kBAAc;AACd,gBAAY,eAAe,QAAQ,SAAS,EAAE,kBAAkB,IAAI;AAAA,EACrE;AACD;AAGA,YAAY,KAAK,MAAO,WAAW,OAAO,OAAO,OAAO,SAAS,EAAE,kBAAkB,IAAK;AAcnF,SAAS,wBAAwB,UAA8C;AACrF,mBAAiB;AAClB;AAoBO,SAAS,yBAA+C;AAC9D,SAAO;AACR;AAEO,SAAS,mBAAyC;AACxD,SAAO,iBAAiB,eAAe,IAAI;AAC5C;AASO,SAAS,sBAAsB,UAA4C;AACjF,iBAAe;AAChB;AAGO,SAAS,wBAAiC;AAChD,SAAO,iBAAiB;AACzB;AAUO,SAAS,sBAAqC;AACpD,SAAO,eAAe,aAAa,IAAI;AACxC;AAOA,IAAM,8BACL;AASD,SAAS,oBAA4B;AACpC,MAAI,gBAAgB;AACnB,WACC;AAAA,EAIF;AAEA,MAAI,YAAY,iBAAiB,GAAG;AACnC,WACC,uSAIG,2BAA2B;AAAA,EAEhC;AAEA,MAAI,aAAa;AAChB,WACC;AAAA,EAMF;AAIA,SACC,4MAGG,2BAA2B;AAGhC;AASO,SAAS,uBAAsC;AAKrD,QAAM,UAAU,iBAAiB,eAAe,IAAI;AAEpD,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,kBAAkB,CAAC;AAEjD,SAAO;AACR;","names":[]}

package/dist/config/index.js

@@ -3,11 +3,11 @@ import {
 } from "../chunk-XESL274R.js";
 import {
   getLankaHost
-} from "../chunk-RUMUFHSL.js";
+} from "../chunk-JGJBFELR.js";
 import {
   getLankaFlags
-} from "../chunk-7DQUF2QR.js";
-import "../chunk-XGMXT4XZ.js";
+} from "../chunk-SP5OUTWF.js";
+import "../chunk-XTVEHYIZ.js";
 export {
   createLankaHost,
   getLankaFlags,

package/dist/{createLanka-DvUGu9Hl.d.ts → createLanka-AuiMfPL9.d.ts}

@@ -1,5 +1,5 @@
-import { I as ILankaScope } from './createLankaScope-CVoV0EwO.js';
-import { I as ILankaRuntime } from './activeRuntime-ByucLPhj.js';
+import { I as ILankaScope } from './createLankaScope-DeElRH-E.js';
+import { I as ILankaRuntime } from './activeRuntime-DxB62KN4.js';
 import { a as ILankaHost, I as ILankaFlags } from './ILankaRuntimeConfig-Vl436GWK.js';
 import { T as TLankaRequestMiddleware } from './lankaRequestMiddleware-DAC5kCb7.js';
 
@@ -45,8 +45,8 @@ interface ILankaPlugin {
  *
  * **Ambient facades** — `lankaEventBus.dispatch`, `lankaSingletons.foo`,
  * `getLankaFlags()`, `lankaHttpInFlight` — resolve THE ONE active instance
- * (`internal/activeRuntime.ts`). Isolation belongs to whoever holds an instance;
- * a facade cannot offer it.
+ * (`_internal/active-runtime/activeRuntime.ts`). Isolation belongs to whoever
+ * holds an instance; a facade cannot offer it.
  *
  * One thing stays at module level deliberately: `ALankaScenario` collects
  * constructed scenarios into a static pool. That is a REGISTRY OF DEFINITIONS,

package/dist/{createLankaScope-CVoV0EwO.d.ts → createLankaScope-DeElRH-E.d.ts}

@@ -1,3 +1,4 @@
+import { L as LankaScenarioVMRegistry } from './LankaScenarioVMRegistry-CFzCpIFd.js';
 import { LankaSingletonLocator } from './locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js';
 
 /**
@@ -16,6 +17,11 @@ import { LankaSingletonLocator } from './locator/singleton/lanka-singleton-locat
  * It does not shadow root objects and does not take them on close. It takes only
  * ITS OWN — the ones it created. A scope taking others' would be more dangerous
  * than no scopes at all: closing a screen would break the app.
+ *
+ * The same rule decides how a ViewModel becomes a scope's own: it is RESOLVED
+ * in it, `resolveLankaVM(definition, { scope })`, never captured by having been
+ * built while some callback ran. Those leave with the scope too — off the bus
+ * and out of the registry.
  */
 interface ILankaScope {
     /** Resolves a service in this scope, creating it on first use. */
@@ -25,6 +31,6 @@ interface ILankaScope {
     /** Whether the scope is closed. */
     isDisposed(): boolean;
 }
-declare function createLankaScope(singletons: LankaSingletonLocator): ILankaScope;
+declare function createLankaScope(singletons: LankaSingletonLocator, viewModels: LankaScenarioVMRegistry): ILankaScope;
 
 export { type ILankaScope as I, createLankaScope as c };

package/dist/errors/index.js

@@ -1,13 +1,13 @@
 import {
   createLankaApiError,
   handleLankaApiError
-} from "../chunk-O5EUTNR6.js";
+} from "../chunk-DKLOCKS4.js";
 import "../chunk-J5LA3Q6D.js";
 import {
   LankaError
 } from "../chunk-G32H73QY.js";
-import "../chunk-RUMUFHSL.js";
-import "../chunk-XGMXT4XZ.js";
+import "../chunk-JGJBFELR.js";
+import "../chunk-XTVEHYIZ.js";
 
 // src/errors/read-lanka-field-errors/readLankaFieldErrors.ts
 var NONE = Object.freeze([]);

package/dist/gateway/index.js

@@ -7,26 +7,26 @@ import {
 } from "../chunk-YR4MZXMU.js";
 import {
   lankaHttpInFlight
-} from "../chunk-BHQ2SQ7P.js";
+} from "../chunk-NMFNEVNE.js";
 import {
   handleLankaApiError
-} from "../chunk-O5EUTNR6.js";
+} from "../chunk-DKLOCKS4.js";
 import "../chunk-J5LA3Q6D.js";
 import {
   LankaError
 } from "../chunk-G32H73QY.js";
 import {
   getLankaHost
-} from "../chunk-RUMUFHSL.js";
+} from "../chunk-JGJBFELR.js";
 import {
   lankaLogger
-} from "../chunk-FII3PW2G.js";
+} from "../chunk-AMLUKB6A.js";
 import {
   getLankaFlags
-} from "../chunk-7DQUF2QR.js";
+} from "../chunk-SP5OUTWF.js";
 import {
   getActiveRuntime
-} from "../chunk-XGMXT4XZ.js";
+} from "../chunk-XTVEHYIZ.js";
 
 // src/gateway/request/_abstractions/lanka-request/ALankaRequest.ts
 function classifyTransportError(error, timedOut) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { I as ILankaBootstrapConfig, a as ILankaInstance, b as ILankaInstanceConfig, c as ILankaPlugin, d as ILankaScenarioBootstrapConfig, e as ILankaServiceConfig, f as createLanka } from './createLanka-DvUGu9Hl.js';
+export { I as ILankaBootstrapConfig, a as ILankaInstance, b as ILankaInstanceConfig, c as ILankaPlugin, d as ILankaScenarioBootstrapConfig, e as ILankaServiceConfig, f as createLanka } from './createLanka-AuiMfPL9.js';
 export { ALankaPlugin, ILankaStartOptions, TLankaStartConfig, resetActiveLanka, startLanka } from './bootstrap/index.js';
 export { ILankaRoleFactory, ILankaRoleOpening, TLankaRoleOpener, defineLankaRole } from './role/index.js';
 export { ILankaHostConfig, createLankaHost, getLankaFlags, getLankaHost } from './config/index.js';
@@ -6,13 +6,14 @@ export { I as ILankaFlags, a as ILankaHost, b as ILankaRuntimeConfig } from './I
 export { I as ILankaLocatorConfig } from './ALankaLocator-BUCCz0Q5.js';
 export { lankaLogger } from './logger/index.js';
 export { I as ILankaErrorInit, L as LankaError, T as TLankaErrorKind } from './LankaError-D6RWNyLM.js';
-import './createLankaScope-CVoV0EwO.js';
-import './locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js';
-import './activeRuntime-ByucLPhj.js';
-import './ILankaScenario-DQd9ZfUw.js';
-import './LankaScenarioVMRegistry-DySAOaj2.js';
+import './createLankaScope-DeElRH-E.js';
+import './LankaScenarioVMRegistry-CFzCpIFd.js';
 import './ILankaScenarioVM-DKwjbIRq.js';
-import './ILankaScenarioMetadata-BsDp0Bzm.js';
+import './locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js';
+import './activeRuntime-DxB62KN4.js';
+import './ILankaScenario-7J3MoKiY.js';
+import './LankaScenariosRegistry-DiLN9xwy.js';
+import './ILankaScenarioMetadata-DgOxvpwx.js';
 import './lankaHttpInFlight-Bk1eIuSx.js';
 import './lankaRequestMiddleware-DAC5kCb7.js';
 import './locator/gateway/lanka-gateway-locator/LankaGatewayLocator.js';

package/dist/index.js

@@ -6,33 +6,33 @@ import {
   createLanka,
   resetActiveLanka,
   startLanka
-} from "./chunk-SO7D5E7O.js";
-import "./chunk-SBITVBF7.js";
+} from "./chunk-532WVMAF.js";
+import "./chunk-M4BK6GBV.js";
 import "./chunk-BMF4TM2Z.js";
-import "./chunk-42CWYVZJ.js";
-import "./chunk-MKKMTLOY.js";
-import "./chunk-NWEHOMTS.js";
+import "./chunk-EH5WZSRJ.js";
+import "./chunk-24MUFFHF.js";
+import "./chunk-3R2NO47A.js";
+import "./chunk-JZJ6GXX3.js";
+import "./chunk-N3275IPH.js";
+import "./chunk-4VFVACSL.js";
+import "./chunk-L27FF2IH.js";
 import {
   createLankaHost
 } from "./chunk-XESL274R.js";
-import "./chunk-BHQ2SQ7P.js";
+import "./chunk-NMFNEVNE.js";
 import {
   LankaError
 } from "./chunk-G32H73QY.js";
 import {
   getLankaHost
-} from "./chunk-RUMUFHSL.js";
-import "./chunk-3R2NO47A.js";
-import "./chunk-24MUFFHF.js";
-import "./chunk-JZJ6GXX3.js";
-import "./chunk-N3275IPH.js";
+} from "./chunk-JGJBFELR.js";
 import {
   lankaLogger
-} from "./chunk-FII3PW2G.js";
+} from "./chunk-AMLUKB6A.js";
 import {
   getLankaFlags
-} from "./chunk-7DQUF2QR.js";
-import "./chunk-XGMXT4XZ.js";
+} from "./chunk-SP5OUTWF.js";
+import "./chunk-XTVEHYIZ.js";
 export {
   ALankaPlugin,
   LankaError,

package/dist/locator/index.d.ts

@@ -1,121 +1,20 @@
-export { I as ILankaScope } from '../createLankaScope-CVoV0EwO.js';
+export { I as ILankaScope } from '../createLankaScope-DeElRH-E.js';
 export { a as ILankaLocator, I as ILankaLocatorConfig } from '../ALankaLocator-BUCCz0Q5.js';
 import * as GatewaysModule from '@lanka_di/Gateways';
 import { A as ALankaGateway } from '../ALankaGateway-BrVPaZN5.js';
 import * as ScenariosModule from '@lanka_di/Scenarios';
 import * as SingletonsModule from '@lanka_di/Singletons';
+export { ILankaSingletonLocatorConfig } from './singleton/lanka-singleton-locator/LankaSingletonLocator.js';
 import * as SharedStoresModule from '@lanka_di/SharedStores';
 import { A as ALankaSharedStore } from '../ALankaSharedStore-B7uepuuk.js';
 export { ILankaSharedStoreLocatorConfig } from './shared-store/lanka-shared-store-locator/LankaSharedStoreLocator.js';
-export { ILankaSingletonLocatorConfig } from './singleton/lanka-singleton-locator/LankaSingletonLocator.js';
+import '../LankaScenarioVMRegistry-CFzCpIFd.js';
+import '../ILankaScenarioVM-DKwjbIRq.js';
 import '../lankaStandardValidator-BUFnysK0.js';
 import '@standard-schema/spec';
 import '../ILankaFieldError-D5931-vT.js';
 import 'zustand/vanilla';
 
-/**
- * The singleton marker: "this class is published by the application in
- * `lankaSingletons`".
- *
- * ## Why a marker when the class is exported anyway
- *
- * The other three locators have one: a gateway extends `ALankaGateway`, a
- * scenario has a `name`, a store extends `ALankaSharedStore`. Without a marker
- * the selection is "anything that is a function with a prototype", so a stray
- * export in the barrel — a helper, a companion class, an accidental re-export —
- * becomes part of the public `lankaSingletons.*`, and a typo in a name is caught
- * at runtime on first use, far from where it was made.
- *
- * ## A base class rather than a field
- *
- * A marker field can be put on anything, an object included, and the type would
- * again stop telling a class from a non-class. Inheritance also gives TypeScript
- * something it can select on in a mapped type.
- *
- * The class is empty deliberately: all it carries is the statement "I am meant
- * for the locator".
- */
-declare abstract class ALankaSingleton {
-    /**
-     * A runtime check, for the locator, which cannot see types.
-     *
-     * Looks at the prototype chain rather than the name: names are lost to
-     * minification, and a name check would work only until the build.
-     */
-    static is(candidate: unknown): boolean;
-}
-
-/**
- * Singleton classes, read from the consumer's barrel.
- *
- * Adding one takes two steps and no registration:
- *
- * 1. write the class;
- * 2. add ONE export line to `.lanka_di/lankaSingletons.ts` at the project root.
- *
- * The type below is derived from that module's exports, so the property name
- * and the instance type appear by themselves.
- */
-
-/**
- * Turns a PascalCase class name into a camelCase property name: `UserProfile` → `userProfile`.
- */
-type TPascalToCamelCase$3<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
-/** Whether a type is a class constructor. */
-/**
- * A class marked as a singleton.
- *
- * Selecting on "is a constructor" admits anything, so a stray barrel export
- * silently becomes part of the public `lankaSingletons.*` and a typo is caught at
- * runtime on first use.
- */
-type TIsSingletonClass<T> = T extends new () => infer Instance ? Instance extends ALankaSingleton ? true : false : false;
-/**
- * Builds the singletons type from the barrel's exports.
- *
- * Derived automatically; no list has to be maintained by hand.
- */
-type TLankaSingletons = {
-    [K in keyof typeof SingletonsModule as TIsSingletonClass<(typeof SingletonsModule)[K]> extends true ? TPascalToCamelCase$3<K & string> : never]: (typeof SingletonsModule)[K] extends new () => infer Instance ? Instance : never;
-};
-
-declare const lankaSingletons: TLankaSingletons;
-
-/**
- * Shared-store classes read from the consumer's barrel.
- *
- * Adding one takes two steps and no registration:
- *
- * 1. write a class extending `ALankaSharedStore`;
- * 2. add ONE export line to `.lanka_di/lankaSharedStores.ts` at the project root.
- *
- * The type below is derived from that module's exports, so the property name
- * and the instance type appear by themselves.
- */
-
-/**
- * Turns a PascalCase class name into a camelCase property name: `RoleEditorStore` → `roleEditorStore`.
- */
-type TPascalToCamelCase$2<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
-/** Whether the type is a shared-store class. */
-type TIsSharedStoreClass<T> = T extends new () => infer Instance ? Instance extends ALankaSharedStore<object> ? true : false : false;
-/**
- * Builds the shared-store type from every export of the barrel.
- *
- * Derived automatically; no list has to be maintained by hand.
- */
-type TLankaSharedStores = {
-    [K in keyof typeof SharedStoresModule as TIsSharedStoreClass<(typeof SharedStoresModule)[K]> extends true ? TPascalToCamelCase$2<K & string> : never]: (typeof SharedStoresModule)[K] extends new () => infer Instance ? Instance : never;
-};
-
-/**
- * Access to every shared store at once.
- *
- * An `ALankaSharedStore` subclass appears here by itself once it is exported from
- * `@lanka_di/SharedStores`. The property is camelCase, the class name PascalCase.
- */
-declare const lankaSharedStores: TLankaSharedStores;
-
 /**
  * Gateway classes read from the consumer's barrel.
  *
@@ -131,7 +30,7 @@ declare const lankaSharedStores: TLankaSharedStores;
 /**
  * Turns a PascalCase class name into a camelCase property name: `UserGateway` → `userGateway`.
  */
-type TPascalToCamelCase$1<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+type TPascalToCamelCase$3<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
 /** Whether the type is a gateway class — an `ALankaGateway` subclass. */
 type TIsGatewayClass<T> = T extends new () => infer Instance ? Instance extends ALankaGateway<unknown> ? true : false : false;
 /**
@@ -140,7 +39,7 @@ type TIsGatewayClass<T> = T extends new () => infer Instance ? Instance extends
  * Derived automatically; no list has to be maintained by hand.
  */
 type TLankaGateways = {
-    [K in keyof typeof GatewaysModule as TIsGatewayClass<(typeof GatewaysModule)[K]> extends true ? TPascalToCamelCase$1<K & string> : never]: (typeof GatewaysModule)[K] extends new () => infer Instance ? Instance : never;
+    [K in keyof typeof GatewaysModule as TIsGatewayClass<(typeof GatewaysModule)[K]> extends true ? TPascalToCamelCase$3<K & string> : never]: (typeof GatewaysModule)[K] extends new () => infer Instance ? Instance : never;
 };
 
 /**
@@ -173,13 +72,13 @@ declare const lankaGateways: TLankaGateways;
 /**
  * Turns a PascalCase class name into a camelCase property name: `SessionUpdated` → `sessionUpdated`.
  */
-type TPascalToCamelCase<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+type TPascalToCamelCase$2<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
 /** Extracts the scenario name from the constructor. */
 type TExtractScenarioName<T> = T extends new () => infer Instance ? Instance extends {
     readonly name: infer N;
 } ? N extends string ? N : never : never : never;
 /** Derives the property name from a scenario constructor. */
-type TScenarioPropertyName<T> = TPascalToCamelCase<TExtractScenarioName<T>>;
+type TScenarioPropertyName<T> = TPascalToCamelCase$2<TExtractScenarioName<T>>;
 /** Whether the type is a scenario class — a constructor yielding a named instance. */
 type TIsScenarioClass<T> = T extends new () => infer Instance ? Instance extends {
     readonly name: string;
@@ -210,6 +109,38 @@ type TLankaScenarios = {
  */
 declare const lankaScenarios: TLankaScenarios;
 
+/**
+ * The singleton marker: "this class is published by the application in
+ * `lankaSingletons`".
+ *
+ * ## Why a marker when the class is exported anyway
+ *
+ * The other three locators have one: a gateway extends `ALankaGateway`, a
+ * scenario has a `name`, a store extends `ALankaSharedStore`. Without a marker
+ * the selection is "anything that is a function with a prototype", so a stray
+ * export in the barrel — a helper, a companion class, an accidental re-export —
+ * becomes part of the public `lankaSingletons.*`, and a typo in a name is caught
+ * at runtime on first use, far from where it was made.
+ *
+ * ## A base class rather than a field
+ *
+ * A marker field can be put on anything, an object included, and the type would
+ * again stop telling a class from a non-class. Inheritance also gives TypeScript
+ * something it can select on in a mapped type.
+ *
+ * The class is empty deliberately: all it carries is the statement "I am meant
+ * for the locator".
+ */
+declare abstract class ALankaSingleton {
+    /**
+     * A runtime check, for the locator, which cannot see types.
+     *
+     * Looks at the prototype chain rather than the name: names are lost to
+     * minification, and a name check would work only until the build.
+     */
+    static is(candidate: unknown): boolean;
+}
+
 /**
  * The functional style of `ALankaSingleton`: a singleton declared by a function.
  *
@@ -234,4 +165,75 @@ declare const lankaScenarios: TLankaScenarios;
  */
 declare const createLankaSingleton: <TInstance extends object>(build: () => TInstance) => new () => TInstance;
 
+/**
+ * Singleton classes, read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write the class;
+ * 2. add ONE export line to `.lanka_di/lankaSingletons.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `UserProfile` → `userProfile`.
+ */
+type TPascalToCamelCase$1<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Whether a type is a class constructor. */
+/**
+ * A class marked as a singleton.
+ *
+ * Selecting on "is a constructor" admits anything, so a stray barrel export
+ * silently becomes part of the public `lankaSingletons.*` and a typo is caught at
+ * runtime on first use.
+ */
+type TIsSingletonClass<T> = T extends new () => infer Instance ? Instance extends ALankaSingleton ? true : false : false;
+/**
+ * Builds the singletons type from the barrel's exports.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaSingletons = {
+    [K in keyof typeof SingletonsModule as TIsSingletonClass<(typeof SingletonsModule)[K]> extends true ? TPascalToCamelCase$1<K & string> : never]: (typeof SingletonsModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+declare const lankaSingletons: TLankaSingletons;
+
+/**
+ * Shared-store classes read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write a class extending `ALankaSharedStore`;
+ * 2. add ONE export line to `.lanka_di/lankaSharedStores.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `RoleEditorStore` → `roleEditorStore`.
+ */
+type TPascalToCamelCase<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Whether the type is a shared-store class. */
+type TIsSharedStoreClass<T> = T extends new () => infer Instance ? Instance extends ALankaSharedStore<object> ? true : false : false;
+/**
+ * Builds the shared-store type from every export of the barrel.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaSharedStores = {
+    [K in keyof typeof SharedStoresModule as TIsSharedStoreClass<(typeof SharedStoresModule)[K]> extends true ? TPascalToCamelCase<K & string> : never]: (typeof SharedStoresModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+/**
+ * Access to every shared store at once.
+ *
+ * An `ALankaSharedStore` subclass appears here by itself once it is exported from
+ * `@lanka_di/SharedStores`. The property is camelCase, the class name PascalCase.
+ */
+declare const lankaSharedStores: TLankaSharedStores;
+
 export { ALankaSingleton, type TLankaGateways, type TLankaScenarios, type TLankaSharedStores, type TLankaSingletons, createLankaSingleton, lankaGateways, lankaScenarios, lankaSharedStores, lankaSingletons };