@senpi/trading-runtime 1.0.0

package/dist/scanners/artifacts.js

@@ -0,0 +1,72 @@
+import { Type } from "@sinclair/typebox";
+/** Macro market environment classification. */
+export var MarketRegime;
+(function (MarketRegime) {
+    MarketRegime["BULLISH"] = "BULLISH";
+    MarketRegime["BEARISH"] = "BEARISH";
+    MarketRegime["NEUTRAL"] = "NEUTRAL";
+})(MarketRegime || (MarketRegime = {}));
+export function defineSharedArtifact(key, options) {
+    return { key, ...options };
+}
+/** Creates one scanner-side binding for consumed shared market intelligence. */
+export function consumeSharedArtifact(contract, options = {}) {
+    return {
+        contract,
+        ...options,
+    };
+}
+const instrumentContextSchema = Type.Object({
+    markPx: Type.Number(),
+    prevDayPx: Type.Number(),
+    midPx: Type.Number(),
+    dayNtlVlm: Type.Number(),
+    openInterest: Type.Number(),
+    funding: Type.Number(),
+}, { additionalProperties: true });
+const prescreenedCandidateSchema = Type.Object({
+    name: Type.String(),
+    context: instrumentContextSchema,
+    maxLeverage: Type.Number(),
+    score: Type.Number(),
+    changePct: Type.Number(),
+    volume: Type.Number(),
+    openInterest: Type.Number(),
+});
+const oiSnapshotSchema = Type.Object({
+    oi: Type.Number(),
+    price: Type.Number(),
+    timestamp: Type.Number(),
+});
+export const prescreenedArtifactSchema = Type.Object({
+    timestamp: Type.Number(),
+    candidates: Type.Array(prescreenedCandidateSchema),
+});
+export const oiHistoryArtifactSchema = Type.Record(Type.String(), Type.Array(oiSnapshotSchema));
+export const btcCacheArtifactSchema = Type.Record(Type.String(), Type.Unknown());
+export const prescreenedArtifact = defineSharedArtifact("prescreened", {
+    description: "Ranked liquid instruments published by the prescreener for downstream scanners.",
+    schema: prescreenedArtifactSchema,
+});
+export const oiHistoryArtifact = defineSharedArtifact("oi-history", {
+    description: "Rolling open-interest history keyed by asset name.",
+    schema: oiHistoryArtifactSchema,
+});
+export const btcCacheArtifact = defineSharedArtifact("btc-cache", {
+    description: "Shared BTC market context cache for scanners that need a global BTC reference.",
+    schema: btcCacheArtifactSchema,
+});
+export const marketRegimeArtifactSchema = Type.Object({
+    regime: Type.Enum(MarketRegime),
+    confidence: Type.Number(),
+    btcBias: Type.Enum(MarketRegime),
+    ethBias: Type.Enum(MarketRegime),
+    btcWeight: Type.Number(),
+    ethWeight: Type.Number(),
+    timestamp: Type.Number(),
+});
+export const marketRegimeArtifact = defineSharedArtifact("market-regime", {
+    description: "Macro market regime classification (BULLISH/BEARISH/NEUTRAL) from BTC+ETH analysis.",
+    schema: marketRegimeArtifactSchema,
+});
+//# sourceMappingURL=artifacts.js.map

package/dist/scanners/artifacts.js.map

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

package/dist/scanners/create-scanner.d.ts

@@ -0,0 +1,13 @@
+import type { ScanContext, ScannerInitContext } from "./protocol/context.js";
+import type { ScannerHooks } from "./protocol/hooks.js";
+import type { Scanner } from "./protocol/scanner.js";
+import type { ScannerDefinition } from "./scanner-definition.js";
+import type { ScannerScanOutput } from "./types.js";
+export interface CreateScannerOptions<Cfg = unknown, St = unknown> extends ScannerDefinition<Cfg, St> {
+    hooks?: ScannerHooks<Cfg, St>;
+    initialize?: (ctx: ScannerInitContext<Cfg, St>) => Promise<void>;
+    scan: (ctx: ScanContext<Cfg, St>) => Promise<ScannerScanOutput>;
+}
+/** Creates a scanner from declarative definition metadata and lifecycle handlers. */
+export declare function createScanner<Cfg = unknown, St = unknown>(options: CreateScannerOptions<Cfg, St>): Scanner<Cfg, St>;
+//# sourceMappingURL=create-scanner.d.ts.map

package/dist/scanners/create-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/create-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAC/D,SAAQ,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACvD,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,GACrC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CASlB"}

package/dist/scanners/create-scanner.js

@@ -0,0 +1,11 @@
+/** Creates a scanner from declarative definition metadata and lifecycle handlers. */
+export function createScanner(options) {
+    const { hooks, initialize, scan, ...definition } = options;
+    return {
+        definition,
+        hooks,
+        initialize: initialize ?? (async () => undefined),
+        scan,
+    };
+}
+//# sourceMappingURL=create-scanner.js.map

package/dist/scanners/create-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scanner.js","sourceRoot":"","sources":["../../src/scanners/create-scanner.ts"],"names":[],"mappings":"AAaA,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,OAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAE3D,OAAO;QACL,UAAU;QACV,KAAK;QACL,UAAU,EAAE,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QACjD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/scanners/engine/config-validator.d.ts

@@ -0,0 +1,7 @@
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { ScannerId } from "../types.js";
+/** Validates scanner config against the definition's TypeBox schema. Throws on failure. */
+export declare function assertValidConfig(definition: ScannerDefinition, config: unknown, address: string, scannerId: ScannerId): void;
+/** Validates scanner-local runtime state when a state schema is declared. */
+export declare function assertValidState(definition: Pick<ScannerDefinition<unknown, unknown>, "stateSchema">, state: unknown, address: string, scannerId: ScannerId, subject?: string): void;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/scanners/engine/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,IAAI,CAQN;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,EACpE,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,SAAU,GAChB,IAAI,CAQN"}

package/dist/scanners/engine/config-validator.js

@@ -0,0 +1,16 @@
+import { describeSchemaValidationError, isSchemaValueValid, } from "../schema-utils.js";
+/** Validates scanner config against the definition's TypeBox schema. Throws on failure. */
+export function assertValidConfig(definition, config, address, scannerId) {
+    if (isSchemaValueValid(definition.configSchema, config)) {
+        return;
+    }
+    throw new Error(`Invalid config for scanner '${scannerId}' in strategy '${address}': ${describeSchemaValidationError(definition.configSchema, config)}`);
+}
+/** Validates scanner-local runtime state when a state schema is declared. */
+export function assertValidState(definition, state, address, scannerId, subject = "state") {
+    if (!definition.stateSchema || isSchemaValueValid(definition.stateSchema, state)) {
+        return;
+    }
+    throw new Error(`Invalid ${subject} for scanner '${scannerId}' in strategy '${address}': ${describeSchemaValidationError(definition.stateSchema, state)}`);
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/scanners/engine/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../../src/scanners/engine/config-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAC/B,UAA6B,EAC7B,MAAe,EACf,OAAe,EACf,SAAoB;IAEpB,IAAI,kBAAkB,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CACxI,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,UAAoE,EACpE,KAAc,EACd,OAAe,EACf,SAAoB,EACpB,OAAO,GAAG,OAAO;IAEjB,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,kBAAkB,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,iBAAiB,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAC1I,CAAC;AACJ,CAAC"}

package/dist/scanners/engine/data-providers.d.ts

@@ -0,0 +1,43 @@
+import type { RuntimeStore } from "../store/runtime-store.js";
+import type { SharedArtifactStore } from "../store/shared-artifact-store.js";
+import type { SignalStore } from "../store/signal-store.js";
+import type { CandlesByAsset, ScannerLogger, SharedArtifactAccessor } from "../protocol/context.js";
+import type { Instrument, ScannerId, SmMarket } from "../types.js";
+import type { ScannerEngineLifecycle } from "./lifecycle.js";
+/** Minimal active-position shape consumed by scanner contexts. */
+export type ActivePosition = Record<string, unknown>;
+/** Optional metadata passed to candle providers to optimize request fanout. */
+export interface CandleProviderOptions {
+    /** Scanner id requesting candle data. */
+    scannerId?: ScannerId;
+    /** Preferred candidate assets pre-selected by upstream artifacts (for example prescreener). */
+    preferredAssets?: string[];
+}
+/**
+ * External data sources used by the engine for provider-backed inputs only.
+ * Shared market intelligence is resolved separately through shared artifact bindings.
+ */
+export interface ScannerDataProviders {
+    getInstruments?: (address: string) => Promise<Instrument[]>;
+    getCandles?: (address: string, instruments: Instrument[], options?: CandleProviderOptions) => Promise<CandlesByAsset>;
+    getOiHistory?: (address: string) => Promise<Record<string, import("../types.js").OiSnapshot[]>>;
+    getSmData?: (address: string) => Promise<SmMarket[]>;
+    getActivePositions?: (address: string) => Promise<ActivePosition[]>;
+}
+/** Stores required by the scanner engine runtime. */
+export interface ScannerEngineStores {
+    runtimeStore: RuntimeStore;
+    signalStore: SignalStore;
+    sharedArtifactStore: SharedArtifactStore;
+}
+/** Constructor options for scanner engine orchestration. */
+export interface ScannerEngineDependencies {
+    stores: ScannerEngineStores;
+    providers?: ScannerDataProviders;
+    logger?: ScannerLogger;
+    lifecycle?: ScannerEngineLifecycle;
+    now?: () => number;
+}
+/** Shared-artifact store accessors exposed through scanner init/run contexts. */
+export declare function createSharedArtifactAccessor(address: string, sharedArtifactStore: SharedArtifactStore): SharedArtifactAccessor;
+//# sourceMappingURL=data-providers.d.ts.map

package/dist/scanners/engine/data-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-providers.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAET,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAChG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACrE;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,mBAAmB,GACvC,sBAAsB,CAYxB"}

package/dist/scanners/engine/data-providers.js

@@ -0,0 +1,8 @@
+/** Shared-artifact store accessors exposed through scanner init/run contexts. */
+export function createSharedArtifactAccessor(address, sharedArtifactStore) {
+    return {
+        loadSharedArtifact: (artifact, opts) => sharedArtifactStore.load(address, artifact, opts),
+        saveSharedArtifact: (artifact, value) => sharedArtifactStore.save(address, artifact, value),
+    };
+}
+//# sourceMappingURL=data-providers.js.map

package/dist/scanners/engine/data-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-providers.js","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AA+DA,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC1C,OAAe,EACf,mBAAwC;IAExC,OAAO;QACL,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,IAA4B,EACc,EAAE,CAC5C,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC;QACnD,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,KAA+B,EAChB,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/scanners/engine/engine.d.ts

@@ -0,0 +1,76 @@
+import type { Scanner } from "../protocol/scanner.js";
+import type { ScanResult, ScannerId, StrategyRegistration } from "../types.js";
+import { type ScannerEngineDependencies } from "./data-providers.js";
+import { StrategyRegistry } from "./strategy-registry.js";
+/** Public scanner registration shape exposed for list operations. */
+export interface ScannerRegistrationSummary {
+    address: string;
+    scannerId: ScannerId;
+    enabled: boolean;
+    intervalSeconds: number;
+}
+/** Runtime engine for scanner registration, scheduling, and one-off execution. */
+export declare class ScannerEngine {
+    private readonly deps;
+    private readonly providers;
+    private readonly now;
+    private readonly registry;
+    private started;
+    private readonly inFlight;
+    constructor(deps: ScannerEngineDependencies, registry?: StrategyRegistry);
+    /** Registers one scanner for one strategy runtime. */
+    register<Cfg = unknown, St = unknown>(strategy: StrategyRegistration, scanner: Scanner<Cfg, St>): void;
+    /** Enables scanner execution for one strategy + scanner key. */
+    enable(address: string, scannerId: ScannerId): void;
+    /** Disables scanner execution and clears active timer if present. */
+    disable(address: string, scannerId: ScannerId): void;
+    /** Starts interval scheduling for all enabled scanner registrations. */
+    start(): Promise<void>;
+    /** Stops all interval schedules and awaits in-flight runs before resolving. */
+    stop(): Promise<void>;
+    /** Lists registered scanners, optionally constrained to one strategy address. */
+    list(address?: string): ScannerRegistrationSummary[];
+    /** Reads scanner runtime config, bootstrapping runtime state when missing. */
+    getConfig(address: string, scannerId: ScannerId): Promise<unknown>;
+    /** Writes scanner runtime config after schema validation. */
+    setConfig(address: string, scannerId: ScannerId, config: unknown): Promise<void>;
+    /**
+     * Executes one scanner run for one (address, scannerId) key.
+     * Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
+     */
+    runOnce(address: string, scannerId: ScannerId): Promise<ScanResult>;
+    /**
+     * Builds a terminal result for pre-run guard failures such as disabled scanners
+     * or an overlapping in-flight execution for the same strategy/scanner pair.
+     */
+    private buildEarlyExitResult;
+    /**
+     * Ensures persisted runtime state exists, validates config/state, and runs the
+     * scanner's one-time initialization lifecycle before the first scan.
+     */
+    private ensureInitializedRuntime;
+    /**
+     * Builds the scan context for one run and applies the optional `beforeScan`
+     * hook, allowing scanners to gate or augment the prepared context.
+     */
+    private buildPreparedContext;
+    private buildFailureResult;
+    private schedule;
+    private buildInitContext;
+    private buildScanContext;
+    /**
+     * Persists a terminal run result only when the scanner's persistence policy
+     * says the result should be written to disk.
+     */
+    private persistIfNeeded;
+    /**
+     * Returns the registered strategy/scanner runtime entry or throws when the
+     * requested pair is unknown to the engine.
+     */
+    private requireRegistration;
+    private defaultStateFor;
+    private ensureValidState;
+    private emitRunStart;
+    private emitRunResult;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/scanners/engine/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAET,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAIhC,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,kFAAkF;AAClF,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAGrC,IAAI,EAAE,yBAAyB,EAChD,QAAQ,CAAC,EAAE,gBAAgB;IAO7B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GACxB,IAAI;IASP,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAYnD,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAWpD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,+EAA+E;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,iFAAiF;IACjF,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,0BAA0B,EAAE;IASpD,8EAA8E;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxE,6DAA6D;IACvD,SAAS,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDzE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;;OAGG;YACW,wBAAwB;IAgCtC;;;OAGG;YACW,oBAAoB;IAYlC,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,QAAQ;IAuChB,OAAO,CAAC,gBAAgB;YAuCV,gBAAgB;IAmB9B;;;OAGG;YACW,eAAe;IAW7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;YAqBT,gBAAgB;IA2B9B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,aAAa;CAWtB"}