@kronos-ts/app 0.1.0

package/dist/decorator.js

@@ -0,0 +1,36 @@
+/**
+ * @internal — used by `Defaults` and by `kronos()` bootstrap (Plan 02) to
+ * mint pre-allocated framework-default handles with stable identity.
+ */
+export function makeFrameworkHandle(slot, name) {
+    return Object.freeze({
+        __slot: slot,
+        __id: Symbol(`${slot}.${name}`),
+        __name: name,
+    });
+}
+/**
+ * Apply all decorator registrations for a given slot in two passes:
+ * 1. Framework defaults first (innermost, handler-adjacent)
+ * 2. User decorators after (outer; last .decorate() = outermost wrap)
+ *
+ * Both passes iterate `registrations` in registration order so a
+ * left-to-right reduce composes correctly (each factory wraps the current value).
+ */
+export function applyDecorators(slot, base, registrations, resolved) {
+    let current = base;
+    // Pass 1: framework defaults (innermost)
+    for (const reg of registrations) {
+        if (reg.handle.__slot !== slot || !reg.frameworkDefault)
+            continue;
+        current = reg.factory(current, resolved);
+    }
+    // Pass 2: user decorators (outer)
+    for (const reg of registrations) {
+        if (reg.handle.__slot !== slot || reg.frameworkDefault)
+            continue;
+        current = reg.factory(current, resolved);
+    }
+    return current;
+}
+//# sourceMappingURL=decorator.js.map

package/dist/decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.js","sourceRoot":"","sources":["../src/decorator.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAO,EACP,IAAY;IAEZ,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,EAAE,IAAI;KACb,CAAuB,CAAA;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAO,EACP,IAAyB,EACzB,aAA4C,EAC5C,QAAkB;IAElB,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,SAAQ;QACjE,OAAO,GAAI,GAAG,CAAC,OAA0C,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC9E,CAAC;IACD,kCAAkC;IAClC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,gBAAgB;YAAE,SAAQ;QAChE,OAAO,GAAI,GAAG,CAAC,OAA0C,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/defaults-handles.d.ts

@@ -0,0 +1,25 @@
+import { type DecoratorHandle } from "./decorator.js";
+/**
+ * Global static module export — frozen handle identities for framework-default
+ * decorators (D-54). Per-app decorator state lives on `AppState`; `Defaults`
+ * only carries handle *identities*.
+ *
+ * Plan 02 wires the actual factories in `kronos()` bootstrap, keyed by these
+ * handles. Plan 01 ships the handle constants only — having them in place
+ * lets users write `app.removeDecorator(Defaults.commandBus.intercepting)`
+ * even before Plan 02 registers the factories (the call will throw
+ * `UnknownDecoratorHandleError` until Plan 02 lands, which is correct
+ * behavior for now and ratchets to the real removal once Plan 02 ships).
+ */
+export declare const Defaults: {
+    readonly commandBus: {
+        readonly intercepting: DecoratorHandle<"commandBus">;
+    };
+    readonly queryBus: {
+        readonly intercepting: DecoratorHandle<"queryBus">;
+    };
+    readonly eventBus: {
+        readonly intercepting: DecoratorHandle<"eventBus">;
+    };
+};
+//# sourceMappingURL=defaults-handles.d.ts.map

package/dist/defaults-handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-handles.d.ts","sourceRoot":"","sources":["../src/defaults-handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,EAUf;IACJ,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;KAAE,CAAA;IAC7E,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;KAAE,CAAA;IACzE,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;KAAE,CAAA;CAC1E,CAAA"}

package/dist/defaults-handles.js

@@ -0,0 +1,25 @@
+import { makeFrameworkHandle } from "./decorator.js";
+/**
+ * Global static module export — frozen handle identities for framework-default
+ * decorators (D-54). Per-app decorator state lives on `AppState`; `Defaults`
+ * only carries handle *identities*.
+ *
+ * Plan 02 wires the actual factories in `kronos()` bootstrap, keyed by these
+ * handles. Plan 01 ships the handle constants only — having them in place
+ * lets users write `app.removeDecorator(Defaults.commandBus.intercepting)`
+ * even before Plan 02 registers the factories (the call will throw
+ * `UnknownDecoratorHandleError` until Plan 02 lands, which is correct
+ * behavior for now and ratchets to the real removal once Plan 02 ships).
+ */
+export const Defaults = Object.freeze({
+    commandBus: Object.freeze({
+        intercepting: makeFrameworkHandle("commandBus", "intercepting"),
+    }),
+    queryBus: Object.freeze({
+        intercepting: makeFrameworkHandle("queryBus", "intercepting"),
+    }),
+    eventBus: Object.freeze({
+        intercepting: makeFrameworkHandle("eventBus", "intercepting"),
+    }),
+});
+//# sourceMappingURL=defaults-handles.js.map

package/dist/defaults-handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-handles.js","sourceRoot":"","sources":["../src/defaults-handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAA;AAE1E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE,cAAc,CAAC;KAChE,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC;KAC9D,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC;KAC9D,CAAC;CACH,CAIA,CAAA"}

package/dist/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { App } from "./app.js";
+/**
+ * Register the 8 in-memory defaults (SLT-04, D-51).
+ * Slots flagged inMemory:true emit a startup warning at .start() unless the slot
+ * was overridden via .set/.forceSet (or another .setDefault won — but setDefault
+ * is ifAbsent, so only the FIRST setDefault wins; user setDefault calls on already-defaulted
+ * slots are no-ops, which is the intended SLT-02 semantics).
+ */
+export declare function registerInMemoryDefaults(app: App): void;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAgBnC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAwCvD"}

package/dist/defaults.js

@@ -0,0 +1,49 @@
+import { createInMemoryEventStore, createInMemorySnapshotStore, descriptorBasedTagResolver, } from "@kronos-ts/eventsourcing";
+import { createSimpleCommandBus, createSimpleQueryBus, jsonSerializer, runInNewUoW, createInMemoryTokenStore, noTransactionManager, } from "@kronos-ts/messaging";
+/**
+ * Register the 8 in-memory defaults (SLT-04, D-51).
+ * Slots flagged inMemory:true emit a startup warning at .start() unless the slot
+ * was overridden via .set/.forceSet (or another .setDefault won — but setDefault
+ * is ifAbsent, so only the FIRST setDefault wins; user setDefault calls on already-defaulted
+ * slots are no-ops, which is the intended SLT-02 semantics).
+ */
+export function registerInMemoryDefaults(app) {
+    // Durability-flagged defaults (SLT-04 warning fires unless overridden):
+    app.setDefault("eventStore", () => createInMemoryEventStore(), {
+        inMemory: true,
+        warning: "[kronos] eventStore: in-memory — not durable, configure an extension for production",
+    });
+    app.setDefault("snapshotStore", () => createInMemorySnapshotStore(), {
+        inMemory: true,
+        warning: "[kronos] snapshotStore: in-memory — not durable, configure an extension for production",
+    });
+    app.setDefault("commandBus", () => createSimpleCommandBus(), {
+        inMemory: true,
+        warning: "[kronos] commandBus: in-memory — single-process only, configure an extension for distribution",
+    });
+    app.setDefault("queryBus", () => createSimpleQueryBus(), {
+        inMemory: true,
+        warning: "[kronos] queryBus: in-memory — single-process only, configure an extension for distribution",
+    });
+    // EventBus default: in ES setups EventStore IS the EventBus (configurer mirrors this at line 796)
+    app.setDefault("eventBus", ({ eventStore }) => eventStore, {
+        inMemory: true,
+        warning: "[kronos] eventBus: in-memory — single-process only",
+    });
+    // Stateless / non-durability-implied defaults — NO inMemory flag, no warning emission:
+    app.setDefault("serializer", () => jsonSerializer());
+    app.setDefault("unitOfWorkFactory", () => runInNewUoW);
+    app.setDefault("tagResolver", () => descriptorBasedTagResolver());
+    // Plan 09-01 (D-84): typed slots for token persistence + transactional wrapping.
+    // Both default to in-memory — extensions (KronosDB, Drizzle/Knex/Kysely token stores,
+    // user-supplied TransactionManagers) override via app.set('tokenStore', ...) etc.
+    app.setDefault("tokenStore", () => createInMemoryTokenStore(), {
+        inMemory: true,
+        warning: "[kronos] tokenStore: in-memory — not durable, configure a persistence extension for production",
+    });
+    app.setDefault("transactionManager", () => noTransactionManager(), {
+        inMemory: true,
+        warning: "[kronos] transactionManager: in-memory — pass-through, configure a transactional extension for production",
+    });
+}
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAQ;IAC/C,wEAAwE;IACxE,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,wBAAwB,EAAE,EAAE;QAC7D,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,qFAAqF;KAC/F,CAAC,CAAA;IACF,GAAG,CAAC,UAAU,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,2BAA2B,EAAE,EAAE;QACnE,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,wFAAwF;KAClG,CAAC,CAAA;IACF,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;QAC3D,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,+FAA+F;KACzG,CAAC,CAAA;IACF,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE;QACvD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,6FAA6F;KACvG,CAAC,CAAA;IACF,kGAAkG;IAClG,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAiC,EAAE;QAChF,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,oDAAoD;KAC9D,CAAC,CAAA;IAEF,uFAAuF;IACvF,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAA;IACpD,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAA;IACtD,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,0BAA0B,EAAE,CAAC,CAAA;IAEjE,iFAAiF;IACjF,sFAAsF;IACtF,kFAAkF;IAClF,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,wBAAwB,EAAE,EAAE;QAC7D,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,gGAAgG;KAC1G,CAAC,CAAA;IACF,GAAG,CAAC,UAAU,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE;QACjE,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,2GAA2G;KACrH,CAAC,CAAA;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+import type { SlotName } from "./components.js";
+import type { DecoratorHandle } from "./decorator.js";
+/**
+ * Thrown when buildResolved detects a cycle: a factory's getter on Resolved re-enters
+ * a slot that is currently being resolved. (D-52 cycle-detection contract.)
+ */
+export declare class CircularSlotDependencyError extends Error {
+    readonly slot: SlotName;
+    readonly chain: readonly SlotName[];
+    constructor(slot: SlotName, chain: readonly SlotName[]);
+}
+/** Thrown when a Resolved getter touches a slot that has no registered factory. */
+export declare class SlotNotRegisteredError extends Error {
+    readonly slot: SlotName;
+    constructor(slot: SlotName);
+}
+/**
+ * Thrown when `app.commandGateway` or `app.queryGateway` is accessed before
+ * the `register` lifecycle stage completes during `.start()`. Available inside
+ * `onStart('warmup'|'register'|'processors'|'serve', fn)` hooks AFTER register
+ * completes, and after `.start()` resolves. (Plan 08-01.)
+ */
+export declare class AppNotStartedError extends Error {
+    constructor(accessor: string);
+}
+/**
+ * Thrown by `app.removeDecorator(handle)` when the handle is not found in the
+ * app's registration list (D-59). Catches typos like
+ * `Defaults.commandBus.interceptingg` and removal of a handle that was never
+ * registered (e.g., framework default whose factory hasn't been wired yet).
+ */
+export declare class UnknownDecoratorHandleError extends Error {
+    readonly slot: SlotName;
+    readonly handleName: string;
+    constructor(handle: DecoratorHandle<SlotName>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;gBACvB,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE;CAMvD;AAED,mFAAmF;AACnF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;gBACX,IAAI,EAAE,QAAQ;CAK3B;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,QAAQ,EAAE,MAAM;CAM7B;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBACf,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;CAS9C"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+/**
+ * Thrown when buildResolved detects a cycle: a factory's getter on Resolved re-enters
+ * a slot that is currently being resolved. (D-52 cycle-detection contract.)
+ */
+export class CircularSlotDependencyError extends Error {
+    slot;
+    chain;
+    constructor(slot, chain) {
+        super(`[kronos] Circular slot dependency: "${slot}" via [${chain.join(" → ")}]`);
+        this.name = "CircularSlotDependencyError";
+        this.slot = slot;
+        this.chain = chain;
+    }
+}
+/** Thrown when a Resolved getter touches a slot that has no registered factory. */
+export class SlotNotRegisteredError extends Error {
+    slot;
+    constructor(slot) {
+        super(`[kronos] Slot "${slot}" has no registered factory.`);
+        this.name = "SlotNotRegisteredError";
+        this.slot = slot;
+    }
+}
+/**
+ * Thrown when `app.commandGateway` or `app.queryGateway` is accessed before
+ * the `register` lifecycle stage completes during `.start()`. Available inside
+ * `onStart('warmup'|'register'|'processors'|'serve', fn)` hooks AFTER register
+ * completes, and after `.start()` resolves. (Plan 08-01.)
+ */
+export class AppNotStartedError extends Error {
+    constructor(accessor) {
+        super(`[kronos] App not started: ${accessor} is only accessible after register-stage completes during .start().`);
+        this.name = "AppNotStartedError";
+    }
+}
+/**
+ * Thrown by `app.removeDecorator(handle)` when the handle is not found in the
+ * app's registration list (D-59). Catches typos like
+ * `Defaults.commandBus.interceptingg` and removal of a handle that was never
+ * registered (e.g., framework default whose factory hasn't been wired yet).
+ */
+export class UnknownDecoratorHandleError extends Error {
+    slot;
+    handleName;
+    constructor(handle) {
+        super(`[kronos] Unknown decorator handle "${handle.__name}" for slot "${handle.__slot}". ` +
+            `Either it was never registered or it was already removed.`);
+        this.name = "UnknownDecoratorHandleError";
+        this.slot = handle.__slot;
+        this.handleName = handle.__name;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,CAAU;IACd,KAAK,CAAqB;IACnC,YAAY,IAAc,EAAE,KAA0B;QACpD,KAAK,CAAC,uCAAuC,IAAI,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAChF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAA;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,CAAU;IACvB,YAAY,IAAc;QACxB,KAAK,CAAC,kBAAkB,IAAI,8BAA8B,CAAC,CAAA;QAC3D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,QAAgB;QAC1B,KAAK,CACH,6BAA6B,QAAQ,qEAAqE,CAC3G,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,CAAU;IACd,UAAU,CAAQ;IAC3B,YAAY,MAAiC;QAC3C,KAAK,CACH,sCAAsC,MAAM,CAAC,MAAM,eAAe,MAAM,CAAC,MAAM,KAAK;YAClF,2DAA2D,CAC9D,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAA;QACzC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAA;IACjC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { KronosComponents, SlotName } from "./components.js";
+export { ALL_SLOTS } from "./components.js";
+export { CircularSlotDependencyError, SlotNotRegisteredError } from "./errors.js";
+export { SlotRegistry, type SlotMeta, type SlotEntry, type SlotFactory } from "./slot-registry.js";
+export { buildResolved, type Resolved } from "./resolved.js";
+export { createWarningChannel, type WarningLogger, type WarningChannelOptions, type WarningChannel, } from "./warnings.js";
+export { AppImpl, AppAlreadyStartedError, type App, type RunningApp, type Extension, type AppState, type AppImplOptions, type KronosIdentity, } from "./app.js";
+export { registerInMemoryDefaults } from "./defaults.js";
+export { kronos, type KronosPartialConfig } from "./kronos.js";
+export { type DecoratorHandle, type DecoratorFactory, type DecoratorEntry, applyDecorators, } from "./decorator.js";
+export { Defaults } from "./defaults-handles.js";
+export { UnknownDecoratorHandleError, AppNotStartedError } from "./errors.js";
+export type { LifecycleStage, LifecycleHook } from "./lifecycle.js";
+export type { TokenStore, TransactionManager } from "@kronos-ts/messaging";
+export type { HandlerEnhancerDefinition } from "@kronos-ts/messaging";
+export type { StateOptions, StatesArg } from "./app.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,OAAO,EACP,sBAAsB,EACtB,KAAK,GAAG,EACR,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE1E,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { ALL_SLOTS } from "./components.js";
+export { CircularSlotDependencyError, SlotNotRegisteredError } from "./errors.js";
+export { SlotRegistry } from "./slot-registry.js";
+export { buildResolved } from "./resolved.js";
+export { createWarningChannel, } from "./warnings.js";
+export { AppImpl, AppAlreadyStartedError, } from "./app.js";
+export { registerInMemoryDefaults } from "./defaults.js";
+export { kronos } from "./kronos.js";
+export { applyDecorators, } from "./decorator.js";
+export { Defaults } from "./defaults-handles.js";
+export { UnknownDecoratorHandleError, AppNotStartedError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,YAAY,EAAmD,MAAM,oBAAoB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAiB,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,oBAAoB,GAIrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,OAAO,EACP,sBAAsB,GAOvB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAA;AAC9D,OAAO,EAIL,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/kronos.d.ts

@@ -0,0 +1,51 @@
+import type { StateModule } from "@kronos-ts/modelling";
+import type { CommandHandlerDefinition, QueryHandlerDefinition, EventProcessorModule } from "@kronos-ts/messaging";
+import { type App } from "./app.js";
+import { type WarningLogger } from "./warnings.js";
+/**
+ * Partial-config shorthand options for kronos(). APP-02.
+ *
+ * Domain registrations passed here are appended to the same internal accumulators
+ * as fluent .states()/.commands()/etc. calls. quiet/logger configure the warning
+ * channel BEFORE in-memory defaults are registered.
+ */
+export interface KronosPartialConfig {
+    states?: StateModule[];
+    commands?: CommandHandlerDefinition<any, any>[];
+    queries?: QueryHandlerDefinition[];
+    processors?: EventProcessorModule[];
+    quiet?: boolean;
+    logger?: WarningLogger;
+    /** Stable logical service/application name. Same across replicas. */
+    serviceName?: string;
+    /** Unique physical runtime instance id. Different per process/pod. */
+    instanceId?: string;
+    /**
+     * Per-stage timeout (ms) for native lifecycle execution (D-77).
+     * If a single stage exceeds this, AppImpl emits a warning and continues
+     * to the next stage WITHOUT cancelling the slow hooks (warn-then-continue).
+     *
+     * Default: 5000.
+     */
+    stageTimeoutMs?: number;
+}
+/**
+ * Create a new Kronos App.
+ *
+ * ```typescript
+ * const app = await kronos()
+ *   .states(Course)
+ *   .commands(createCourseHandler)
+ *   .start()
+ *
+ * await app.commandGateway.send(CreateCourse, { courseId: "cs-101", name: "Intro" }, emptyMetadata())
+ * ```
+ *
+ * Or with a partial config (APP-02):
+ *
+ * ```typescript
+ * const app = await kronos({ states: [Course], commands: [createCourseHandler], quiet: true }).start()
+ * ```
+ */
+export declare function kronos(partial?: KronosPartialConfig): App;
+//# sourceMappingURL=kronos.d.ts.map

package/dist/kronos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kronos.d.ts","sourceRoot":"","sources":["../src/kronos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,EAAW,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAGxE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;IAC/C,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAA;IAClC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,GAAG,CAsDzD"}

package/dist/kronos.js

@@ -0,0 +1,74 @@
+import { createInterceptingCommandBus, createInterceptingQueryBus, createInterceptingEventBus, } from "@kronos-ts/messaging";
+import { AppImpl } from "./app.js";
+import { registerInMemoryDefaults } from "./defaults.js";
+import { createWarningChannel } from "./warnings.js";
+import { Defaults } from "./defaults-handles.js";
+/**
+ * Create a new Kronos App.
+ *
+ * ```typescript
+ * const app = await kronos()
+ *   .states(Course)
+ *   .commands(createCourseHandler)
+ *   .start()
+ *
+ * await app.commandGateway.send(CreateCourse, { courseId: "cs-101", name: "Intro" }, emptyMetadata())
+ * ```
+ *
+ * Or with a partial config (APP-02):
+ *
+ * ```typescript
+ * const app = await kronos({ states: [Course], commands: [createCourseHandler], quiet: true }).start()
+ * ```
+ */
+export function kronos(partial) {
+    const warningChannel = createWarningChannel({ quiet: partial?.quiet, logger: partial?.logger });
+    const app = new AppImpl({
+        warningChannel,
+        stageTimeoutMs: partial?.stageTimeoutMs,
+        serviceName: partial?.serviceName,
+        instanceId: partial?.instanceId,
+    });
+    // Register in-memory defaults FIRST so user partial-config / fluent calls override them
+    // via set/forceSet (setDefault is ifAbsent — first registration wins).
+    registerInMemoryDefaults(app);
+    // Register framework-default `intercepting` decorators for the 3 buses (DEC-02, D-57).
+    // Each closure reads `app._state.{bus}DispatchInterceptors` + `app._state.handlerInterceptors`
+    // at decoration time (i.e., during .start()) — extensions and user code populate these
+    // arrays before .start() runs, so the snapshot is complete by the time the closure fires.
+    // Removable via `removeDecorator(Defaults.{bus}.intercepting)`.
+    app._registerFrameworkDefaultDecorator(Defaults.commandBus.intercepting, (inner, _resolved) => {
+        const wrapped = createInterceptingCommandBus(inner);
+        for (const fn of app._state.commandDispatchInterceptors)
+            wrapped.registerDispatchInterceptor(fn);
+        for (const fn of app._state.handlerInterceptors)
+            wrapped.registerHandlerInterceptor(fn);
+        return wrapped;
+    });
+    app._registerFrameworkDefaultDecorator(Defaults.queryBus.intercepting, (inner, _resolved) => {
+        const wrapped = createInterceptingQueryBus(inner);
+        for (const fn of app._state.queryDispatchInterceptors)
+            wrapped.registerDispatchInterceptor(fn);
+        for (const fn of app._state.handlerInterceptors)
+            wrapped.registerHandlerInterceptor(fn);
+        return wrapped;
+    });
+    app._registerFrameworkDefaultDecorator(Defaults.eventBus.intercepting, (inner, _resolved) => {
+        // EventBus intercepting wrapper takes its dispatch interceptors at construction time;
+        // it has no register* methods and no handler interceptor concept (verified
+        // packages/messaging/src/intercepting-event-bus.ts — no handlerInterceptors field).
+        // Snapshot the array at decoration time; mutations after .start() are blocked
+        // by the AppAlreadyStartedError guard on `eventDispatchInterceptor()`.
+        return createInterceptingEventBus(inner, [...app._state.eventDispatchInterceptors]);
+    });
+    if (partial?.states)
+        app.states(...partial.states);
+    if (partial?.commands)
+        app.commands(...partial.commands);
+    if (partial?.queries)
+        app.queries(...partial.queries);
+    if (partial?.processors)
+        app.processors(...partial.processors);
+    return app;
+}
+//# sourceMappingURL=kronos.js.map

package/dist/kronos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kronos.js","sourceRoot":"","sources":["../src/kronos.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Typed lifecycle stages for app-level startup/shutdown hooks (LIF-01).
+ *
+ * Forward order on `.start()`: connect → warmup → register → processors → serve.
+ * Reverse order on `.stop()`:  serve → processors → register → warmup → connect.
+ *
+ * Within a single stage, hooks execute in registration order (no `{stage, order}`
+ * tiebreaker — D-70 defers it until a real consumer asks).
+ *
+ * Closed string union by design (LIF-01). NOT extensible via declaration merging.
+ */
+export type LifecycleStage = "connect" | "register" | "warmup" | "processors" | "serve";
+/**
+ * Hook signature for `app.onStart(stage, fn)` / `app.onStop(stage, fn)` (LIF-02, D-69).
+ *
+ * Bare zero-arg shape. Extensions close over their own state from the enclosing
+ * `(app: App) => void` extension scope (see DESIGN.md §12 KronosDB pattern).
+ *
+ * Why no `Resolved` arg: the Resolved proxy exists for slot-factory composition
+ * (Phase 5 D-52); lifecycle hooks are a different concern.
+ *
+ * Why no `Configuration` arg: matching the legacy `LifecycleHandler(config?: any)`
+ * signature would couple this public type to the configurer's `Configuration` —
+ * a Phase 8 deletion target.
+ */
+export type LifecycleHook = () => void | Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAA;AAEvF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/lifecycle.js

@@ -0,0 +1,7 @@
+export {};
+// Plan 08-03a (D-77): the legacy numeric-phase mapping is deleted. Native
+// AppImpl.start() executes typed-stage hooks directly off
+// AppState.startHooks/stopHooks — no numeric-phase bridge to the legacy
+// LifecycleRegistry. Plan 03b's enhancer-bridge keeps a private inverted copy
+// locally for the D-81 fallback path.
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":";AA4BA,0EAA0E;AAC1E,0DAA0D;AAC1D,wEAAwE;AACxE,8EAA8E;AAC9E,sCAAsC"}

package/dist/resolved.d.ts

@@ -0,0 +1,18 @@
+import type { KronosComponents } from "./components.js";
+import type { SlotRegistry } from "./slot-registry.js";
+/**
+ * Resolved is structurally identical to KronosComponents — the destructured arg
+ * passed to factories. We re-export the alias so user code reads `Resolved` not `KronosComponents`.
+ */
+export type Resolved = KronosComponents;
+/**
+ * Build a lazy + memoized Resolved Proxy backed by the registry. (D-52.)
+ *
+ * - Each property access invokes the slot's factory once and memoizes
+ * - Factories receive the same proxy as their argument so dependency chains compose
+ * - A `resolving` Set detects cycles: if a getter is hit while its slot is mid-resolution,
+ *   throw CircularSlotDependencyError with the offending chain
+ * - try/finally ensures `resolving` is cleaned even after errors so subsequent accesses still work
+ */
+export declare function buildResolved(registry: SlotRegistry): Resolved;
+//# sourceMappingURL=resolved.d.ts.map

package/dist/resolved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved.d.ts","sourceRoot":"","sources":["../src/resolved.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,iBAAiB,CAAA;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CAAA;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,CAkC9D"}

package/dist/resolved.js

@@ -0,0 +1,43 @@
+import { CircularSlotDependencyError, SlotNotRegisteredError } from "./errors.js";
+/**
+ * Build a lazy + memoized Resolved Proxy backed by the registry. (D-52.)
+ *
+ * - Each property access invokes the slot's factory once and memoizes
+ * - Factories receive the same proxy as their argument so dependency chains compose
+ * - A `resolving` Set detects cycles: if a getter is hit while its slot is mid-resolution,
+ *   throw CircularSlotDependencyError with the offending chain
+ * - try/finally ensures `resolving` is cleaned even after errors so subsequent accesses still work
+ */
+export function buildResolved(registry) {
+    const cache = new Map();
+    const resolving = new Set();
+    const resolvingOrder = [];
+    const handler = {
+        get(_target, prop) {
+            const slot = prop;
+            if (cache.has(slot))
+                return cache.get(slot);
+            if (resolving.has(slot)) {
+                throw new CircularSlotDependencyError(slot, [...resolvingOrder, slot]);
+            }
+            const entry = registry.getEntry(slot);
+            if (!entry) {
+                throw new SlotNotRegisteredError(slot);
+            }
+            resolving.add(slot);
+            resolvingOrder.push(slot);
+            try {
+                const value = entry.factory(proxy);
+                cache.set(slot, value);
+                return value;
+            }
+            finally {
+                resolving.delete(slot);
+                resolvingOrder.pop();
+            }
+        },
+    };
+    const proxy = new Proxy({}, handler);
+    return proxy;
+}
+//# sourceMappingURL=resolved.js.map

package/dist/resolved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved.js","sourceRoot":"","sources":["../src/resolved.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AASjF;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAA;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;IACrC,MAAM,cAAc,GAAe,EAAE,CAAA;IAErC,MAAM,OAAO,GAAyB;QACpC,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,MAAM,IAAI,GAAG,IAAgB,CAAA;YAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAE3C,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,2BAA2B,CAAC,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,IAAI,CAAC,CAAC,CAAA;YACxE,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAA;YACxC,CAAC;YAED,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAiB,CAAC,CAAA;gBAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBACtB,OAAO,KAAK,CAAA;YACd,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACtB,cAAc,CAAC,GAAG,EAAE,CAAA;YACtB,CAAC;QACH,CAAC;KACF,CAAA;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,OAAO,CAAa,CAAA;IAChD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/slot-registry.d.ts

@@ -0,0 +1,35 @@
+import type { KronosComponents, SlotName } from "./components.js";
+/**
+ * Optional metadata attached to a slot entry. Today the only field is
+ * `inMemory` + `warning` (D-51) — used by Plan 02 to emit startup warnings
+ * for any slot still using a flagged in-memory default at .start() time.
+ */
+export interface SlotMeta {
+    inMemory?: true;
+    warning?: string;
+}
+/** Each slot's resolution callable: a factory that takes the destructured Resolved and returns the component. */
+export type SlotFactory<K extends SlotName> = (resolved: KronosComponents) => KronosComponents[K];
+/** A registered slot entry: normalized factory + optional meta. */
+export interface SlotEntry<K extends SlotName = SlotName> {
+    factory: SlotFactory<K>;
+    meta?: SlotMeta;
+}
+/**
+ * SlotRegistry — the storage backing the App's three verbs.
+ * setDefault: ifAbsent (no-op if occupied)
+ * set:        warn on double-set
+ * forceSet:   silent overwrite
+ * (DESIGN.md §6, REQUIREMENTS.md SLT-02.)
+ */
+export declare class SlotRegistry {
+    private readonly slots;
+    setDefault<K extends SlotName>(slot: K, factoryOrInstance: SlotFactory<K> | KronosComponents[K], meta?: SlotMeta): void;
+    set<K extends SlotName>(slot: K, factoryOrInstance: SlotFactory<K> | KronosComponents[K]): void;
+    forceSet<K extends SlotName>(slot: K, factoryOrInstance: SlotFactory<K> | KronosComponents[K]): void;
+    /** @internal — used by buildResolved and by Plan 02's warning emitter. */
+    getEntry<K extends SlotName>(slot: K): SlotEntry<K> | undefined;
+    /** @internal — used by Plan 02 to iterate registered slots for startup warnings. */
+    has(slot: SlotName): boolean;
+}
+//# sourceMappingURL=slot-registry.d.ts.map

package/dist/slot-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-registry.d.ts","sourceRoot":"","sources":["../src/slot-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEjE;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,iHAAiH;AACjH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,QAAQ,EAAE,gBAAgB,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAEjG,mEAAmE;AACnE,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACtD,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAgBD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,UAAU,CAAC,CAAC,SAAS,QAAQ,EAC3B,IAAI,EAAE,CAAC,EACP,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EACvD,IAAI,CAAC,EAAE,QAAQ,GACd,IAAI;IAKP,GAAG,CAAC,CAAC,SAAS,QAAQ,EACpB,IAAI,EAAE,CAAC,EACP,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,GACtD,IAAI;IAeP,QAAQ,CAAC,CAAC,SAAS,QAAQ,EACzB,IAAI,EAAE,CAAC,EACP,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,GACtD,IAAI;IAIP,0EAA0E;IAC1E,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAI/D,oFAAoF;IACpF,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;CAG7B"}