lanka 2.2.0 → 2.2.1

package/dist/{chunk-MLKTN4OV.js.map → chunk-XTVEHYIZ.js.map}

@@ -1 +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\nexport function setActiveLankaRuntime(runtime: ILankaRuntime | null): void {\n\tactive = runtime;\n\n\tif (runtime) lankaCopies.noteActivation(runtime.getFlags().isDevelopment === true);\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 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) {\n\t\tthrow new Error(\n\t\t\tresolveRuntime\n\t\t\t\t? \"lanka has no instance for this call. A runtime resolver is installed and \" +\n\t\t\t\t\t\t\"answered with none, which on a server means the code ran outside a \" +\n\t\t\t\t\t\t\"request scope — start one, or do this work inside it.\"\n\t\t\t\t: lankaCopies.anotherIsRunning()\n\t\t\t\t\t? \"lanka used before an instance existed in THIS copy of the package, \" +\n\t\t\t\t\t\t\"while another copy of lanka on this page has one. The module calling \" +\n\t\t\t\t\t\t\"it bundled its own lanka; ship one — a singleton in Module \" +\n\t\t\t\t\t\t\"Federation's `shared`, an import map, or `lanka` external in its build.\"\n\t\t\t\t\t: \"lanka used before an instance existed. Call createLanka({ host }) and \" +\n\t\t\t\t\t\t\"activate it.\",\n\t\t);\n\t}\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;AAExC,SAAS,sBAAsB,SAAqC;AAC1E,WAAS;AAET,MAAI,QAAS,aAAY,eAAe,QAAQ,SAAS,EAAE,kBAAkB,IAAI;AAClF;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;AASO,SAAS,uBAAsC;AAKrD,QAAM,UAAU,iBAAiB,eAAe,IAAI;AAEpD,MAAI,CAAC,SAAS;AACb,UAAM,IAAI;AAAA,MACT,iBACG,2MAGA,YAAY,iBAAiB,IAC5B,oRAIA;AAAA,IAEL;AAAA,EACD;AAEA,SAAO;AACR;","names":[]}
+{"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-BZNDUUTA.js";
+} from "../chunk-JGJBFELR.js";
 import {
   getLankaFlags
-} from "../chunk-FR2FRJME.js";
-import "../chunk-MLKTN4OV.js";
+} from "../chunk-SP5OUTWF.js";
+import "../chunk-XTVEHYIZ.js";
 export {
   createLankaHost,
   getLankaFlags,

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

@@ -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/errors/index.js

@@ -1,13 +1,13 @@
 import {
   createLankaApiError,
   handleLankaApiError
-} from "../chunk-HYT5NSIB.js";
+} from "../chunk-DKLOCKS4.js";
 import "../chunk-J5LA3Q6D.js";
 import {
   LankaError
 } from "../chunk-G32H73QY.js";
-import "../chunk-BZNDUUTA.js";
-import "../chunk-MLKTN4OV.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

@@ -1,32 +1,32 @@
 import {
   lankaStandardValidator
 } from "../chunk-HVSQOMRE.js";
+import "../chunk-CRIRTOLB.js";
 import {
   composeLankaRequestMiddleware
 } from "../chunk-YR4MZXMU.js";
-import "../chunk-CRIRTOLB.js";
 import {
   lankaHttpInFlight
-} from "../chunk-NPJSZLTB.js";
+} from "../chunk-NMFNEVNE.js";
 import {
   handleLankaApiError
-} from "../chunk-HYT5NSIB.js";
+} from "../chunk-DKLOCKS4.js";
 import "../chunk-J5LA3Q6D.js";
 import {
   LankaError
 } from "../chunk-G32H73QY.js";
 import {
   getLankaHost
-} from "../chunk-BZNDUUTA.js";
+} from "../chunk-JGJBFELR.js";
 import {
   lankaLogger
-} from "../chunk-6TNWBT6T.js";
+} from "../chunk-AMLUKB6A.js";
 import {
   getLankaFlags
-} from "../chunk-FR2FRJME.js";
+} from "../chunk-SP5OUTWF.js";
 import {
   getActiveRuntime
-} from "../chunk-MLKTN4OV.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-DxKZkmWe.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';

package/dist/index.js

@@ -6,33 +6,33 @@ import {
   createLanka,
   resetActiveLanka,
   startLanka
-} from "./chunk-UX4A7TBG.js";
-import "./chunk-3OQ3JZGT.js";
+} from "./chunk-532WVMAF.js";
+import "./chunk-M4BK6GBV.js";
 import "./chunk-BMF4TM2Z.js";
-import "./chunk-IB2LRYDK.js";
-import "./chunk-JX47U5DC.js";
-import "./chunk-RZGBLXXL.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-NPJSZLTB.js";
+import "./chunk-NMFNEVNE.js";
 import {
   LankaError
 } from "./chunk-G32H73QY.js";
 import {
   getLankaHost
-} from "./chunk-BZNDUUTA.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-6TNWBT6T.js";
+} from "./chunk-AMLUKB6A.js";
 import {
   getLankaFlags
-} from "./chunk-FR2FRJME.js";
-import "./chunk-MLKTN4OV.js";
+} from "./chunk-SP5OUTWF.js";
+import "./chunk-XTVEHYIZ.js";
 export {
   ALankaPlugin,
   LankaError,

package/dist/locator/index.d.ts

@@ -4,10 +4,10 @@ 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';
@@ -15,109 +15,6 @@ 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.
  *
@@ -133,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;
 /**
@@ -142,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;
 };
 
 /**
@@ -175,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;
@@ -212,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.
  *
@@ -236,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 };

package/dist/locator/index.js

@@ -1,15 +1,9 @@
 import {
-  createLankaLocatorProxy,
-  lankaSharedStores,
-  lankaSingletons
-} from "../chunk-R365QEN2.js";
-import "../chunk-3R2NO47A.js";
-import "../chunk-24MUFFHF.js";
-import "../chunk-JZJ6GXX3.js";
-import "../chunk-N3275IPH.js";
+  createLankaLocatorProxy
+} from "../chunk-2ICKGQXS.js";
 import {
   requireActiveRuntime
-} from "../chunk-MLKTN4OV.js";
+} from "../chunk-XTVEHYIZ.js";
 
 // src/locator/gateway/_facades/lanka-gateways/lankaGateways.ts
 var gatewayLocator = {
@@ -59,6 +53,38 @@ var createLankaSingleton = (build) => {
   }
   return FunctionalSingleton;
 };
+
+// src/locator/singleton/_facades/lanka-singletons/lankaSingletons.ts
+var singletonLocator = {
+  get: (propertyName) => requireActiveRuntime().locators.singletons.get(propertyName)
+};
+var lankaSingletons = createLankaLocatorProxy({
+  locator: singletonLocator,
+  protectedProperties: [
+    "clearCache",
+    "register",
+    "registerInstance",
+    "unregister",
+    "isRegistered"
+  ],
+  errorPrefix: "Cannot access singleton"
+});
+
+// src/locator/shared-store/_facades/lanka-shared-stores/lankaSharedStores.ts
+var sharedStoreLocator = {
+  get: (propertyName) => requireActiveRuntime().locators.sharedStores.get(propertyName)
+};
+var lankaSharedStores = createLankaLocatorProxy({
+  locator: sharedStoreLocator,
+  protectedProperties: [
+    "clearCache",
+    "register",
+    "registerInstance",
+    "unregister",
+    "isRegistered"
+  ],
+  errorPrefix: "Cannot access shared store"
+});
 export {
   ALankaSingleton,
   createLankaSingleton,

package/dist/locator/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/locator/gateway/_facades/lanka-gateways/lankaGateways.ts","../../src/locator/scenario/_facades/lanka-scenarios/lankaScenarios.ts","../../src/locator/singleton/_abstractions/lanka-singleton/ALankaSingleton.ts","../../src/locator/singleton/_factories/create-lanka-singleton/createLankaSingleton.ts"],"sourcesContent":["import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport type { TLankaGateways } from \"../../_types/TLankaGateways\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\nimport type { ALankaGateway } from \"../../../../gateway/_abstractions/lanka-gateway/ALankaGateway\";\n\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state would let two\n * frameworks in one process resolve the same gateway. The proxy stays at module\n * level because it has hundreds of call sites; only the cache moved.\n */\nconst gatewayLocator: ILankaLocator<ALankaGateway<unknown>> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.gateways.get(propertyName),\n};\n\n/**\n * Access to every gateway at once.\n *\n * An `ALankaGateway` subclass appears here by itself. The property is camelCase,\n * the gateway name is PascalCase.\n *\n * ```ts\n * import { lankaGateways } from \"lanka\";\n *\n * const user = await lankaGateways.userGateway.getById(1);\n * const list = await lankaGateways.companyGateway.getList({ page: 1 });\n * ```\n */\nexport const lankaGateways = createLankaLocatorProxy<ALankaGateway<unknown>, TLankaGateways>({\n\tlocator: gatewayLocator,\n\tprotectedProperties: [\"clearCache\"],\n\terrorPrefix: \"Cannot access gateway\",\n});\n","import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\nimport type { ILankaScenario } from \"../../../../scenario/_interfaces/ILankaScenario\";\nimport { TLankaScenarios } from \"../../_types/TLankaScenarios\";\n\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state would let two\n * frameworks in one process resolve the same scenario. The proxy stays at module\n * level because it has hundreds of call sites; only the cache moved.\n */\nconst scenarioLocator: ILankaLocator<ILankaScenario<unknown>> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.scenarios.get(propertyName),\n};\n\n/**\n * Access to every scenario at once.\n *\n * An `ALankaScenario` subclass appears here by itself. The property is camelCase,\n * the scenario name is PascalCase.\n *\n * ```ts\n * import { lankaScenarios } from \"lanka\";\n *\n * lankaScenarios.sessionUpdated.trigger({ user });\n * lankaScenarios.usersListRefresh.trigger({ reason: \"create\" });\n *\n * lankaScenarios.usersListRefresh.subscribe((data) => { ... });\n * ```\n */\nexport const lankaScenarios = createLankaLocatorProxy<ILankaScenario<unknown>, TLankaScenarios>({\n\tlocator: scenarioLocator,\n\terrorPrefix: \"Cannot access scenario\",\n});\n","/**\n * The singleton marker: \"this class is published by the application in\n * `lankaSingletons`\".\n *\n * ## Why a marker when the class is exported anyway\n *\n * The other three locators have one: a gateway extends `ALankaGateway`, a\n * scenario has a `name`, a store extends `ALankaSharedStore`. Without a marker\n * the selection is \"anything that is a function with a prototype\", so a stray\n * export in the barrel — a helper, a companion class, an accidental re-export —\n * becomes part of the public `lankaSingletons.*`, and a typo in a name is caught\n * at runtime on first use, far from where it was made.\n *\n * ## A base class rather than a field\n *\n * A marker field can be put on anything, an object included, and the type would\n * again stop telling a class from a non-class. Inheritance also gives TypeScript\n * something it can select on in a mapped type.\n *\n * The class is empty deliberately: all it carries is the statement \"I am meant\n * for the locator\".\n */\nexport abstract class ALankaSingleton {\n\t/**\n\t * A runtime check, for the locator, which cannot see types.\n\t *\n\t * Looks at the prototype chain rather than the name: names are lost to\n\t * minification, and a name check would work only until the build.\n\t */\n\tstatic is(candidate: unknown): boolean {\n\t\tif (typeof candidate !== \"function\") return false;\n\n\t\tlet proto: unknown = Object.getPrototypeOf(candidate) as unknown;\n\t\twhile (typeof proto === \"function\") {\n\t\t\tif (proto === ALankaSingleton) return true;\n\t\t\tproto = Object.getPrototypeOf(proto) as unknown;\n\t\t}\n\t\treturn false;\n\t}\n}\n","import { ALankaSingleton } from \"../../_abstractions/lanka-singleton/ALankaSingleton\";\n\n/**\n * The functional style of `ALankaSingleton`: a singleton declared by a function.\n *\n * A singleton is a role — an application writes many — and this is the same role\n * the class style declares by extending the marker. What comes back IS a subclass\n * of `ALankaSingleton`, so the locator discovers it in the consumer's barrel,\n * builds it on first use and caches it, exactly as it does a hand-written class.\n *\n * ```ts\n * export const PlaygroundClock = createLankaSingleton(() => ({\n * \tnow: () => Date.now(),\n * }));\n * ```\n *\n * The result is exported under a PascalCase name because it is a class: the\n * locator resolves `lankaSingletons.playgroundClock` by that export name, and a\n * camelCase one would read as the instance while being the constructor.\n *\n * The builder runs at first resolution, not here — a singleton declared in a\n * module body must not touch a runtime that does not exist yet. Canon:\n * `skills/parity/SKILL.md`.\n */\nexport const createLankaSingleton = <TInstance extends object>(\n\tbuild: () => TInstance,\n): new () => TInstance => {\n\tclass FunctionalSingleton extends ALankaSingleton {\n\t\tpublic constructor() {\n\t\t\tsuper();\n\n\t\t\t// A constructor answering an object is what makes the two styles one\n\t\t\t// implementation: the locator constructs a marked class either way, and\n\t\t\t// what it gets back is what the builder returned.\n\t\t\treturn build();\n\t\t}\n\t}\n\n\treturn FunctionalSingleton as unknown as new () => TInstance;\n};\n"],"mappings":";;;;;;;;;;;;;;AAaA,IAAM,iBAAwD;AAAA,EAC7D,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,SAAS,IAAI,YAAY;AACzF;AAeO,IAAM,gBAAgB,wBAAgE;AAAA,EAC5F,SAAS;AAAA,EACT,qBAAqB,CAAC,YAAY;AAAA,EAClC,aAAa;AACd,CAAC;;;ACrBD,IAAM,kBAA0D;AAAA,EAC/D,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,UAAU,IAAI,YAAY;AAC1F;AAiBO,IAAM,iBAAiB,wBAAkE;AAAA,EAC/F,SAAS;AAAA,EACT,aAAa;AACd,CAAC;;;ACbM,IAAe,kBAAf,MAAe,iBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrC,OAAO,GAAG,WAA6B;AACtC,QAAI,OAAO,cAAc,WAAY,QAAO;AAE5C,QAAI,QAAiB,OAAO,eAAe,SAAS;AACpD,WAAO,OAAO,UAAU,YAAY;AACnC,UAAI,UAAU,iBAAiB,QAAO;AACtC,cAAQ,OAAO,eAAe,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACR;AACD;;;ACfO,IAAM,uBAAuB,CACnC,UACyB;AAAA,EACzB,MAAM,4BAA4B,gBAAgB;AAAA,IAC1C,cAAc;AACpB,YAAM;AAKN,aAAO,MAAM;AAAA,IACd;AAAA,EACD;AAEA,SAAO;AACR;","names":[]}
+{"version":3,"sources":["../../src/locator/gateway/_facades/lanka-gateways/lankaGateways.ts","../../src/locator/scenario/_facades/lanka-scenarios/lankaScenarios.ts","../../src/locator/singleton/_abstractions/lanka-singleton/ALankaSingleton.ts","../../src/locator/singleton/_factories/create-lanka-singleton/createLankaSingleton.ts","../../src/locator/singleton/_facades/lanka-singletons/lankaSingletons.ts","../../src/locator/shared-store/_facades/lanka-shared-stores/lankaSharedStores.ts"],"sourcesContent":["import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport type { TLankaGateways } from \"../../_types/TLankaGateways\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\nimport type { ALankaGateway } from \"../../../../gateway/_abstractions/lanka-gateway/ALankaGateway\";\n\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state would let two\n * frameworks in one process resolve the same gateway. The proxy stays at module\n * level because it has hundreds of call sites; only the cache moved.\n */\nconst gatewayLocator: ILankaLocator<ALankaGateway<unknown>> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.gateways.get(propertyName),\n};\n\n/**\n * Access to every gateway at once.\n *\n * An `ALankaGateway` subclass appears here by itself. The property is camelCase,\n * the gateway name is PascalCase.\n *\n * ```ts\n * import { lankaGateways } from \"lanka\";\n *\n * const user = await lankaGateways.userGateway.getById(1);\n * const list = await lankaGateways.companyGateway.getList({ page: 1 });\n * ```\n */\nexport const lankaGateways = createLankaLocatorProxy<ALankaGateway<unknown>, TLankaGateways>({\n\tlocator: gatewayLocator,\n\tprotectedProperties: [\"clearCache\"],\n\terrorPrefix: \"Cannot access gateway\",\n});\n","import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\nimport type { ILankaScenario } from \"../../../../scenario/_interfaces/ILankaScenario\";\nimport { TLankaScenarios } from \"../../_types/TLankaScenarios\";\n\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state would let two\n * frameworks in one process resolve the same scenario. The proxy stays at module\n * level because it has hundreds of call sites; only the cache moved.\n */\nconst scenarioLocator: ILankaLocator<ILankaScenario<unknown>> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.scenarios.get(propertyName),\n};\n\n/**\n * Access to every scenario at once.\n *\n * An `ALankaScenario` subclass appears here by itself. The property is camelCase,\n * the scenario name is PascalCase.\n *\n * ```ts\n * import { lankaScenarios } from \"lanka\";\n *\n * lankaScenarios.sessionUpdated.trigger({ user });\n * lankaScenarios.usersListRefresh.trigger({ reason: \"create\" });\n *\n * lankaScenarios.usersListRefresh.subscribe((data) => { ... });\n * ```\n */\nexport const lankaScenarios = createLankaLocatorProxy<ILankaScenario<unknown>, TLankaScenarios>({\n\tlocator: scenarioLocator,\n\terrorPrefix: \"Cannot access scenario\",\n});\n","/**\n * The singleton marker: \"this class is published by the application in\n * `lankaSingletons`\".\n *\n * ## Why a marker when the class is exported anyway\n *\n * The other three locators have one: a gateway extends `ALankaGateway`, a\n * scenario has a `name`, a store extends `ALankaSharedStore`. Without a marker\n * the selection is \"anything that is a function with a prototype\", so a stray\n * export in the barrel — a helper, a companion class, an accidental re-export —\n * becomes part of the public `lankaSingletons.*`, and a typo in a name is caught\n * at runtime on first use, far from where it was made.\n *\n * ## A base class rather than a field\n *\n * A marker field can be put on anything, an object included, and the type would\n * again stop telling a class from a non-class. Inheritance also gives TypeScript\n * something it can select on in a mapped type.\n *\n * The class is empty deliberately: all it carries is the statement \"I am meant\n * for the locator\".\n */\nexport abstract class ALankaSingleton {\n\t/**\n\t * A runtime check, for the locator, which cannot see types.\n\t *\n\t * Looks at the prototype chain rather than the name: names are lost to\n\t * minification, and a name check would work only until the build.\n\t */\n\tstatic is(candidate: unknown): boolean {\n\t\tif (typeof candidate !== \"function\") return false;\n\n\t\tlet proto: unknown = Object.getPrototypeOf(candidate) as unknown;\n\t\twhile (typeof proto === \"function\") {\n\t\t\tif (proto === ALankaSingleton) return true;\n\t\t\tproto = Object.getPrototypeOf(proto) as unknown;\n\t\t}\n\t\treturn false;\n\t}\n}\n","import { ALankaSingleton } from \"../../_abstractions/lanka-singleton/ALankaSingleton\";\n\n/**\n * The functional style of `ALankaSingleton`: a singleton declared by a function.\n *\n * A singleton is a role — an application writes many — and this is the same role\n * the class style declares by extending the marker. What comes back IS a subclass\n * of `ALankaSingleton`, so the locator discovers it in the consumer's barrel,\n * builds it on first use and caches it, exactly as it does a hand-written class.\n *\n * ```ts\n * export const PlaygroundClock = createLankaSingleton(() => ({\n * \tnow: () => Date.now(),\n * }));\n * ```\n *\n * The result is exported under a PascalCase name because it is a class: the\n * locator resolves `lankaSingletons.playgroundClock` by that export name, and a\n * camelCase one would read as the instance while being the constructor.\n *\n * The builder runs at first resolution, not here — a singleton declared in a\n * module body must not touch a runtime that does not exist yet. Canon:\n * `skills/parity/SKILL.md`.\n */\nexport const createLankaSingleton = <TInstance extends object>(\n\tbuild: () => TInstance,\n): new () => TInstance => {\n\tclass FunctionalSingleton extends ALankaSingleton {\n\t\tpublic constructor() {\n\t\t\tsuper();\n\n\t\t\t// A constructor answering an object is what makes the two styles one\n\t\t\t// implementation: the locator constructs a marked class either way, and\n\t\t\t// what it gets back is what the builder returned.\n\t\t\treturn build();\n\t\t}\n\t}\n\n\treturn FunctionalSingleton as unknown as new () => TInstance;\n};\n","import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport type { TLankaSingletons } from \"../../../_types/TLankaSingletons\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\n\n/**\n * Access to every singleton at once.\n *\n * A class appears here by itself as soon as the consumer's barrel exports it.\n * The property is camelCase, the class name PascalCase.\n *\n * ```ts\n * import { lankaSingletons } from \"lanka\";\n *\n * const profile = lankaSingletons.userProfile;\n * ```\n *\n * `LankaSingletonLocator` itself registers a class or a ready object by hand —\n * for tests and for objects that arrive already built. Those methods are NOT\n * called through this proxy: `registerSingleton`,\n * `registerSingletonInstance`, `unregisterSingleton`, `isRegistered` and\n * `clearCache` are closed here deliberately, or reaching for them would read as\n * a request for a singleton by that name and the failure would come from the\n * wrong place.\n */\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state means two\n * frameworks in one process resolve the same gateway. The proxy stays in\n * place; what moved is the cache.\n */\nconst singletonLocator: ILankaLocator<unknown> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.singletons.get(propertyName),\n};\n\nexport const lankaSingletons = createLankaLocatorProxy<unknown, TLankaSingletons>({\n\tlocator: singletonLocator,\n\tprotectedProperties: [\n\t\t\"clearCache\",\n\t\t\"register\",\n\t\t\"registerInstance\",\n\t\t\"unregister\",\n\t\t\"isRegistered\",\n\t],\n\terrorPrefix: \"Cannot access singleton\",\n});\n","import { requireActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaLocator } from \"../../../_interfaces/ILankaLocator\";\nimport { createLankaLocatorProxy } from \"../../../_factories/create-lanka-locator-proxy/createLankaLocatorProxy\";\nimport { ALankaSharedStore } from \"../../../../viewmodel/_abstractions/lanka-shared-store/ALankaSharedStore\";\nimport type { TLankaSharedStores } from \"../../_types/TLankaSharedStores\";\n\n/**\n * The locator comes from the active instance rather than being created here.\n *\n * The cache of resolved objects is state, and module-level state would let two\n * frameworks in one process resolve the same store. The proxy stays at module\n * level because it has hundreds of call sites; only the cache moved.\n */\nconst sharedStoreLocator: ILankaLocator<ALankaSharedStore<object>> = {\n\tget: (propertyName: string) => requireActiveRuntime().locators.sharedStores.get(propertyName),\n};\n\n/**\n * Access to every shared store at once.\n *\n * An `ALankaSharedStore` subclass appears here by itself once it is exported from\n * `@lanka_di/SharedStores`. The property is camelCase, the class name PascalCase.\n */\nexport const lankaSharedStores = createLankaLocatorProxy<\n\tALankaSharedStore<object>,\n\tTLankaSharedStores\n>({\n\tlocator: sharedStoreLocator,\n\tprotectedProperties: [\n\t\t\"clearCache\",\n\t\t\"register\",\n\t\t\"registerInstance\",\n\t\t\"unregister\",\n\t\t\"isRegistered\",\n\t],\n\terrorPrefix: \"Cannot access shared store\",\n});\n"],"mappings":";;;;;;;;AAaA,IAAM,iBAAwD;AAAA,EAC7D,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,SAAS,IAAI,YAAY;AACzF;AAeO,IAAM,gBAAgB,wBAAgE;AAAA,EAC5F,SAAS;AAAA,EACT,qBAAqB,CAAC,YAAY;AAAA,EAClC,aAAa;AACd,CAAC;;;ACrBD,IAAM,kBAA0D;AAAA,EAC/D,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,UAAU,IAAI,YAAY;AAC1F;AAiBO,IAAM,iBAAiB,wBAAkE;AAAA,EAC/F,SAAS;AAAA,EACT,aAAa;AACd,CAAC;;;ACbM,IAAe,kBAAf,MAAe,iBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrC,OAAO,GAAG,WAA6B;AACtC,QAAI,OAAO,cAAc,WAAY,QAAO;AAE5C,QAAI,QAAiB,OAAO,eAAe,SAAS;AACpD,WAAO,OAAO,UAAU,YAAY;AACnC,UAAI,UAAU,iBAAiB,QAAO;AACtC,cAAQ,OAAO,eAAe,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACR;AACD;;;ACfO,IAAM,uBAAuB,CACnC,UACyB;AAAA,EACzB,MAAM,4BAA4B,gBAAgB;AAAA,IAC1C,cAAc;AACpB,YAAM;AAKN,aAAO,MAAM;AAAA,IACd;AAAA,EACD;AAEA,SAAO;AACR;;;ACPA,IAAM,mBAA2C;AAAA,EAChD,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,WAAW,IAAI,YAAY;AAC3F;AAEO,IAAM,kBAAkB,wBAAmD;AAAA,EACjF,SAAS;AAAA,EACT,qBAAqB;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AAAA,EACA,aAAa;AACd,CAAC;;;ACjCD,IAAM,qBAA+D;AAAA,EACpE,KAAK,CAAC,iBAAyB,qBAAqB,EAAE,SAAS,aAAa,IAAI,YAAY;AAC7F;AAQO,IAAM,oBAAoB,wBAG/B;AAAA,EACD,SAAS;AAAA,EACT,qBAAqB;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AAAA,EACA,aAAa;AACd,CAAC;","names":[]}

package/dist/locator/scenario/lanka-scenario-locator/LankaScenarioLocator.js

@@ -1,11 +1,11 @@
 import {
   LankaScenarioLocator
-} from "../../../chunk-IB2LRYDK.js";
-import "../../../chunk-RZGBLXXL.js";
+} from "../../../chunk-EH5WZSRJ.js";
 import "../../../chunk-N3275IPH.js";
-import "../../../chunk-6TNWBT6T.js";
-import "../../../chunk-FR2FRJME.js";
-import "../../../chunk-MLKTN4OV.js";
+import "../../../chunk-L27FF2IH.js";
+import "../../../chunk-AMLUKB6A.js";
+import "../../../chunk-SP5OUTWF.js";
+import "../../../chunk-XTVEHYIZ.js";
 export {
   LankaScenarioLocator
 };

package/dist/logger/index.js

@@ -1,9 +1,9 @@
 import {
   LankaLogger,
   lankaLogger
-} from "../chunk-6TNWBT6T.js";
-import "../chunk-FR2FRJME.js";
-import "../chunk-MLKTN4OV.js";
+} from "../chunk-AMLUKB6A.js";
+import "../chunk-SP5OUTWF.js";
+import "../chunk-XTVEHYIZ.js";
 export {
   LankaLogger,
   lankaLogger

package/dist/mock/index.js

@@ -1,10 +1,10 @@
 import {
   lankaLogger
-} from "../chunk-6TNWBT6T.js";
+} from "../chunk-AMLUKB6A.js";
 import {
   getLankaFlags
-} from "../chunk-FR2FRJME.js";
-import "../chunk-MLKTN4OV.js";
+} from "../chunk-SP5OUTWF.js";
+import "../chunk-XTVEHYIZ.js";
 
 // src/_internal/sleep.ts
 var sleep = (ms = 300) => {