lanka 2.0.0 → 2.1.0

package/dist/locator/shared-store/lanka-shared-store-locator/LankaSharedStoreLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/locator/singleton/lanka-singleton-locator/LankaSingletonLocator.d.ts

@@ -0,0 +1,30 @@
+import { A as ALankaLocator } from '../../../ALankaLocator-BUCCz0Q5.js';
+
+/**
+ * LankaSingletonLocator configuration.
+ */
+interface ILankaSingletonLocatorConfig {
+    /** The module holding singleton classes — the consumer's barrel. */
+    singletonIndexModule?: Record<string, unknown>;
+}
+/**
+ * Resolves singletons by property name (camelCase) or class name (PascalCase),
+ * constructing them on first use and caching them.
+ *
+ * A class arrives either from the consumer's barrel or registered by hand — the
+ * latter for tests and for objects that arrive already built.
+ */
+declare class LankaSingletonLocator extends ALankaLocator<unknown> {
+    private readonly singletonIndexModule?;
+    constructor(config?: ILankaSingletonLocatorConfig);
+    /**
+     * Creates a NEW service object, bypassing the locator's cache.
+     *
+     * For scopes: they take the class from here and set the lifetime themselves.
+     * The root cache is untouched — otherwise the first resolution inside a scope
+     * would replace the application's root object.
+     */
+    createScopedInstance(className: string, propertyName: string): unknown;
+}
+
+export { type ILankaSingletonLocatorConfig, LankaSingletonLocator };

package/dist/locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js

@@ -0,0 +1,9 @@
+import {
+  LankaSingletonLocator
+} from "../../../chunk-24MUFFHF.js";
+import "../../../chunk-JZJ6GXX3.js";
+import "../../../chunk-N3275IPH.js";
+export {
+  LankaSingletonLocator
+};
+//# sourceMappingURL=LankaSingletonLocator.js.map

package/dist/locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/scenario/index.d.ts

@@ -1,6 +1,7 @@
-import { a as ILankaScenario, T as TLankaReplayRequest, b as ILankaEventMetadata, c as TLankaEventBusMiddleware, d as TLankaEventBusObserver, e as ILankaEventLog, I as ILankaScenarioVM } from '../ILankaScenarioVM-DpKFL3iE.js';
-export { f as ILankaEventBusOutcome, g as TLankaEventBusDecision } from '../ILankaScenarioVM-DpKFL3iE.js';
-export { I as ILankaScenarioMetadata } from '../ILankaScenarioMetadata-Dj4GCqmX.js';
+import { I as ILankaScenario, T as TLankaReplayRequest, a as ILankaEventMetadata, b as TLankaEventBusMiddleware, c as TLankaEventBusObserver, d as ILankaEventLog } from '../ILankaScenario-DQd9ZfUw.js';
+export { e as ILankaEventBusOutcome, f as TLankaEventBusDecision } from '../ILankaScenario-DQd9ZfUw.js';
+import { I as ILankaScenarioVM } from '../ILankaScenarioVM-DKwjbIRq.js';
+export { I as ILankaScenarioMetadata } from '../ILankaScenarioMetadata-BsDp0Bzm.js';
 
 /**
  * The base of a scenario — a named unit of coordination over the event bus.

package/dist/scenario/index.js

@@ -1,8 +1,10 @@
 import {
-  ALankaScenario,
-  lankaEventBus,
   lankaScenarioBootstrap
-} from "../chunk-EYDMBI5T.js";
+} from "../chunk-MKKMTLOY.js";
+import {
+  ALankaScenario,
+  lankaEventBus
+} from "../chunk-NWEHOMTS.js";
 import "../chunk-FII3PW2G.js";
 import "../chunk-7DQUF2QR.js";
 import "../chunk-XGMXT4XZ.js";

package/dist/scenario/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/scenario/_factories/create-lanka-scenario/createLankaScenario.ts"],"sourcesContent":["import { ALankaScenario } from \"../../_abstractions/lanka-scenario/ALankaScenario\";\nimport type { ILankaScenario } from \"../../_interfaces/ILankaScenario\";\n\n/** What a scenario is: three names and nothing else. */\nexport interface ILankaScenarioConfig {\n\t/** The scenario's name, and the key it is found by. */\n\tname: string;\n\t/** The event type on the bus. */\n\teventType: string;\n\t/** The event data's type name — for the bus metadata. */\n\tdataTypeName: string;\n\t/** Opts out of self-registration, as `skipAutoRegistration` does on a class. */\n\tskipAutoRegistration?: boolean;\n}\n\n/**\n * A scenario, without writing a class whose body is data.\n *\n * The class style is right where a scenario has behaviour — an `initialize` that\n * warms something, a `cleanup` that lets go. Most have neither: in the two\n * applications this framework grew out of, every scenario is a class holding\n * three `readonly` fields and nothing else.\n *\n * One implementation: this builds a subclass of `ALankaScenario`, so\n * self-registration, `trigger` and `subscribe` are the same code either way.\n */\nexport const createLankaScenario = <TData = void>(\n\tconfig: ILankaScenarioConfig,\n): ILankaScenario<TData> => {\n\tclass FunctionalScenario extends ALankaScenario<TData> {\n\t\tpublic static override skipAutoRegistration = config.skipAutoRegistration ?? false;\n\n\t\tpublic readonly name = config.name;\n\t\tpublic readonly eventType = config.eventType;\n\t\tpublic readonly dataTypeName = config.dataTypeName;\n\t}\n\n\treturn new FunctionalScenario();\n};\n"],"mappings":";;;;;;;;;;AA0BO,IAAM,sBAAsB,CAClC,WAC2B;AAAA,EAC3B,MAAM,2BAA2B,eAAsB;AAAA,IACtD,OAAuB,uBAAuB,OAAO,wBAAwB;AAAA,IAE7D,OAAO,OAAO;AAAA,IACd,YAAY,OAAO;AAAA,IACnB,eAAe,OAAO;AAAA,EACvC;AAEA,SAAO,IAAI,mBAAmB;AAC/B;","names":[]}
+{"version":3,"sources":["../../src/scenario/_factories/create-lanka-scenario/createLankaScenario.ts"],"sourcesContent":["import { ALankaScenario } from \"../../_abstractions/lanka-scenario/ALankaScenario\";\nimport type { ILankaScenario } from \"../../_interfaces/ILankaScenario\";\n\n/** What a scenario is: three names and nothing else. */\nexport interface ILankaScenarioConfig {\n\t/** The scenario's name, and the key it is found by. */\n\tname: string;\n\t/** The event type on the bus. */\n\teventType: string;\n\t/** The event data's type name — for the bus metadata. */\n\tdataTypeName: string;\n\t/** Opts out of self-registration, as `skipAutoRegistration` does on a class. */\n\tskipAutoRegistration?: boolean;\n}\n\n/**\n * A scenario, without writing a class whose body is data.\n *\n * The class style is right where a scenario has behaviour — an `initialize` that\n * warms something, a `cleanup` that lets go. Most have neither: in the two\n * applications this framework grew out of, every scenario is a class holding\n * three `readonly` fields and nothing else.\n *\n * One implementation: this builds a subclass of `ALankaScenario`, so\n * self-registration, `trigger` and `subscribe` are the same code either way.\n */\nexport const createLankaScenario = <TData = void>(\n\tconfig: ILankaScenarioConfig,\n): ILankaScenario<TData> => {\n\tclass FunctionalScenario extends ALankaScenario<TData> {\n\t\tpublic static override skipAutoRegistration = config.skipAutoRegistration ?? false;\n\n\t\tpublic readonly name = config.name;\n\t\tpublic readonly eventType = config.eventType;\n\t\tpublic readonly dataTypeName = config.dataTypeName;\n\t}\n\n\treturn new FunctionalScenario();\n};\n"],"mappings":";;;;;;;;;;;;AA0BO,IAAM,sBAAsB,CAClC,WAC2B;AAAA,EAC3B,MAAM,2BAA2B,eAAsB;AAAA,IACtD,OAAuB,uBAAuB,OAAO,wBAAwB;AAAA,IAE7D,OAAO,OAAO;AAAA,IACd,YAAY,OAAO;AAAA,IACnB,eAAe,OAAO;AAAA,EACvC;AAEA,SAAO,IAAI,mBAAmB;AAC/B;","names":[]}

package/dist/stream/index.d.ts

@@ -1,19 +1,24 @@
-import { c as ILankaPlugin } from '../createLanka-x4oSMs7P.js';
-import '../createLankaScope-DomNbEvb.js';
-import '../LankaSharedStoreLocator-jsz_gnUm.js';
-import '../ALankaSharedStore-B7uepuuk.js';
-import 'zustand/vanilla';
-import '../activeRuntime-BO-qY0yY.js';
-import '../ILankaScenarioVM-DpKFL3iE.js';
-import '../LankaScenarioLocator-Dki2Es3O.js';
-import '../ILankaScenarioMetadata-Dj4GCqmX.js';
+import { c as ILankaPlugin } from '../createLanka-DvUGu9Hl.js';
+import '../createLankaScope-CVoV0EwO.js';
+import '../locator/singleton/lanka-singleton-locator/LankaSingletonLocator.js';
+import '../ALankaLocator-BUCCz0Q5.js';
+import '../activeRuntime-ByucLPhj.js';
+import '../ILankaScenario-DQd9ZfUw.js';
+import '../LankaScenarioVMRegistry-DySAOaj2.js';
+import '../ILankaScenarioVM-DKwjbIRq.js';
+import '../ILankaScenarioMetadata-BsDp0Bzm.js';
+import '../ILankaRuntimeConfig-Vl436GWK.js';
+import '../lankaHttpInFlight-Bk1eIuSx.js';
+import '../lankaRequestMiddleware-DAC5kCb7.js';
+import '../locator/gateway/lanka-gateway-locator/LankaGatewayLocator.js';
 import '../ALankaGateway-BrVPaZN5.js';
 import '../lankaStandardValidator-BUFnysK0.js';
 import '@standard-schema/spec';
 import '../ILankaFieldError-D5931-vT.js';
-import '../ILankaRuntimeConfig-Vl436GWK.js';
-import '../lankaHttpInFlight-Bk1eIuSx.js';
-import '../lankaRequestMiddleware-DAC5kCb7.js';
+import '../locator/scenario/lanka-scenario-locator/LankaScenarioLocator.js';
+import '../locator/shared-store/lanka-shared-store-locator/LankaSharedStoreLocator.js';
+import '../ALankaSharedStore-B7uepuuk.js';
+import 'zustand/vanilla';
 
 /**
  * What a subscriber is handed when a named event arrives.

package/dist/viewmodel/index.d.ts

@@ -1,6 +1,7 @@
 import { I as ILankaReadableVM } from '../ILankaReadableVM-BoPzHEPV.js';
-import { a as ILankaScenario, T as TLankaReplayRequest, I as ILankaScenarioVM } from '../ILankaScenarioVM-DpKFL3iE.js';
+import { I as ILankaScenarioVM } from '../ILankaScenarioVM-DKwjbIRq.js';
 import { StoreApi, StateCreator } from 'zustand';
+import { I as ILankaScenario, T as TLankaReplayRequest } from '../ILankaScenario-DQd9ZfUw.js';
 import { A as ALankaSharedStore } from '../ALankaSharedStore-B7uepuuk.js';
 import { StoreApi as StoreApi$1 } from 'zustand/vanilla';
 
@@ -175,7 +176,7 @@ interface ILankaStatelessScenarioBinding<TData, TState extends object, TGateways
         usedBy?: string;
     };
 }
-type TLankaStatelessVMConfig$1<Actions extends object, TGateways extends object = Record<string, never>, Services extends object = Record<string, never>> = {
+type TLankaStatelessVMConfig<Actions extends object, TGateways extends object = Record<string, never>, Services extends object = Record<string, never>> = {
     name: string;
     createActions: (ctx: ILankaStatelessVMContext<Actions & ILankaScenarioVM, TGateways, Services>) => Actions;
     /** A FACTORY is read at bind time — see `TLankaScenarioBindingsDeclaration`. */
@@ -193,22 +194,51 @@ type TLankaStatelessVMConfig$1<Actions extends object, TGateways extends object
  * resolves to exactly the type the factory returns.
  */
 type TLankaStatelessVMHook<Actions extends object> = ILankaReadableVM<Actions & ILankaScenarioVM>;
-declare function createStatelessLankaVM<Actions extends object>(config: TLankaStatelessVMConfig$1<Actions, Record<string, never>, Record<string, never>>): ILankaReadableVM<Actions & ILankaScenarioVM>;
-declare function createStatelessLankaVM<Actions extends object, Services extends object>(config: TLankaStatelessVMConfig$1<Actions, Record<string, never>, Services>): ILankaReadableVM<Actions & ILankaScenarioVM>;
-declare function createStatelessLankaVM<Actions extends object, TGateways extends object>(config: TLankaStatelessVMConfig$1<Actions, TGateways, Record<string, never>>): ILankaReadableVM<Actions & ILankaScenarioVM>;
-declare function createStatelessLankaVM<Actions extends object, TGateways extends object, Services extends object>(config: TLankaStatelessVMConfig$1<Actions, TGateways, Services>): ILankaReadableVM<Actions & ILankaScenarioVM>;
+declare function createStatelessLankaVM<Actions extends object>(config: TLankaStatelessVMConfig<Actions, Record<string, never>, Record<string, never>>): ILankaReadableVM<Actions & ILankaScenarioVM>;
+declare function createStatelessLankaVM<Actions extends object, Services extends object>(config: TLankaStatelessVMConfig<Actions, Record<string, never>, Services>): ILankaReadableVM<Actions & ILankaScenarioVM>;
+declare function createStatelessLankaVM<Actions extends object, TGateways extends object>(config: TLankaStatelessVMConfig<Actions, TGateways, Record<string, never>>): ILankaReadableVM<Actions & ILankaScenarioVM>;
+declare function createStatelessLankaVM<Actions extends object, TGateways extends object, Services extends object>(config: TLankaStatelessVMConfig<Actions, TGateways, Services>): ILankaReadableVM<Actions & ILankaScenarioVM>;
 
-type TLankaStatelessVMConfig<Actions extends object, TGateways extends object = Record<string, never>, Services extends object = Record<string, never>> = Omit<ILankaVMConfig<object, Actions, TGateways, Services>, "states"> & {
+/**
+ * What the LAZY stateless factory takes, which is not what the eager one takes.
+ *
+ * This type was called `TLankaStatelessVMConfig` — the same name the eager
+ * factory declares and `lanka/viewmodel` publishes — and the two are not the
+ * same shape. One name over two types is a surface that cannot be read: a
+ * consumer annotating a shared config with the published name and passing it
+ * here got a compile error nothing in the published surface explained, and five
+ * binding mirrors had to derive their parameter type off this function rather
+ * than name it. Renaming costs nothing, because no barrel ever re-exported the
+ * duplicate.
+ *
+ * **Where it genuinely differs, and it is not cosmetic.** The eager config hands
+ * `createActions`, `onInit` and `onReset` an `ILankaStatelessVMContext`, whose
+ * `set` is `TLankaSetState`. This one is `ILankaVMConfig` with `states` removed,
+ * so it hands them the STATEFUL `ILankaVMContext`, whose `set` is zustand's
+ * `setState` — including the `replace` argument, on a ViewModel that holds
+ * nothing to replace.
+ *
+ * It also accepts `enhancers` and `enableAccessTrackingOptimization`, which
+ * `createStatelessLankaVM` does not read: a stateless ViewModel has no store to
+ * enhance and nothing whose reads could be tracked. They are accepted and
+ * ignored, and that is worth knowing before writing one.
+ *
+ * Both are the eager factory's shape leaking through `Omit`, and narrowing this
+ * to the eager config would REFUSE configs that compile today — the unsafe move
+ * `skills/surface/SKILL.md` §6c names. So the difference is published under its
+ * own name instead, where a reader meets it, and closing it belongs to a major.
+ */
+type TLankaLazyStatelessVMConfig<Actions extends object, TGateways extends object = Record<string, never>, Services extends object = Record<string, never>> = Omit<ILankaVMConfig<object, Actions, TGateways, Services>, "states"> & {
     states?: never;
 };
 type TLazyStatelessReturn<Actions extends object, TGateways extends object, Services extends object> = ReturnType<typeof createStatelessLankaVM<Actions, TGateways, Services>> & {
     getState: () => Actions & ILankaScenarioVM;
     dispose: () => void;
 };
-declare function createLazyStatelessLankaVM<Actions extends object>(config: TLankaStatelessVMConfig<Actions, Record<string, never>, Record<string, never>>): TLazyStatelessReturn<Actions, Record<string, never>, Record<string, never>>;
-declare function createLazyStatelessLankaVM<Actions extends object, Services extends object>(config: TLankaStatelessVMConfig<Actions, Record<string, never>, Services>): TLazyStatelessReturn<Actions, Record<string, never>, Services>;
-declare function createLazyStatelessLankaVM<Actions extends object, TGateways extends object>(config: TLankaStatelessVMConfig<Actions, TGateways, Record<string, never>>): TLazyStatelessReturn<Actions, TGateways, Record<string, never>>;
-declare function createLazyStatelessLankaVM<Actions extends object, TGateways extends object, Services extends object>(config: TLankaStatelessVMConfig<Actions, TGateways, Services>): TLazyStatelessReturn<Actions, TGateways, Services>;
+declare function createLazyStatelessLankaVM<Actions extends object>(config: TLankaLazyStatelessVMConfig<Actions, Record<string, never>, Record<string, never>>): TLazyStatelessReturn<Actions, Record<string, never>, Record<string, never>>;
+declare function createLazyStatelessLankaVM<Actions extends object, Services extends object>(config: TLankaLazyStatelessVMConfig<Actions, Record<string, never>, Services>): TLazyStatelessReturn<Actions, Record<string, never>, Services>;
+declare function createLazyStatelessLankaVM<Actions extends object, TGateways extends object>(config: TLankaLazyStatelessVMConfig<Actions, TGateways, Record<string, never>>): TLazyStatelessReturn<Actions, TGateways, Record<string, never>>;
+declare function createLazyStatelessLankaVM<Actions extends object, TGateways extends object, Services extends object>(config: TLankaLazyStatelessVMConfig<Actions, TGateways, Services>): TLazyStatelessReturn<Actions, TGateways, Services>;
 
 interface ILankaSharedStoreVMContext<TStoreState extends object, TFullState extends object, TStore extends ALankaSharedStore<TStoreState>, TGateways extends object, TServices extends object> {
     set: StoreApi$1<TStoreState>["setState"];
@@ -673,4 +703,4 @@ type TLankaVMStateCreator<TFullState> = StateCreator<TFullState, TLankaAnyMutato
 
 type TLankaSharedStoreSetState<TState extends object> = (partial: TState | Partial<TState> | ((state: TState) => TState | Partial<TState>), replace?: boolean) => void;
 
-export { ALankaSharedStore, ALankaSharedStoreVM, ALankaStatelessVM, ALankaVM, ILankaReadableVM, type ILankaScenarioBinding, type ILankaSharedStoreScenarioBinding, type ILankaSharedStoreVM, type ILankaSharedStoreVMConfig, type ILankaSharedStoreVMContext, type ILankaStatelessScenarioBinding, type ILankaStatelessVMContext, type ILankaVM, type ILankaVMConfig, type ILankaVMContext, type TLankaAnyMutators, type TLankaSetState, type TLankaSharedStoreSetState, type TLankaSharedStoreVMHook, type TLankaStatelessVMConfig$1 as TLankaStatelessVMConfig, type TLankaStatelessVMHook, type TLankaVMEnhancer, type TLankaVMStateCreator, type TLazyLankaVM, type TUnknownLankaScenarioBinding, createLankaShallowHold, createLankaSharedStore, createLankaVM, createLazyLankaVM, createLazySharedStoreLankaVM, createLazyStatelessLankaVM, createSharedStoreLankaVM, createStatelessLankaVM };
+export { ALankaSharedStore, ALankaSharedStoreVM, ALankaStatelessVM, ALankaVM, ILankaReadableVM, type ILankaScenarioBinding, type ILankaSharedStoreScenarioBinding, type ILankaSharedStoreVM, type ILankaSharedStoreVMConfig, type ILankaSharedStoreVMContext, type ILankaStatelessScenarioBinding, type ILankaStatelessVMContext, type ILankaVM, type ILankaVMConfig, type ILankaVMContext, type TLankaAnyMutators, type TLankaLazyStatelessVMConfig, type TLankaSetState, type TLankaSharedStoreSetState, type TLankaSharedStoreVMHook, type TLankaStatelessVMConfig, type TLankaStatelessVMHook, type TLankaVMEnhancer, type TLankaVMStateCreator, type TLazyLankaVM, type TUnknownLankaScenarioBinding, createLankaShallowHold, createLankaSharedStore, createLankaVM, createLazyLankaVM, createLazySharedStoreLankaVM, createLazyStatelessLankaVM, createSharedStoreLankaVM, createStatelessLankaVM };

package/dist/viewmodel/index.js

@@ -3,7 +3,8 @@ import {
 } from "../chunk-UDP6IXDS.js";
 import {
   lankaScenarioBootstrap
-} from "../chunk-EYDMBI5T.js";
+} from "../chunk-MKKMTLOY.js";
+import "../chunk-NWEHOMTS.js";
 import {
   lankaLogger
 } from "../chunk-FII3PW2G.js";