lanka 1.0.0

package/dist/chunk-C2HP7CRD.js

@@ -0,0 +1,224 @@
+import {
+  getLankaFlags
+} from "./chunk-D27MREPB.js";
+
+// src/logger/lanka-logger/LankaLogger.ts
+var noop = () => {
+};
+var isProd = () => getLankaFlags().isProduction ?? false;
+var resolveFlagValue = (val) => {
+  if (val === void 0) return false;
+  return typeof val === "function" ? val() : val;
+};
+var formatBadgeStyle = (color) => `background: ${color}; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;`;
+var consoleSink = {
+  emit: ({ layer, level, style, color, message, args }) => {
+    const fn = (console[level] ?? console.log).bind(console);
+    if (style === "badge") {
+      const badgeColor = color ?? "#7f8c8d";
+      fn(`%c[${layer}]`, formatBadgeStyle(badgeColor), message, ...args);
+      return;
+    }
+    fn(`[${layer}]`, message, ...args);
+  }
+};
+var FLAG_KEYS = {
+  GATEWAY: "loggerGateway",
+  SCENARIO: "loggerScenario",
+  VIEWMODEL: "loggerViewModel",
+  VIEW: "loggerView",
+  BOOTSTRAP: "loggerBootstrap",
+  ENABLED: "loggerEnabled"
+};
+var BUILT_IN_PRINTERS = [
+  { key: "printGatewayLog", layer: "GW", color: "#7e501f", level: "log", flag: "GATEWAY" },
+  {
+    key: "printScenarioLog",
+    layer: "SC",
+    color: "rgba(225,198,15,0.86)",
+    level: "log",
+    flag: "SCENARIO"
+  },
+  { key: "printViewModelLog", layer: "VM", color: "#1a85d6", level: "log", flag: "VIEWMODEL" },
+  { key: "printViewLog", layer: "UI", color: "#c32222", level: "log", flag: "VIEW" },
+  { key: "printBootstrapLog", layer: "BT", color: "#9b59b6", level: "log", flag: "BOOTSTRAP" }
+];
+var LankaLogger = class {
+  style = "badge";
+  sinks = /* @__PURE__ */ new Set([consoleSink]);
+  flags = /* @__PURE__ */ new Map();
+  printers = /* @__PURE__ */ new Map();
+  /** The gateway layer's printer. */
+  printGatewayLog;
+  /** The scenario layer's printer. */
+  printScenarioLog;
+  /** The ViewModel layer's printer. */
+  printViewModelLog;
+  /** The view layer's printer. */
+  printViewLog;
+  /** The bootstrap sequence's printer. */
+  printBootstrapLog;
+  constructor() {
+    if (!isProd()) {
+      for (const printer of BUILT_IN_PRINTERS) this.printers.set(printer.key, { ...printer });
+    }
+    this.printGatewayLog = this.createPrinterFn("printGatewayLog");
+    this.printScenarioLog = this.createPrinterFn("printScenarioLog");
+    this.printViewModelLog = this.createPrinterFn("printViewModelLog");
+    this.printViewLog = this.createPrinterFn("printViewLog");
+    this.printBootstrapLog = this.createPrinterFn("printBootstrapLog");
+  }
+  // ── Global configuration ─────────────────────────────────────────────────
+  /**
+   * Enables or silences the WHOLE log, overriding the environment.
+   *
+   * Equivalent to setting the `ENABLED` flag.
+   */
+  setEnabled(value) {
+    if (isProd()) return;
+    this.flags.set("ENABLED", value);
+  }
+  /** Switches output between badges and plain text. */
+  setStyle(style) {
+    if (isProd()) return;
+    this.style = style;
+  }
+  /**
+   * Goes completely silent by removing the sinks; config and printers remain.
+   *
+   * Output is restored with `resetSinks()` or `addSink()`.
+   */
+  silent() {
+    if (isProd()) return;
+    this.sinks.clear();
+  }
+  /** Restores the single default sink: the console. */
+  resetSinks() {
+    if (isProd()) return;
+    this.sinks = /* @__PURE__ */ new Set([consoleSink]);
+  }
+  addSink(sink) {
+    if (isProd()) return;
+    this.sinks.add(sink);
+  }
+  removeSink(sink) {
+    if (isProd()) return;
+    this.sinks.delete(sink);
+  }
+  // ── Flags, built-in and custom ───────────────────────────────────────────
+  /**
+   * Declares a flag the printers use, or overrides an existing one.
+   *
+   * The value may be a boolean or a resolver function — for example one reading
+   * localStorage.
+   */
+  setFlag(flag, value) {
+    if (isProd()) return;
+    this.flags.set(flag, value);
+  }
+  /** Removes a flag override, falling back to the environment value. */
+  unsetFlag(flag) {
+    if (isProd()) return;
+    this.flags.delete(flag);
+  }
+  isFlagEnabled(flag) {
+    if (isProd()) return false;
+    const runtimeFlag = this.flags.get(flag);
+    if (runtimeFlag !== void 0) return resolveFlagValue(runtimeFlag);
+    const flags = getLankaFlags();
+    const key = FLAG_KEYS[flag];
+    if (key && flags[key] !== void 0) return flags[key] ?? false;
+    return false;
+  }
+  // ── Printers, built-in and custom ────────────────────────────────────────
+  /**
+   * Registers a printer, or replaces an existing one.
+   *
+   * @returns The callable bound to this printer
+   */
+  registerPrinter(config) {
+    if (isProd()) return noop;
+    this.printers.set(config.key, {
+      key: config.key,
+      layer: config.layer,
+      color: config.color,
+      level: config.level ?? "log",
+      flag: config.flag,
+      enabled: config.enabled
+    });
+    return this.createPrinterFn(config.key);
+  }
+  /** Updates a printer's config; a no-op when there is no such printer. */
+  updatePrinter(key, patch) {
+    if (isProd()) return;
+    const existing = this.printers.get(key);
+    if (!existing) return;
+    this.printers.set(key, {
+      key,
+      layer: patch.layer ?? existing.layer,
+      color: patch.color ?? existing.color,
+      level: patch.level ?? existing.level,
+      flag: patch.flag ?? existing.flag,
+      enabled: patch.enabled ?? existing.enabled
+    });
+  }
+  /** A printer by key; a silent function when there is none. */
+  getPrinter(key) {
+    if (isProd()) return noop;
+    return this.printers.has(key) ? this.createPrinterFn(key) : noop;
+  }
+  /** The keys of every registered printer. */
+  listPrinters() {
+    if (isProd()) return [];
+    return Array.from(this.printers.keys());
+  }
+  // ── The path a message takes ─────────────────────────────────────────────
+  isEnabled() {
+    if (isProd()) return false;
+    const runtimeFlag = this.flags.get("ENABLED");
+    if (runtimeFlag !== void 0) return resolveFlagValue(runtimeFlag);
+    return getLankaFlags().loggerEnabled ?? false;
+  }
+  isPrinterEnabled(printer) {
+    if (isProd()) return false;
+    if (!this.isEnabled()) return false;
+    if (printer.enabled !== void 0) return resolveFlagValue(printer.enabled);
+    if (printer.flag) return this.isFlagEnabled(printer.flag);
+    return true;
+  }
+  emit(printer, msg, args) {
+    if (isProd() || !this.isPrinterEnabled(printer)) return;
+    const message = typeof msg === "function" ? msg() : msg;
+    for (const sink of this.sinks) {
+      sink.emit({
+        layer: printer.layer,
+        level: printer.level,
+        style: this.style,
+        color: printer.color,
+        message,
+        args
+      });
+    }
+  }
+  /**
+   * A printer resolved at CALL time, not at registration.
+   *
+   * `updatePrinter` has to reach a callable a screen took a reference to long
+   * before; looking the key up on every call is what makes that true.
+   */
+  createPrinterFn(key) {
+    if (isProd()) return noop;
+    return (msg, ...args) => {
+      const printer = this.printers.get(key);
+      if (!printer) return;
+      this.emit(printer, msg, args);
+    };
+  }
+};
+var lankaLogger = new LankaLogger();
+
+export {
+  LankaLogger,
+  lankaLogger
+};
+//# sourceMappingURL=chunk-C2HP7CRD.js.map

package/dist/chunk-C2HP7CRD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger/lanka-logger/LankaLogger.ts"],"sourcesContent":["import { getLankaFlags } from \"../../config/get-lanka-flags/getLankaFlags\";\nimport { TLankaLoggerFn } from \"../_types/TLankaLoggerFn\";\nimport { TLankaLoggerFlagValue } from \"../_types/TLankaLoggerFlagValue\";\nimport { ILankaLoggerSink } from \"../_interfaces/ILankaLoggerSink\";\nimport { TLankaLoggerStyle } from \"../_types/TLankaLoggerStyle\";\nimport { TPrinterInternal } from \"../_types/TPrinterInternal\";\nimport { TLankaLogMessage } from \"../_types/TLankaLogMessage\";\nimport { TLankaLogMessageFactory } from \"../_types/TLankaLogMessageFactory\";\nimport { ILankaLoggerConfig } from \"../_interfaces/ILankaLoggerConfig\";\n\nconst noop: TLankaLoggerFn = () => {};\n\nconst isProd = (): boolean => getLankaFlags().isProduction ?? false;\n\nconst resolveFlagValue = (val: TLankaLoggerFlagValue | undefined): boolean => {\n\tif (val === undefined) return false;\n\treturn typeof val === \"function\" ? val() : val;\n};\n\nconst formatBadgeStyle = (color: string) =>\n\t`background: ${color}; color: white; padding: 2px 4px; border-radius: 2px; font-weight: bold;`;\n\nconst consoleSink: ILankaLoggerSink = {\n\temit: ({ layer, level, style, color, message, args }) => {\n\t\t// Bound deliberately. Reading a console method off the object and calling it\n\t\t// detached is what `unbound-method` warns about, and it is not merely a\n\t\t// lint concern: several environments throw \"Illegal invocation\" when a\n\t\t// console method runs with the wrong `this`.\n\t\tconst fn = (console[level] ?? console.log).bind(console);\n\t\tif (style === \"badge\") {\n\t\t\tconst badgeColor = color ?? \"#7f8c8d\";\n\t\t\tfn(`%c[${layer}]`, formatBadgeStyle(badgeColor), message, ...args);\n\t\t\treturn;\n\t\t}\n\t\tfn(`[${layer}]`, message, ...args);\n\t},\n};\n\n/** Which environment flag stands behind each built-in printer's flag name. */\nconst FLAG_KEYS = {\n\tGATEWAY: \"loggerGateway\",\n\tSCENARIO: \"loggerScenario\",\n\tVIEWMODEL: \"loggerViewModel\",\n\tVIEW: \"loggerView\",\n\tBOOTSTRAP: \"loggerBootstrap\",\n\tENABLED: \"loggerEnabled\",\n} as const;\n\n/** The five printers every application gets, and how each is coloured. */\nconst BUILT_IN_PRINTERS: readonly TPrinterInternal[] = [\n\t{ key: \"printGatewayLog\", layer: \"GW\", color: \"#7e501f\", level: \"log\", flag: \"GATEWAY\" },\n\t{\n\t\tkey: \"printScenarioLog\",\n\t\tlayer: \"SC\",\n\t\tcolor: \"rgba(225,198,15,0.86)\",\n\t\tlevel: \"log\",\n\t\tflag: \"SCENARIO\",\n\t},\n\t{ key: \"printViewModelLog\", layer: \"VM\", color: \"#1a85d6\", level: \"log\", flag: \"VIEWMODEL\" },\n\t{ key: \"printViewLog\", layer: \"UI\", color: \"#c32222\", level: \"log\", flag: \"VIEW\" },\n\t{ key: \"printBootstrapLog\", layer: \"BT\", color: \"#9b59b6\", level: \"log\", flag: \"BOOTSTRAP\" },\n];\n\n/**\n * Output that is not bound to the console, and is silent in production.\n *\n * The ambient one is `lankaLogger`, and it is what an application and the\n * framework both write: `lankaLogger.printGatewayLog(...)`. The class is here for\n * the reason node exposes `Console` beside `console` — a second logger with its\n * own sinks, flags and printers is a real thing to want, and a test that builds\n * one is not fighting a global.\n *\n * ```ts\n * const audit = new LankaLogger();\n * audit.silent();\n * audit.addSink({ emit: (entry) => rows.push(entry) });\n * ```\n *\n * Every method is a no-op in production, checked per call rather than once at\n * import: a flag flipped at runtime must not be able to start the log.\n */\nexport class LankaLogger {\n\tprivate style: TLankaLoggerStyle = \"badge\";\n\n\tprivate sinks = new Set<ILankaLoggerSink>([consoleSink]);\n\n\tprivate readonly flags = new Map<string, TLankaLoggerFlagValue>();\n\n\tprivate readonly printers = new Map<string, TPrinterInternal>();\n\n\t/** The gateway layer's printer. */\n\tpublic readonly printGatewayLog: TLankaLoggerFn;\n\n\t/** The scenario layer's printer. */\n\tpublic readonly printScenarioLog: TLankaLoggerFn;\n\n\t/** The ViewModel layer's printer. */\n\tpublic readonly printViewModelLog: TLankaLoggerFn;\n\n\t/** The view layer's printer. */\n\tpublic readonly printViewLog: TLankaLoggerFn;\n\n\t/** The bootstrap sequence's printer. */\n\tpublic readonly printBootstrapLog: TLankaLoggerFn;\n\n\tpublic constructor() {\n\t\t// Registered outside production only: there is nothing to print from, so\n\t\t// there is nothing to hold. The printer callables still exist and answer\n\t\t// with silence, so no call site needs a branch.\n\t\tif (!isProd()) {\n\t\t\tfor (const printer of BUILT_IN_PRINTERS) this.printers.set(printer.key, { ...printer });\n\t\t}\n\n\t\tthis.printGatewayLog = this.createPrinterFn(\"printGatewayLog\");\n\t\tthis.printScenarioLog = this.createPrinterFn(\"printScenarioLog\");\n\t\tthis.printViewModelLog = this.createPrinterFn(\"printViewModelLog\");\n\t\tthis.printViewLog = this.createPrinterFn(\"printViewLog\");\n\t\tthis.printBootstrapLog = this.createPrinterFn(\"printBootstrapLog\");\n\t}\n\n\t// ── Global configuration ─────────────────────────────────────────────────\n\n\t/**\n\t * Enables or silences the WHOLE log, overriding the environment.\n\t *\n\t * Equivalent to setting the `ENABLED` flag.\n\t */\n\tpublic setEnabled(value: boolean): void {\n\t\tif (isProd()) return;\n\t\tthis.flags.set(\"ENABLED\", value);\n\t}\n\n\t/** Switches output between badges and plain text. */\n\tpublic setStyle(style: TLankaLoggerStyle): void {\n\t\tif (isProd()) return;\n\t\tthis.style = style;\n\t}\n\n\t/**\n\t * Goes completely silent by removing the sinks; config and printers remain.\n\t *\n\t * Output is restored with `resetSinks()` or `addSink()`.\n\t */\n\tpublic silent(): void {\n\t\tif (isProd()) return;\n\t\tthis.sinks.clear();\n\t}\n\n\t/** Restores the single default sink: the console. */\n\tpublic resetSinks(): void {\n\t\tif (isProd()) return;\n\t\tthis.sinks = new Set<ILankaLoggerSink>([consoleSink]);\n\t}\n\n\tpublic addSink(sink: ILankaLoggerSink): void {\n\t\tif (isProd()) return;\n\t\tthis.sinks.add(sink);\n\t}\n\n\tpublic removeSink(sink: ILankaLoggerSink): void {\n\t\tif (isProd()) return;\n\t\tthis.sinks.delete(sink);\n\t}\n\n\t// ── Flags, built-in and custom ───────────────────────────────────────────\n\n\t/**\n\t * Declares a flag the printers use, or overrides an existing one.\n\t *\n\t * The value may be a boolean or a resolver function — for example one reading\n\t * localStorage.\n\t */\n\tpublic setFlag(flag: string, value: TLankaLoggerFlagValue): void {\n\t\tif (isProd()) return;\n\t\tthis.flags.set(flag, value);\n\t}\n\n\t/** Removes a flag override, falling back to the environment value. */\n\tpublic unsetFlag(flag: string): void {\n\t\tif (isProd()) return;\n\t\tthis.flags.delete(flag);\n\t}\n\n\tpublic isFlagEnabled(flag: string): boolean {\n\t\tif (isProd()) return false;\n\n\t\tconst runtimeFlag = this.flags.get(flag);\n\t\tif (runtimeFlag !== undefined) return resolveFlagValue(runtimeFlag);\n\n\t\tconst flags = getLankaFlags();\n\t\tconst key = FLAG_KEYS[flag as keyof typeof FLAG_KEYS];\n\t\tif (key && flags[key] !== undefined) return flags[key] ?? false;\n\n\t\treturn false;\n\t}\n\n\t// ── Printers, built-in and custom ────────────────────────────────────────\n\n\t/**\n\t * Registers a printer, or replaces an existing one.\n\t *\n\t * @returns The callable bound to this printer\n\t */\n\tpublic registerPrinter(config: ILankaLoggerConfig): TLankaLoggerFn {\n\t\tif (isProd()) return noop;\n\n\t\tthis.printers.set(config.key, {\n\t\t\tkey: config.key,\n\t\t\tlayer: config.layer,\n\t\t\tcolor: config.color,\n\t\t\tlevel: config.level ?? \"log\",\n\t\t\tflag: config.flag,\n\t\t\tenabled: config.enabled,\n\t\t});\n\n\t\treturn this.createPrinterFn(config.key);\n\t}\n\n\t/** Updates a printer's config; a no-op when there is no such printer. */\n\tpublic updatePrinter(key: string, patch: Partial<Omit<ILankaLoggerConfig, \"key\">>): void {\n\t\tif (isProd()) return;\n\n\t\tconst existing = this.printers.get(key);\n\t\tif (!existing) return;\n\n\t\t// Every field defended, not two of five: a patch says what to change, and a\n\t\t// key it did not mention — or mentioned as `undefined` — must keep its value.\n\t\tthis.printers.set(key, {\n\t\t\tkey,\n\t\t\tlayer: patch.layer ?? existing.layer,\n\t\t\tcolor: patch.color ?? existing.color,\n\t\t\tlevel: patch.level ?? existing.level,\n\t\t\tflag: patch.flag ?? existing.flag,\n\t\t\tenabled: patch.enabled ?? existing.enabled,\n\t\t});\n\t}\n\n\t/** A printer by key; a silent function when there is none. */\n\tpublic getPrinter(key: string): TLankaLoggerFn {\n\t\tif (isProd()) return noop;\n\t\treturn this.printers.has(key) ? this.createPrinterFn(key) : noop;\n\t}\n\n\t/** The keys of every registered printer. */\n\tpublic listPrinters(): string[] {\n\t\tif (isProd()) return [];\n\t\treturn Array.from(this.printers.keys());\n\t}\n\n\t// ── The path a message takes ─────────────────────────────────────────────\n\n\tprivate isEnabled(): boolean {\n\t\tif (isProd()) return false;\n\n\t\tconst runtimeFlag = this.flags.get(\"ENABLED\");\n\t\tif (runtimeFlag !== undefined) return resolveFlagValue(runtimeFlag);\n\n\t\treturn getLankaFlags().loggerEnabled ?? false;\n\t}\n\n\tprivate isPrinterEnabled(printer: TPrinterInternal): boolean {\n\t\tif (isProd()) return false;\n\t\tif (!this.isEnabled()) return false;\n\t\tif (printer.enabled !== undefined) return resolveFlagValue(printer.enabled);\n\t\tif (printer.flag) return this.isFlagEnabled(printer.flag);\n\n\t\treturn true;\n\t}\n\n\tprivate emit(\n\t\tprinter: TPrinterInternal,\n\t\tmsg: TLankaLogMessage | TLankaLogMessageFactory,\n\t\targs: unknown[],\n\t): void {\n\t\tif (isProd() || !this.isPrinterEnabled(printer)) return;\n\n\t\t// Annotated, not inferred: `TLankaLogMessage` admits `object`, and a\n\t\t// function IS an object, so narrowing this union by `typeof` leaves the\n\t\t// call's result wider than the union it came from.\n\t\tconst message: TLankaLogMessage =\n\t\t\ttypeof msg === \"function\" ? (msg as TLankaLogMessageFactory)() : msg;\n\n\t\tfor (const sink of this.sinks) {\n\t\t\tsink.emit({\n\t\t\t\tlayer: printer.layer,\n\t\t\t\tlevel: printer.level,\n\t\t\t\tstyle: this.style,\n\t\t\t\tcolor: printer.color,\n\t\t\t\tmessage,\n\t\t\t\targs,\n\t\t\t});\n\t\t}\n\t}\n\n\t/**\n\t * A printer resolved at CALL time, not at registration.\n\t *\n\t * `updatePrinter` has to reach a callable a screen took a reference to long\n\t * before; looking the key up on every call is what makes that true.\n\t */\n\tprivate createPrinterFn(key: string): TLankaLoggerFn {\n\t\tif (isProd()) return noop;\n\n\t\treturn (msg, ...args) => {\n\t\t\tconst printer = this.printers.get(key);\n\t\t\tif (!printer) return;\n\n\t\t\tthis.emit(printer, msg, args);\n\t\t};\n\t}\n}\n\n/**\n * The logger the framework itself writes to, and an application with it.\n *\n * `console` to this file's `Console`: ready before anything is configured, and\n * the one every call site in the framework uses.\n */\nexport const lankaLogger = new LankaLogger();\n"],"mappings":"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","names":[]}

package/dist/chunk-D27MREPB.js

@@ -0,0 +1,13 @@
+import {
+  getActiveRuntime
+} from "./chunk-BGVDPDX4.js";
+
+// src/config/get-lanka-flags/getLankaFlags.ts
+function getLankaFlags() {
+  return getActiveRuntime()?.getFlags() ?? {};
+}
+
+export {
+  getLankaFlags
+};
+//# sourceMappingURL=chunk-D27MREPB.js.map

package/dist/chunk-D27MREPB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/get-lanka-flags/getLankaFlags.ts"],"sourcesContent":["import { getActiveRuntime } from \"../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaFlags } from \"../_interfaces/ILankaFlags\";\n\n/**\n * Flags of the active instance — or empty when there is none.\n *\n * A missing instance is NOT an error here, unlike a missing host. Flags are read\n * earliest of all: `LankaLogger` decides from them whether to write at all, and\n * does so before any `createLanka()`. Empty flags mean \"everything off\", which\n * is a correct answer; a missing host has no correct answer.\n *\n * This is the AMBIENT read — for modules and plugins that never see an instance.\n * Whoever holds one asks it: `lanka.getFlags()`.\n */\nexport function getLankaFlags(): ILankaFlags {\n\treturn getActiveRuntime()?.getFlags() ?? {};\n}\n"],"mappings":";;;;;AAcO,SAAS,gBAA6B;AAC5C,SAAO,iBAAiB,GAAG,SAAS,KAAK,CAAC;AAC3C;","names":[]}

package/dist/chunk-DTO27QFR.js

@@ -0,0 +1,59 @@
+import {
+  requireActiveRuntime
+} from "./chunk-BGVDPDX4.js";
+
+// src/locator/_factories/create-lanka-locator-proxy/createLankaLocatorProxy.ts
+function createLankaLocatorProxy(config) {
+  const { locator, protectedProperties = [], errorPrefix = "Cannot access" } = config;
+  return new Proxy(locator, {
+    get(target, prop) {
+      if (typeof prop !== "string") {
+        throw new Error(`${errorPrefix} with symbol property: ${String(prop)}`);
+      }
+      const internalProps = ["_", "constructor", "prototype", ...protectedProperties];
+      if (prop.startsWith("_") || internalProps.some((internalProp) => prop === internalProp)) {
+        throw new Error(`${errorPrefix} with property: ${prop}`);
+      }
+      return target.get(prop);
+    }
+  });
+}
+
+// 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 {
+  createLankaLocatorProxy,
+  lankaSingletons,
+  lankaSharedStores
+};
+//# sourceMappingURL=chunk-DTO27QFR.js.map

package/dist/chunk-DTO27QFR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locator/_factories/create-lanka-locator-proxy/createLankaLocatorProxy.ts","../src/locator/singleton/_facades/lanka-singletons/lankaSingletons.ts","../src/locator/shared-store/_facades/lanka-shared-stores/lankaSharedStores.ts"],"sourcesContent":["import type { ILankaLocator } from \"../../_interfaces/ILankaLocator\";\n\n/**\n * Configuration of the global locator proxy.\n */\nexport interface ILankaLocatorProxyConfig<TInstance> {\n\t/** The locator that actually resolves instances. */\n\tlocator: ILankaLocator<TInstance>;\n\t/** Properties whose access must throw. */\n\tprotectedProperties?: string[];\n\t/** Prefix of the message thrown for an unknown property. */\n\terrorPrefix?: string;\n}\n\n/**\n * Creates a Proxy for dynamic access to instances with type safety.\n * Converts camelCase property access to PascalCase instance names.\n *\n * @param config Proxy configuration\n * @returns Proxy object typed as TType\n */\nexport function createLankaLocatorProxy<TInstance, TType extends Record<string, TInstance>>(\n\tconfig: ILankaLocatorProxyConfig<TInstance>,\n): TType {\n\tconst { locator, protectedProperties = [], errorPrefix = \"Cannot access\" } = config;\n\n\treturn new Proxy(locator, {\n\t\tget(target, prop: string | symbol): TInstance {\n\t\t\t// Symbols such as `Symbol.iterator` are not instance names.\n\t\t\tif (typeof prop !== \"string\") {\n\t\t\t\tthrow new Error(`${errorPrefix} with symbol property: ${String(prop)}`);\n\t\t\t}\n\n\t\t\t// Internal properties are rejected.\n\t\t\tconst internalProps = [\"_\", \"constructor\", \"prototype\", ...protectedProperties];\n\n\t\t\tif (\n\t\t\t\tprop.startsWith(\"_\") ||\n\t\t\t\tinternalProps.some((internalProp) => prop === internalProp)\n\t\t\t) {\n\t\t\t\tthrow new Error(`${errorPrefix} with property: ${prop}`);\n\t\t\t}\n\n\t\t\t// The instance for a camelCase property name.\n\t\t\treturn target.get(prop);\n\t\t},\n\t}) as unknown as TType;\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\";\nexport { LankaSingletonLocator } from \"../../lanka-singleton-locator/LankaSingletonLocator\";\nexport type { ILankaSingletonLocatorConfig } from \"../../lanka-singleton-locator/LankaSingletonLocator\";\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\nexport { LankaSharedStoreLocator } from \"../../lanka-shared-store-locator/LankaSharedStoreLocator\";\nexport type { ILankaSharedStoreLocatorConfig } from \"../../lanka-shared-store-locator/LankaSharedStoreLocator\";\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":";;;;;AAqBO,SAAS,wBACf,QACQ;AACR,QAAM,EAAE,SAAS,sBAAsB,CAAC,GAAG,cAAc,gBAAgB,IAAI;AAE7E,SAAO,IAAI,MAAM,SAAS;AAAA,IACzB,IAAI,QAAQ,MAAkC;AAE7C,UAAI,OAAO,SAAS,UAAU;AAC7B,cAAM,IAAI,MAAM,GAAG,WAAW,0BAA0B,OAAO,IAAI,CAAC,EAAE;AAAA,MACvE;AAGA,YAAM,gBAAgB,CAAC,KAAK,eAAe,aAAa,GAAG,mBAAmB;AAE9E,UACC,KAAK,WAAW,GAAG,KACnB,cAAc,KAAK,CAAC,iBAAiB,SAAS,YAAY,GACzD;AACD,cAAM,IAAI,MAAM,GAAG,WAAW,mBAAmB,IAAI,EAAE;AAAA,MACxD;AAGA,aAAO,OAAO,IAAI,IAAI;AAAA,IACvB;AAAA,EACD,CAAC;AACF;;;ACbA,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;;;AChCD,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/chunk-EWVDJYCC.js

@@ -0,0 +1,296 @@
+import {
+  lankaLogger
+} from "./chunk-C2HP7CRD.js";
+import {
+  requireActiveRuntime
+} from "./chunk-BGVDPDX4.js";
+
+// src/scenario/event-bus/_facades/lanka-event-bus/lankaEventBus.ts
+var bus = () => requireActiveRuntime().eventBus;
+var lankaEventBus = Object.freeze({
+  enableLogs: () => {
+    bus().enableLogs();
+  },
+  disableLogs: () => {
+    bus().disableLogs();
+  },
+  registerEvent: (eventType, metadata) => {
+    bus().registerEvent(eventType, metadata);
+  },
+  getRegisteredEvents: () => bus().getRegisteredEvents(),
+  getEventInfo: (eventType) => bus().getEventInfo(eventType),
+  getSubscriptions: (eventType) => bus().getSubscriptions(eventType),
+  subscribe: (eventType, callback, options) => bus().subscribe(eventType, callback, options),
+  unsubscribe: (eventType, callback) => {
+    bus().unsubscribe(eventType, callback);
+  },
+  dispatch: (eventType, data, usedBy) => {
+    bus().dispatch(eventType, data, usedBy);
+  },
+  addMiddleware: (middleware) => {
+    bus().addMiddleware(middleware);
+  },
+  removeMiddleware: (middleware) => {
+    bus().removeMiddleware(middleware);
+  },
+  getEventLogs: (eventType, limit = 100) => bus().getEventLogs(eventType, limit),
+  clearEvent: (eventType) => {
+    bus().clearEvent(eventType);
+  },
+  clearAllEvents: () => {
+    bus().clearAllEvents();
+  },
+  reset: () => {
+    bus().reset();
+  }
+});
+
+// src/scenario/_registries/lanka-scenario-vm-registry/LankaScenarioVMRegistry.ts
+var LankaScenarioVMRegistry = class {
+  registeredViewModels = /* @__PURE__ */ new Set();
+  /**
+   * Public: the registry belongs to a framework instance rather than to the
+   * module.
+   */
+  constructor() {
+  }
+  /**
+   * The active instance's registry, for callers that cannot hold one — the
+   * static `LankaScenarioBootstrap`. Instance holders read `lanka.viewModels`.
+   */
+  static getInstance() {
+    return requireActiveRuntime().viewModels;
+  }
+  /** Whether this ViewModel is already registered. */
+  isRegistered(viewModel) {
+    return this.registeredViewModels.has(viewModel);
+  }
+  /**
+   * Registers a ViewModel.
+   *
+   * @returns `false` when it was already registered
+   */
+  register(viewModel) {
+    if (this.registeredViewModels.has(viewModel)) {
+      return false;
+    }
+    this.registeredViewModels.add(viewModel);
+    return true;
+  }
+  /** Removes a ViewModel from the registry. */
+  unregister(viewModel) {
+    this.registeredViewModels.delete(viewModel);
+  }
+  /** Every registered ViewModel. */
+  getAllViewModels() {
+    return Array.from(this.registeredViewModels);
+  }
+  /**
+   * Clears every registered ViewModel. Required by tests.
+   */
+  clear() {
+    this.registeredViewModels.clear();
+  }
+  /**
+   * Unsubscribes every registered ViewModel from its scenarios and clears the
+   * registry.
+   *
+   * Without it tests are not isolated: a subscription leaks from test to test.
+   */
+  resetAll() {
+    this.registeredViewModels.forEach((vm) => {
+      try {
+        vm.resetScenario();
+      } catch {
+      }
+    });
+    this.clear();
+  }
+};
+
+// src/scenario/_registries/lanka-scenarios-registry/LankaScenariosRegistry.ts
+var LankaScenariosRegistry = class {
+  registeredScenarios = /* @__PURE__ */ new Map();
+  scenarioMetadata = /* @__PURE__ */ new Map();
+  /**
+   * Public: the registry belongs to a framework instance rather than to the
+   * module.
+   */
+  constructor() {
+  }
+  /**
+   * The active instance's registry, for callers that cannot hold one:
+   * `ALankaScenario` (a base class the consumer extends) and the static
+   * `LankaScenarioBootstrap`. Instance holders read `lanka.scenarios`.
+   */
+  static getInstance() {
+    return requireActiveRuntime().scenarios;
+  }
+  /**
+   * Registers a scenario by hand.
+   *
+   * @param scenario What to register
+   * @returns `false` when it was already registered
+   */
+  register(scenario) {
+    if (this.registeredScenarios.has(scenario.name)) {
+      return false;
+    }
+    this.registeredScenarios.set(scenario.name, scenario);
+    this.scenarioMetadata.set(scenario.name, {
+      scenario,
+      name: scenario.name,
+      eventType: scenario.eventType,
+      dataTypeName: scenario.dataTypeName,
+      isRegistered: true
+    });
+    return true;
+  }
+  /**
+   * Unregister a scenario
+   * @param scenarioName Name of the scenario to unregister
+   * @returns true if unregistered successfully, false if not found
+   */
+  unregister(scenarioName) {
+    if (!this.registeredScenarios.has(scenarioName)) {
+      return false;
+    }
+    const metadata = this.scenarioMetadata.get(scenarioName);
+    if (metadata) {
+      metadata.isRegistered = false;
+    }
+    this.registeredScenarios.delete(scenarioName);
+    return true;
+  }
+  /**
+   * Get metadata for a specific scenario
+   * @param scenarioName Name of the scenario
+   * @returns Scenario metadata or undefined if not found
+   */
+  getMetadata(scenarioName) {
+    return this.scenarioMetadata.get(scenarioName);
+  }
+  /** Every registered scenario. */
+  getAllScenarios() {
+    return Array.from(this.registeredScenarios.values());
+  }
+  /** Metadata of every scenario. */
+  getAllMetadata() {
+    return Array.from(this.scenarioMetadata.values());
+  }
+  /** Whether a scenario with this name is registered. */
+  isRegistered(scenarioName) {
+    return this.registeredScenarios.has(scenarioName);
+  }
+  /**
+   * Collects every scenario that registered itself at construction.
+   */
+  collectAutoRegisteredScenarios() {
+    const autoRegistered = ALankaScenario.getAutoRegisteredScenarios();
+    autoRegistered.forEach((scenario) => {
+      if (!this.registeredScenarios.has(scenario.name)) {
+        this.register(scenario);
+      }
+    });
+  }
+  /**
+   * A scenario by name.
+   *
+   * @returns `undefined` when there is none
+   */
+  getScenarioByName(scenarioName) {
+    return this.registeredScenarios.get(scenarioName);
+  }
+  /** Every registered ViewModel. */
+  getAllViewModels() {
+    return LankaScenarioVMRegistry.getInstance().getAllViewModels();
+  }
+  /**
+   * Clears every registered scenario. Required by tests.
+   */
+  clear() {
+    this.registeredScenarios.clear();
+    this.scenarioMetadata.clear();
+  }
+};
+
+// src/scenario/_abstractions/lanka-scenario/ALankaScenario.ts
+var ALankaScenario = class _ALankaScenario {
+  /** A subclass sets this to opt out of self-registration. */
+  static skipAutoRegistration;
+  /**
+   * The self-registration pool.
+   *
+   * Class-level deliberately: a registry of DEFINITIONS, not runtime state. The
+   * classes come from one barrel and both framework instances must see the same
+   * list — splitting it would be divergence, not isolation.
+   */
+  static autoRegisteredScenarios = /* @__PURE__ */ new Set();
+  /** Registers the scenario itself unless the subclass opted out. */
+  constructor() {
+    const constructor = this.constructor;
+    if (!constructor.skipAutoRegistration) {
+      _ALankaScenario.autoRegisteredScenarios.add(this);
+    }
+  }
+  /**
+   * Every scenario that registered itself.
+   *
+   * @internal
+   */
+  static getAutoRegisteredScenarios() {
+    return Array.from(_ALankaScenario.autoRegisteredScenarios);
+  }
+  /**
+   * Clears the auto-registration pool. Required by tests.
+   * @internal
+   */
+  static clearAutoRegisteredScenarios() {
+    _ALankaScenario.autoRegisteredScenarios.clear();
+  }
+  /**
+   * Registers the scenario by hand.
+   *
+   * @returns `false` when it was already registered
+   */
+  register() {
+    return LankaScenariosRegistry.getInstance().register(this);
+  }
+  /**
+   * Removes the scenario from the registry.
+   *
+   * @returns `false` when it was not there
+   */
+  unregister() {
+    return LankaScenariosRegistry.getInstance().unregister(this.name);
+  }
+  trigger(data) {
+    lankaLogger.printScenarioLog("TRIGGER Scenario", this.name, data);
+    lankaEventBus.dispatch(this.eventType, data, this.name);
+  }
+  /**
+   * Subscribes a handler and returns an unsubscribe function.
+   *
+   * Without the return, unsubscribing is possible only by callback identity, and
+   * every ViewModel factory has to keep a map of references for it.
+   */
+  subscribe(callback, options) {
+    lankaLogger.printScenarioLog("SUBSCRIBE Scenario", this.name, this.dataTypeName);
+    return lankaEventBus.subscribe(this.eventType, callback, {
+      ...options,
+      usedBy: options?.usedBy ?? this.name
+    });
+  }
+};
+
+// ../tools/testing/_fixtures/.lanka_di/Scenarios.ts
+var Scenarios_exports = {};
+
+export {
+  lankaEventBus,
+  ALankaScenario,
+  LankaScenarioVMRegistry,
+  LankaScenariosRegistry,
+  Scenarios_exports
+};
+//# sourceMappingURL=chunk-EWVDJYCC.js.map