@f-o-t/rules-engine 3.0.1 → 3.0.5

package/dist/optimizer/index-builder.d.ts

@@ -0,0 +1,48 @@
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { Rule } from "../types/rule";
+export type FieldIndex<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = Map<string, ReadonlyArray<Rule<TContext, TConsequences>>>;
+export type TagIndex<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = Map<string, ReadonlyArray<Rule<TContext, TConsequences>>>;
+export type CategoryIndex<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = Map<string, ReadonlyArray<Rule<TContext, TConsequences>>>;
+export type PriorityIndex<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = Map<number, ReadonlyArray<Rule<TContext, TConsequences>>>;
+export type RuleIndex<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly byField: FieldIndex<TContext, TConsequences>;
+    readonly byTag: TagIndex<TContext, TConsequences>;
+    readonly byCategory: CategoryIndex<TContext, TConsequences>;
+    readonly byPriority: PriorityIndex<TContext, TConsequences>;
+    readonly byId: Map<string, Rule<TContext, TConsequences>>;
+    readonly sortedByPriority: ReadonlyArray<Rule<TContext, TConsequences>>;
+};
+export type IndexOptions = {
+    readonly indexByField?: boolean;
+    readonly indexByTag?: boolean;
+    readonly indexByCategory?: boolean;
+    readonly indexByPriority?: boolean;
+};
+export declare const buildIndex: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, options?: IndexOptions) => RuleIndex<TContext, TConsequences>;
+export declare const getRulesByField: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, field: string) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByFields: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, fields: ReadonlyArray<string>, mode?: "any" | "all") => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByTag: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, tag: string) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByTags: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, tags: ReadonlyArray<string>, mode?: "any" | "all") => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByCategory: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, category: string) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByPriority: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, priority: number) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRulesByPriorityRange: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, minPriority: number, maxPriority: number) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const getRuleById: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, id: string) => Rule<TContext, TConsequences> | undefined;
+export declare const filterRulesForContext: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>, contextFields: ReadonlyArray<string>) => ReadonlyArray<Rule<TContext, TConsequences>>;
+export type OptimizationSuggestion = {
+    readonly type: "INDEX" | "CACHE" | "MERGE" | "SIMPLIFY" | "REORDER";
+    readonly severity: "high" | "medium" | "low";
+    readonly message: string;
+    readonly ruleIds?: ReadonlyArray<string>;
+    readonly details?: Readonly<Record<string, unknown>>;
+};
+export declare const analyzeOptimizations: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>) => ReadonlyArray<OptimizationSuggestion>;
+export declare const getIndexStats: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(index: RuleIndex<TContext, TConsequences>) => {
+    totalRules: number;
+    uniqueFields: number;
+    uniqueTags: number;
+    uniqueCategories: number;
+    uniquePriorities: number;
+    averageRulesPerField: number;
+    averageRulesPerTag: number;
+};
+//# sourceMappingURL=index-builder.d.ts.map

package/dist/optimizer/index-builder.d.ts.map

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

package/dist/serialization/serializer.d.ts

@@ -0,0 +1,79 @@
+import type { ConditionGroup } from "@f-o-t/condition-evaluator";
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { Rule, RuleSet } from "../types/rule";
+export type SerializedRule = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly conditions: ConditionGroup;
+    readonly consequences: ReadonlyArray<{
+        type: string;
+        payload: unknown;
+    }>;
+    readonly priority: number;
+    readonly enabled: boolean;
+    readonly stopOnMatch: boolean;
+    readonly tags: ReadonlyArray<string>;
+    readonly category?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+export type SerializedRuleSet = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly ruleIds: ReadonlyArray<string>;
+    readonly enabled: boolean;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+};
+export type ExportFormat = {
+    readonly version: string;
+    readonly exportedAt: string;
+    readonly rules: ReadonlyArray<SerializedRule>;
+    readonly ruleSets?: ReadonlyArray<SerializedRuleSet>;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+};
+export type ImportOptions = {
+    readonly generateNewIds?: boolean;
+    readonly idPrefix?: string;
+    readonly preserveDates?: boolean;
+    readonly validateSchema?: boolean;
+};
+export type OrphanedReference = {
+    readonly ruleSetId: string;
+    readonly ruleSetName: string;
+    readonly missingRuleIds: ReadonlyArray<string>;
+};
+export type ImportResult<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly success: boolean;
+    readonly rules: ReadonlyArray<Rule<TContext, TConsequences>>;
+    readonly ruleSets: ReadonlyArray<RuleSet>;
+    readonly errors: ReadonlyArray<{
+        index: number;
+        type: "rule" | "ruleSet";
+        message: string;
+    }>;
+    readonly idMapping: ReadonlyMap<string, string>;
+    readonly orphanedReferences: ReadonlyArray<OrphanedReference>;
+};
+export declare const serializeRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: Rule<TContext, TConsequences>) => SerializedRule;
+export declare const deserializeRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(serialized: SerializedRule, options?: ImportOptions) => Rule<TContext, TConsequences>;
+export declare const serializeRuleSet: (ruleSet: RuleSet) => SerializedRuleSet;
+export declare const deserializeRuleSet: (serialized: SerializedRuleSet, idMapping: Map<string, string>, options?: ImportOptions) => RuleSet;
+export declare const exportRules: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, ruleSets?: ReadonlyArray<RuleSet>, metadata?: Record<string, unknown>) => ExportFormat;
+export declare const exportToJson: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, ruleSets?: ReadonlyArray<RuleSet>, metadata?: Record<string, unknown>) => string;
+export declare const importRules: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(data: ExportFormat, options?: ImportOptions) => ImportResult<TContext, TConsequences>;
+export declare const importFromJson: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(json: string, options?: ImportOptions) => ImportResult<TContext, TConsequences>;
+export declare const cloneRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: Rule<TContext, TConsequences>, newId?: string, newName?: string) => Rule<TContext, TConsequences>;
+export declare const mergeRuleSets: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(baseRules: ReadonlyArray<Rule<TContext, TConsequences>>, incomingRules: ReadonlyArray<Rule<TContext, TConsequences>>, strategy?: "replace" | "skip" | "merge") => ReadonlyArray<Rule<TContext, TConsequences>>;
+export declare const diffRuleSets: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(oldRules: ReadonlyArray<Rule<TContext, TConsequences>>, newRules: ReadonlyArray<Rule<TContext, TConsequences>>) => {
+    added: ReadonlyArray<Rule<TContext, TConsequences>>;
+    removed: ReadonlyArray<Rule<TContext, TConsequences>>;
+    modified: ReadonlyArray<{
+        old: Rule<TContext, TConsequences>;
+        new: Rule<TContext, TConsequences>;
+    }>;
+    unchanged: ReadonlyArray<Rule<TContext, TConsequences>>;
+};
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serialization/serializer.d.ts.map

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

package/dist/simulation/simulator.d.ts

@@ -0,0 +1,65 @@
+import { createEvaluator } from "@f-o-t/condition-evaluator";
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { RuleEvaluationResult } from "../types/evaluation";
+import type { Rule } from "../types/rule";
+export type SimulationContext<TContext = unknown> = {
+    readonly data: TContext;
+    readonly metadata?: Record<string, unknown>;
+};
+export type SimulationResult<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly context: SimulationContext<TContext>;
+    readonly matchedRules: ReadonlyArray<RuleEvaluationResult<TContext, TConsequences>>;
+    readonly unmatchedRules: ReadonlyArray<{
+        ruleId: string;
+        ruleName: string;
+        reason: string;
+    }>;
+    readonly consequences: ReadonlyArray<{
+        type: keyof TConsequences;
+        payload: unknown;
+        ruleId: string;
+        ruleName: string;
+    }>;
+    readonly executionTimeMs: number;
+};
+export type WhatIfResult<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly original: SimulationResult<TContext, TConsequences>;
+    readonly modified: SimulationResult<TContext, TConsequences>;
+    readonly differences: {
+        readonly newMatches: ReadonlyArray<string>;
+        readonly lostMatches: ReadonlyArray<string>;
+        readonly consequenceChanges: ReadonlyArray<{
+            type: "added" | "removed" | "modified";
+            consequenceType: string;
+            ruleId: string;
+        }>;
+    };
+};
+export type BatchSimulationResult<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly results: ReadonlyArray<SimulationResult<TContext, TConsequences>>;
+    readonly summary: {
+        readonly totalContexts: number;
+        readonly averageMatchedRules: number;
+        readonly ruleMatchFrequency: ReadonlyMap<string, number>;
+        readonly consequenceFrequency: ReadonlyMap<string, number>;
+        readonly averageExecutionTimeMs: number;
+    };
+};
+export declare const simulate: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, context: SimulationContext<TContext>, evaluator?: ReturnType<typeof createEvaluator>) => SimulationResult<TContext, TConsequences>;
+export declare const simulateSingleRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: Rule<TContext, TConsequences>, context: SimulationContext<TContext>, evaluator?: ReturnType<typeof createEvaluator>) => {
+    matched: boolean;
+    conditionResult: unknown;
+    consequences: ReadonlyArray<{
+        type: keyof TConsequences;
+        payload: unknown;
+    }>;
+};
+export declare const whatIf: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(originalRules: ReadonlyArray<Rule<TContext, TConsequences>>, modifiedRules: ReadonlyArray<Rule<TContext, TConsequences>>, context: SimulationContext<TContext>, evaluator?: ReturnType<typeof createEvaluator>) => WhatIfResult<TContext, TConsequences>;
+export declare const batchSimulate: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, contexts: ReadonlyArray<SimulationContext<TContext>>, evaluator?: ReturnType<typeof createEvaluator>) => BatchSimulationResult<TContext, TConsequences>;
+export declare const findRulesAffectedByContextChange: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, originalContext: SimulationContext<TContext>, modifiedContext: SimulationContext<TContext>, evaluator?: ReturnType<typeof createEvaluator>) => {
+    becameTrue: ReadonlyArray<Rule<TContext, TConsequences>>;
+    becameFalse: ReadonlyArray<Rule<TContext, TConsequences>>;
+    unchanged: ReadonlyArray<Rule<TContext, TConsequences>>;
+};
+export declare const formatSimulationResult: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(result: SimulationResult<TContext, TConsequences>) => string;
+//# sourceMappingURL=simulator.d.ts.map

package/dist/simulation/simulator.d.ts.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import type { OperatorMap } from "@f-o-t/condition-evaluator";
+import type { AggregatedConsequence, ConsequenceDefinitions, DefaultConsequences } from "./consequence";
+import type { ConflictResolutionStrategy, EngineExecutionResult, EvaluationContext, RuleEvaluationResult } from "./evaluation";
+import type { Rule } from "./rule";
+export declare const LogLevelSchema: z.ZodEnum<{
+    error: "error";
+    none: "none";
+    warn: "warn";
+    info: "info";
+    debug: "debug";
+}>;
+export type LogLevel = z.infer<typeof LogLevelSchema>;
+export declare const CacheConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    ttl: z.ZodDefault<z.ZodNumber>;
+    maxSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type CacheConfig = z.infer<typeof CacheConfigSchema>;
+export declare const ValidationConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    strict: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ValidationConfig = z.infer<typeof ValidationConfigSchema>;
+export declare const VersioningConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    maxVersions: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type VersioningConfig = z.infer<typeof VersioningConfigSchema>;
+export type Logger = {
+    readonly error: (...args: unknown[]) => void;
+    readonly warn: (...args: unknown[]) => void;
+    readonly info: (...args: unknown[]) => void;
+    readonly debug: (...args: unknown[]) => void;
+};
+export type EngineHooks<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly beforeEvaluation?: (context: EvaluationContext<TContext>, rules: ReadonlyArray<Rule<TContext, TConsequences>>) => void | Promise<void>;
+    readonly afterEvaluation?: (result: EngineExecutionResult<TContext, TConsequences>) => void | Promise<void>;
+    readonly beforeRuleEvaluation?: (rule: Rule<TContext, TConsequences>, context: EvaluationContext<TContext>) => void | Promise<void>;
+    readonly afterRuleEvaluation?: (rule: Rule<TContext, TConsequences>, result: RuleEvaluationResult<TContext, TConsequences>) => void | Promise<void>;
+    readonly onRuleMatch?: (rule: Rule<TContext, TConsequences>, context: EvaluationContext<TContext>) => void | Promise<void>;
+    readonly onRuleSkip?: (rule: Rule<TContext, TConsequences>, reason: string) => void | Promise<void>;
+    readonly onRuleError?: (rule: Rule<TContext, TConsequences>, error: Error) => void | Promise<void>;
+    readonly onConsequenceCollected?: (rule: Rule<TContext, TConsequences>, consequence: AggregatedConsequence<TConsequences>) => void | Promise<void>;
+    readonly onCacheHit?: (key: string, result: EngineExecutionResult<TContext, TConsequences>) => void | Promise<void>;
+    readonly onCacheMiss?: (key: string) => void | Promise<void>;
+    readonly onSlowRule?: (rule: Rule<TContext, TConsequences>, timeMs: number, threshold: number) => void | Promise<void>;
+    readonly onHookError?: (hookName: string, error: Error) => void;
+};
+export type EngineConfig<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly consequences?: TConsequences;
+    readonly conflictResolution?: ConflictResolutionStrategy;
+    readonly cache?: Partial<CacheConfig>;
+    readonly validation?: Partial<ValidationConfig>;
+    readonly versioning?: Partial<VersioningConfig>;
+    readonly hooks?: EngineHooks<TContext, TConsequences>;
+    readonly logLevel?: LogLevel;
+    readonly logger?: Logger;
+    readonly continueOnError?: boolean;
+    readonly slowRuleThresholdMs?: number;
+    readonly hookTimeoutMs?: number;
+    readonly evaluator?: ReturnType<typeof import("@f-o-t/condition-evaluator").createEvaluator>;
+    readonly operators?: OperatorMap;
+};
+export type ResolvedEngineConfig<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly consequences: TConsequences | undefined;
+    readonly conflictResolution: ConflictResolutionStrategy;
+    readonly cache: CacheConfig;
+    readonly validation: ValidationConfig;
+    readonly versioning: VersioningConfig;
+    readonly hooks: EngineHooks<TContext, TConsequences>;
+    readonly logLevel: LogLevel;
+    readonly logger: Logger;
+    readonly continueOnError: boolean;
+    readonly slowRuleThresholdMs: number;
+    readonly hookTimeoutMs: number | undefined;
+    readonly evaluator: ReturnType<typeof import("@f-o-t/condition-evaluator").createEvaluator>;
+};
+export declare const parseCacheConfig: (input?: Partial<CacheConfig>) => CacheConfig;
+export declare const parseValidationConfig: (input?: Partial<ValidationConfig>) => ValidationConfig;
+export declare const parseVersioningConfig: (input?: Partial<VersioningConfig>) => VersioningConfig;
+export declare const getDefaultCacheConfig: () => CacheConfig;
+export declare const getDefaultValidationConfig: () => ValidationConfig;
+export declare const getDefaultVersioningConfig: () => VersioningConfig;
+export declare const getDefaultLogLevel: () => LogLevel;
+export declare const getDefaultConflictResolution: () => ConflictResolutionStrategy;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/consequence.d.ts

@@ -0,0 +1,21 @@
+import type { z } from "zod";
+export type ConsequenceDefinitions = Record<string, z.ZodType>;
+export type DefaultConsequences = Record<string, z.ZodType>;
+export type InferConsequenceType<T extends ConsequenceDefinitions> = keyof T;
+export type InferConsequencePayload<T extends ConsequenceDefinitions, K extends keyof T> = z.infer<T[K]>;
+export type Consequence<TConsequences extends ConsequenceDefinitions = DefaultConsequences, TType extends keyof TConsequences = keyof TConsequences> = {
+    readonly type: TType;
+    readonly payload: z.infer<TConsequences[TType]>;
+};
+export type ConsequenceInput<TConsequences extends ConsequenceDefinitions = DefaultConsequences, TType extends keyof TConsequences = keyof TConsequences> = {
+    type: TType;
+    payload: z.infer<TConsequences[TType]>;
+};
+export type AggregatedConsequence<TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly type: keyof TConsequences;
+    readonly payload: unknown;
+    readonly ruleId: string;
+    readonly ruleName?: string;
+    readonly priority: number;
+};
+//# sourceMappingURL=consequence.d.ts.map

package/dist/types/consequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consequence.d.ts","sourceRoot":"","sources":["../../src/types/consequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5D,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,sBAAsB,IAAI,MAAM,CAAC,CAAC;AAE7E,MAAM,MAAM,uBAAuB,CAChC,CAAC,SAAS,sBAAsB,EAChC,CAAC,SAAS,MAAM,CAAC,IAChB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElB,MAAM,MAAM,WAAW,CACpB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAClE,KAAK,SAAS,MAAM,aAAa,GAAG,MAAM,aAAa,IACtD;IACD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,gBAAgB,CACzB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAClE,KAAK,SAAS,MAAM,aAAa,GAAG,MAAM,aAAa,IACtD;IACD,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC9B,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC5B,CAAC"}

package/dist/types/evaluation.d.ts

@@ -0,0 +1,70 @@
+import type { GroupEvaluationResult } from "@f-o-t/condition-evaluator";
+import { z } from "zod";
+import type { AggregatedConsequence, ConsequenceDefinitions, DefaultConsequences } from "./consequence";
+import type { Rule } from "./rule";
+export declare const ConflictResolutionStrategySchema: z.ZodEnum<{
+    priority: "priority";
+    "first-match": "first-match";
+    all: "all";
+    "most-specific": "most-specific";
+}>;
+export type ConflictResolutionStrategy = z.infer<typeof ConflictResolutionStrategySchema>;
+export declare const EvaluateOptionsSchema: z.ZodObject<{
+    conflictResolution: z.ZodOptional<z.ZodEnum<{
+        priority: "priority";
+        "first-match": "first-match";
+        all: "all";
+        "most-specific": "most-specific";
+    }>>;
+    maxRules: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    skipDisabled: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    ruleSetId: z.ZodOptional<z.ZodString>;
+    bypassCache: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type EvaluateOptions = z.infer<typeof EvaluateOptionsSchema>;
+export declare const EvaluateConfigSchema: z.ZodObject<{
+    conflictResolution: z.ZodEnum<{
+        priority: "priority";
+        "first-match": "first-match";
+        all: "all";
+        "most-specific": "most-specific";
+    }>;
+    continueOnError: z.ZodBoolean;
+    collectAllConsequences: z.ZodBoolean;
+}, z.core.$strip>;
+export type EvaluateConfig = z.infer<typeof EvaluateConfigSchema>;
+export type EvaluationContext<TContext = unknown> = {
+    readonly data: TContext;
+    readonly timestamp: Date;
+    readonly correlationId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+};
+export type RuleEvaluationResult<_TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly ruleId: string;
+    readonly ruleName: string;
+    readonly matched: boolean;
+    readonly conditionResult: GroupEvaluationResult;
+    readonly consequences: ReadonlyArray<AggregatedConsequence<TConsequences>>;
+    readonly evaluationTimeMs: number;
+    readonly skipped: boolean;
+    readonly skipReason?: string;
+    readonly error?: Error;
+};
+export type EngineExecutionResult<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly context: EvaluationContext<TContext>;
+    readonly results: ReadonlyArray<RuleEvaluationResult<TContext, TConsequences>>;
+    readonly matchedRules: ReadonlyArray<Rule<TContext, TConsequences>>;
+    readonly consequences: ReadonlyArray<AggregatedConsequence<TConsequences>>;
+    readonly totalRulesEvaluated: number;
+    readonly totalRulesMatched: number;
+    readonly totalRulesSkipped: number;
+    readonly totalRulesErrored: number;
+    readonly executionTimeMs: number;
+    readonly stoppedEarly: boolean;
+    readonly stoppedByRuleId?: string;
+    readonly cacheHit: boolean;
+};
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/types/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../src/types/evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACT,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAMnC,eAAO,MAAM,gCAAgC;;;;;EAK3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,gCAAgC,CACzC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,OAAO,IAAI;IACjD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC7B,SAAS,GAAG,OAAO,EACnB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC9B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAC5B,oBAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAC/C,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC7B,CAAC"}

package/dist/types/rule.d.ts

@@ -0,0 +1,114 @@
+import type { ConditionGroup } from "@f-o-t/condition-evaluator";
+import { z } from "zod";
+import type { Consequence, ConsequenceDefinitions, DefaultConsequences } from "./consequence";
+export type Rule<_TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly conditions: ConditionGroup;
+    readonly consequences: ReadonlyArray<Consequence<TConsequences>>;
+    readonly priority: number;
+    readonly enabled: boolean;
+    readonly stopOnMatch: boolean;
+    readonly tags: ReadonlyArray<string>;
+    readonly category?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+};
+export type RuleInput<_TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    id?: string;
+    name: string;
+    description?: string;
+    conditions: ConditionGroup;
+    consequences: Array<{
+        type: keyof TConsequences;
+        payload: z.infer<TConsequences[keyof TConsequences]>;
+    }>;
+    priority?: number;
+    enabled?: boolean;
+    stopOnMatch?: boolean;
+    tags?: string[];
+    category?: string;
+    metadata?: Record<string, unknown>;
+};
+export type RuleSet = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly ruleIds: ReadonlyArray<string>;
+    readonly enabled: boolean;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+};
+export type RuleSetInput = {
+    id?: string;
+    name: string;
+    description?: string;
+    ruleIds: string[];
+    enabled?: boolean;
+    metadata?: Record<string, unknown>;
+};
+export type RuleFilters = {
+    readonly enabled?: boolean;
+    readonly tags?: ReadonlyArray<string>;
+    readonly category?: string;
+    readonly ruleSetId?: string;
+    readonly ids?: ReadonlyArray<string>;
+};
+export declare const RuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    conditions: z.ZodCustom<{
+        id: string;
+        operator: "AND" | "OR";
+        scoringMode?: "binary" | "weighted" | undefined;
+        threshold?: number | undefined;
+        weight?: number | undefined;
+    } & {
+        conditions: (import("@f-o-t/condition-evaluator").Condition | ({
+            id: string;
+            operator: "AND" | "OR";
+            scoringMode?: "binary" | "weighted" | undefined;
+            threshold?: number | undefined;
+            weight?: number | undefined;
+        } & /*elided*/ any))[];
+    }, {
+        id: string;
+        operator: "AND" | "OR";
+        scoringMode?: "binary" | "weighted" | undefined;
+        threshold?: number | undefined;
+        weight?: number | undefined;
+    } & {
+        conditions: (import("@f-o-t/condition-evaluator").Condition | ({
+            id: string;
+            operator: "AND" | "OR";
+            scoringMode?: "binary" | "weighted" | undefined;
+            threshold?: number | undefined;
+            weight?: number | undefined;
+        } & /*elided*/ any))[];
+    }>;
+    consequences: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        payload: z.ZodUnknown;
+    }, z.core.$strip>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    stopOnMatch: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodDefault<z.ZodDate>;
+    updatedAt: z.ZodDefault<z.ZodDate>;
+}, z.core.$strip>;
+export declare const RuleSetSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    ruleIds: z.ZodArray<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type RuleSchemaType = z.infer<typeof RuleSchema>;
+export type RuleSetSchemaType = z.infer<typeof RuleSetSchema>;
+//# sourceMappingURL=rule.d.ts.map

package/dist/types/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/types/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACT,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,IAAI,CACb,SAAS,GAAG,OAAO,EACnB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,SAAS,CAClB,SAAS,GAAG,OAAO,EACnB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,aAAa,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC;KACvD,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BrB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;iBAOxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/types/state.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import type { ConsequenceDefinitions, DefaultConsequences } from "./consequence";
+import type { Rule, RuleSet } from "./rule";
+export declare const RuleStatsSchema: z.ZodObject<{
+    evaluations: z.ZodNumber;
+    matches: z.ZodNumber;
+    errors: z.ZodNumber;
+    totalTimeMs: z.ZodNumber;
+    avgTimeMs: z.ZodNumber;
+    lastEvaluated: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export type RuleStats = z.infer<typeof RuleStatsSchema>;
+export declare const CacheStatsSchema: z.ZodObject<{
+    size: z.ZodNumber;
+    maxSize: z.ZodNumber;
+    hits: z.ZodNumber;
+    misses: z.ZodNumber;
+    hitRate: z.ZodNumber;
+    evictions: z.ZodNumber;
+}, z.core.$strip>;
+export type CacheStats = z.infer<typeof CacheStatsSchema>;
+export declare const EngineStatsSchema: z.ZodObject<{
+    totalRules: z.ZodNumber;
+    enabledRules: z.ZodNumber;
+    disabledRules: z.ZodNumber;
+    totalRuleSets: z.ZodNumber;
+    totalEvaluations: z.ZodNumber;
+    totalMatches: z.ZodNumber;
+    totalErrors: z.ZodNumber;
+    avgEvaluationTimeMs: z.ZodNumber;
+    cacheHits: z.ZodNumber;
+    cacheMisses: z.ZodNumber;
+    cacheHitRate: z.ZodNumber;
+}, z.core.$strip>;
+export type EngineStats = z.infer<typeof EngineStatsSchema>;
+export type EngineState<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly rules: ReadonlyMap<string, Rule<TContext, TConsequences>>;
+    readonly ruleSets: ReadonlyMap<string, RuleSet>;
+    readonly ruleOrder: ReadonlyArray<string>;
+};
+export type MutableEngineState<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    rules: Map<string, Rule<TContext, TConsequences>>;
+    ruleSets: Map<string, RuleSet>;
+    ruleOrder: string[];
+};
+export type MutableRuleStats = {
+    evaluations: number;
+    matches: number;
+    errors: number;
+    totalTimeMs: number;
+    avgTimeMs: number;
+    lastEvaluated?: Date;
+};
+export type OptimizerState = {
+    readonly ruleStats: ReadonlyMap<string, RuleStats>;
+    readonly lastOptimized?: Date;
+};
+export type MutableOptimizerState = {
+    ruleStats: Map<string, MutableRuleStats>;
+    lastOptimized?: Date;
+};
+export declare const createInitialState: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>() => MutableEngineState<TContext, TConsequences>;
+export declare const createInitialOptimizerState: () => MutableOptimizerState;
+export declare const createInitialRuleStats: () => MutableRuleStats;
+//# sourceMappingURL=state.d.ts.map

package/dist/types/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACT,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAM5C,eAAO,MAAM,eAAe;;;;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAY5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,MAAM,MAAM,WAAW,CACpB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C,CAAC;AAGF,MAAM,MAAM,kBAAkB,CAC3B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAGF,MAAM,MAAM,gBAAgB,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC1B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAChC,CAAC;AAGF,MAAM,MAAM,qBAAqB,GAAG;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,IAAI,CAAC;CACvB,CAAC;AAMF,eAAO,MAAM,kBAAkB,GAC5B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,OAChE,kBAAkB,CAAC,QAAQ,EAAE,aAAa,CAI7C,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAAO,qBAG7C,CAAC;AAEH,eAAO,MAAM,sBAAsB,QAAO,gBAOxC,CAAC"}