apcore-js 0.4.0 → 0.6.0

package/dist/errors.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Error hierarchy for the apcore framework.
+ */
+export declare class ModuleError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    readonly cause?: Error;
+    readonly traceId?: string;
+    readonly timestamp: string;
+    constructor(code: string, message: string, details?: Record<string, unknown>, cause?: Error, traceId?: string);
+    toString(): string;
+}
+export declare class ConfigNotFoundError extends ModuleError {
+    constructor(configPath: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ConfigError extends ModuleError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ACLRuleError extends ModuleError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ACLDeniedError extends ModuleError {
+    constructor(callerId: string | null, targetId: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+    get callerId(): string | null;
+    get targetId(): string;
+}
+export declare class ModuleNotFoundError extends ModuleError {
+    constructor(moduleId: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ModuleTimeoutError extends ModuleError {
+    constructor(moduleId: string, timeoutMs: number, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+    get moduleId(): string;
+    get timeoutMs(): number;
+}
+export declare class SchemaValidationError extends ModuleError {
+    constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class SchemaNotFoundError extends ModuleError {
+    constructor(schemaId: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class SchemaParseError extends ModuleError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class SchemaCircularRefError extends ModuleError {
+    constructor(refPath: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class CallDepthExceededError extends ModuleError {
+    constructor(depth: number, maxDepth: number, callChain: string[], options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+    get currentDepth(): number;
+    get maxDepth(): number;
+}
+export declare class CircularCallError extends ModuleError {
+    constructor(moduleId: string, callChain: string[], options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+    get moduleId(): string;
+}
+export declare class CallFrequencyExceededError extends ModuleError {
+    constructor(moduleId: string, count: number, maxRepeat: number, callChain: string[], options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+    get moduleId(): string;
+    get count(): number;
+    get maxRepeat(): number;
+}
+export declare class InvalidInputError extends ModuleError {
+    constructor(message?: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class FuncMissingTypeHintError extends ModuleError {
+    constructor(functionName: string, parameterName: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class FuncMissingReturnTypeError extends ModuleError {
+    constructor(functionName: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingInvalidTargetError extends ModuleError {
+    constructor(target: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingModuleNotFoundError extends ModuleError {
+    constructor(modulePath: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingCallableNotFoundError extends ModuleError {
+    constructor(callableName: string, modulePath: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingNotCallableError extends ModuleError {
+    constructor(target: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingSchemaMissingError extends ModuleError {
+    constructor(target: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class BindingFileInvalidError extends ModuleError {
+    constructor(filePath: string, reason: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class CircularDependencyError extends ModuleError {
+    constructor(cyclePath: string[], options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ModuleLoadError extends ModuleError {
+    constructor(moduleId: string, reason: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class ModuleExecuteError extends ModuleError {
+    constructor(moduleId: string, reason: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+export declare class InternalError extends ModuleError {
+    constructor(message?: string, options?: {
+        cause?: Error;
+        traceId?: string;
+    });
+}
+/**
+ * All framework error codes as constants.
+ * Use these instead of hardcoding error code strings.
+ */
+export declare const ErrorCodes: Readonly<{
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly ACL_RULE_ERROR: "ACL_RULE_ERROR";
+    readonly ACL_DENIED: "ACL_DENIED";
+    readonly MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
+    readonly MODULE_TIMEOUT: "MODULE_TIMEOUT";
+    readonly MODULE_LOAD_ERROR: "MODULE_LOAD_ERROR";
+    readonly MODULE_EXECUTE_ERROR: "MODULE_EXECUTE_ERROR";
+    readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
+    readonly SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND";
+    readonly SCHEMA_PARSE_ERROR: "SCHEMA_PARSE_ERROR";
+    readonly SCHEMA_CIRCULAR_REF: "SCHEMA_CIRCULAR_REF";
+    readonly CALL_DEPTH_EXCEEDED: "CALL_DEPTH_EXCEEDED";
+    readonly CIRCULAR_CALL: "CIRCULAR_CALL";
+    readonly CALL_FREQUENCY_EXCEEDED: "CALL_FREQUENCY_EXCEEDED";
+    readonly GENERAL_INVALID_INPUT: "GENERAL_INVALID_INPUT";
+    readonly GENERAL_INTERNAL_ERROR: "GENERAL_INTERNAL_ERROR";
+    readonly FUNC_MISSING_TYPE_HINT: "FUNC_MISSING_TYPE_HINT";
+    readonly FUNC_MISSING_RETURN_TYPE: "FUNC_MISSING_RETURN_TYPE";
+    readonly BINDING_INVALID_TARGET: "BINDING_INVALID_TARGET";
+    readonly BINDING_MODULE_NOT_FOUND: "BINDING_MODULE_NOT_FOUND";
+    readonly BINDING_CALLABLE_NOT_FOUND: "BINDING_CALLABLE_NOT_FOUND";
+    readonly BINDING_NOT_CALLABLE: "BINDING_NOT_CALLABLE";
+    readonly BINDING_SCHEMA_MISSING: "BINDING_SCHEMA_MISSING";
+    readonly BINDING_FILE_INVALID: "BINDING_FILE_INVALID";
+    readonly CIRCULAR_DEPENDENCY: "CIRCULAR_DEPENDENCY";
+    readonly MIDDLEWARE_CHAIN_ERROR: "MIDDLEWARE_CHAIN_ERROR";
+    readonly GENERAL_NOT_IMPLEMENTED: "GENERAL_NOT_IMPLEMENTED";
+    readonly DEPENDENCY_NOT_FOUND: "DEPENDENCY_NOT_FOUND";
+}>;
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+//# 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":"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"}

package/dist/errors.js

@@ -0,0 +1,246 @@
+/**
+ * Error hierarchy for the apcore framework.
+ */
+export class ModuleError extends Error {
+    code;
+    details;
+    cause;
+    traceId;
+    timestamp;
+    constructor(code, message, details, cause, traceId) {
+        super(message, cause ? { cause } : undefined);
+        this.name = 'ModuleError';
+        this.code = code;
+        this.details = details ?? {};
+        this.cause = cause;
+        this.traceId = traceId;
+        this.timestamp = new Date().toISOString();
+    }
+    toString() {
+        return `[${this.code}] ${this.message}`;
+    }
+}
+export class ConfigNotFoundError extends ModuleError {
+    constructor(configPath, options) {
+        super('CONFIG_NOT_FOUND', `Configuration file not found: ${configPath}`, { configPath }, options?.cause, options?.traceId);
+        this.name = 'ConfigNotFoundError';
+    }
+}
+export class ConfigError extends ModuleError {
+    constructor(message, options) {
+        super('CONFIG_INVALID', message, {}, options?.cause, options?.traceId);
+        this.name = 'ConfigError';
+    }
+}
+export class ACLRuleError extends ModuleError {
+    constructor(message, options) {
+        super('ACL_RULE_ERROR', message, {}, options?.cause, options?.traceId);
+        this.name = 'ACLRuleError';
+    }
+}
+export class ACLDeniedError extends ModuleError {
+    constructor(callerId, targetId, options) {
+        super('ACL_DENIED', `Access denied: ${callerId} -> ${targetId}`, { callerId, targetId }, options?.cause, options?.traceId);
+        this.name = 'ACLDeniedError';
+    }
+    get callerId() {
+        return this.details['callerId'];
+    }
+    get targetId() {
+        return this.details['targetId'];
+    }
+}
+export class ModuleNotFoundError extends ModuleError {
+    constructor(moduleId, options) {
+        super('MODULE_NOT_FOUND', `Module not found: ${moduleId}`, { moduleId }, options?.cause, options?.traceId);
+        this.name = 'ModuleNotFoundError';
+    }
+}
+export class ModuleTimeoutError extends ModuleError {
+    constructor(moduleId, timeoutMs, options) {
+        super('MODULE_TIMEOUT', `Module ${moduleId} timed out after ${timeoutMs}ms`, { moduleId, timeoutMs }, options?.cause, options?.traceId);
+        this.name = 'ModuleTimeoutError';
+    }
+    get moduleId() {
+        return this.details['moduleId'];
+    }
+    get timeoutMs() {
+        return this.details['timeoutMs'];
+    }
+}
+export class SchemaValidationError extends ModuleError {
+    constructor(message = 'Schema validation failed', errors, options) {
+        super('SCHEMA_VALIDATION_ERROR', message, { errors: errors ?? [] }, options?.cause, options?.traceId);
+        this.name = 'SchemaValidationError';
+    }
+}
+export class SchemaNotFoundError extends ModuleError {
+    constructor(schemaId, options) {
+        super('SCHEMA_NOT_FOUND', `Schema not found: ${schemaId}`, { schemaId }, options?.cause, options?.traceId);
+        this.name = 'SchemaNotFoundError';
+    }
+}
+export class SchemaParseError extends ModuleError {
+    constructor(message, options) {
+        super('SCHEMA_PARSE_ERROR', message, {}, options?.cause, options?.traceId);
+        this.name = 'SchemaParseError';
+    }
+}
+export class SchemaCircularRefError extends ModuleError {
+    constructor(refPath, options) {
+        super('SCHEMA_CIRCULAR_REF', `Circular reference detected: ${refPath}`, { refPath }, options?.cause, options?.traceId);
+        this.name = 'SchemaCircularRefError';
+    }
+}
+export class CallDepthExceededError extends ModuleError {
+    constructor(depth, maxDepth, callChain, options) {
+        super('CALL_DEPTH_EXCEEDED', `Call depth ${depth} exceeds maximum ${maxDepth}`, { depth, maxDepth, callChain }, options?.cause, options?.traceId);
+        this.name = 'CallDepthExceededError';
+    }
+    get currentDepth() {
+        return this.details['depth'];
+    }
+    get maxDepth() {
+        return this.details['maxDepth'];
+    }
+}
+export class CircularCallError extends ModuleError {
+    constructor(moduleId, callChain, options) {
+        super('CIRCULAR_CALL', `Circular call detected for module ${moduleId}`, { moduleId, callChain }, options?.cause, options?.traceId);
+        this.name = 'CircularCallError';
+    }
+    get moduleId() {
+        return this.details['moduleId'];
+    }
+}
+export class CallFrequencyExceededError extends ModuleError {
+    constructor(moduleId, count, maxRepeat, callChain, options) {
+        super('CALL_FREQUENCY_EXCEEDED', `Module ${moduleId} called ${count} times, max is ${maxRepeat}`, { moduleId, count, maxRepeat, callChain }, options?.cause, options?.traceId);
+        this.name = 'CallFrequencyExceededError';
+    }
+    get moduleId() {
+        return this.details['moduleId'];
+    }
+    get count() {
+        return this.details['count'];
+    }
+    get maxRepeat() {
+        return this.details['maxRepeat'];
+    }
+}
+export class InvalidInputError extends ModuleError {
+    constructor(message = 'Invalid input', options) {
+        super('GENERAL_INVALID_INPUT', message, {}, options?.cause, options?.traceId);
+        this.name = 'InvalidInputError';
+    }
+}
+export class FuncMissingTypeHintError extends ModuleError {
+    constructor(functionName, parameterName, options) {
+        super('FUNC_MISSING_TYPE_HINT', `Parameter '${parameterName}' in function '${functionName}' has no type annotation. Add a type annotation like '${parameterName}: string'.`, { functionName, parameterName }, options?.cause, options?.traceId);
+        this.name = 'FuncMissingTypeHintError';
+    }
+}
+export class FuncMissingReturnTypeError extends ModuleError {
+    constructor(functionName, options) {
+        super('FUNC_MISSING_RETURN_TYPE', `Function '${functionName}' has no return type annotation. Add a return type like ': Record<string, unknown>'.`, { functionName }, options?.cause, options?.traceId);
+        this.name = 'FuncMissingReturnTypeError';
+    }
+}
+export class BindingInvalidTargetError extends ModuleError {
+    constructor(target, options) {
+        super('BINDING_INVALID_TARGET', `Invalid binding target '${target}'. Expected format: 'module.path:callable_name'.`, { target }, options?.cause, options?.traceId);
+        this.name = 'BindingInvalidTargetError';
+    }
+}
+export class BindingModuleNotFoundError extends ModuleError {
+    constructor(modulePath, options) {
+        super('BINDING_MODULE_NOT_FOUND', `Cannot import module '${modulePath}'.`, { modulePath }, options?.cause, options?.traceId);
+        this.name = 'BindingModuleNotFoundError';
+    }
+}
+export class BindingCallableNotFoundError extends ModuleError {
+    constructor(callableName, modulePath, options) {
+        super('BINDING_CALLABLE_NOT_FOUND', `Cannot find callable '${callableName}' in module '${modulePath}'.`, { callableName, modulePath }, options?.cause, options?.traceId);
+        this.name = 'BindingCallableNotFoundError';
+    }
+}
+export class BindingNotCallableError extends ModuleError {
+    constructor(target, options) {
+        super('BINDING_NOT_CALLABLE', `Resolved target '${target}' is not callable.`, { target }, options?.cause, options?.traceId);
+        this.name = 'BindingNotCallableError';
+    }
+}
+export class BindingSchemaMissingError extends ModuleError {
+    constructor(target, options) {
+        super('BINDING_SCHEMA_MISSING', `No schema available for target '${target}'. Add type hints or provide an explicit schema.`, { target }, options?.cause, options?.traceId);
+        this.name = 'BindingSchemaMissingError';
+    }
+}
+export class BindingFileInvalidError extends ModuleError {
+    constructor(filePath, reason, options) {
+        super('BINDING_FILE_INVALID', `Invalid binding file '${filePath}': ${reason}`, { filePath, reason }, options?.cause, options?.traceId);
+        this.name = 'BindingFileInvalidError';
+    }
+}
+export class CircularDependencyError extends ModuleError {
+    constructor(cyclePath, options) {
+        super('CIRCULAR_DEPENDENCY', `Circular dependency detected: ${cyclePath.join(' -> ')}`, { cyclePath }, options?.cause, options?.traceId);
+        this.name = 'CircularDependencyError';
+    }
+}
+export class ModuleLoadError extends ModuleError {
+    constructor(moduleId, reason, options) {
+        super('MODULE_LOAD_ERROR', `Failed to load module '${moduleId}': ${reason}`, { moduleId, reason }, options?.cause, options?.traceId);
+        this.name = 'ModuleLoadError';
+    }
+}
+export class ModuleExecuteError extends ModuleError {
+    constructor(moduleId, reason, options) {
+        super('MODULE_EXECUTE_ERROR', `Failed to execute module '${moduleId}': ${reason}`, { moduleId, reason }, options?.cause, options?.traceId);
+        this.name = 'ModuleExecuteError';
+    }
+}
+export class InternalError extends ModuleError {
+    constructor(message = 'Internal error', options) {
+        super('GENERAL_INTERNAL_ERROR', message, {}, options?.cause, options?.traceId);
+        this.name = 'InternalError';
+    }
+}
+/**
+ * All framework error codes as constants.
+ * Use these instead of hardcoding error code strings.
+ */
+export const ErrorCodes = Object.freeze({
+    CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND",
+    CONFIG_INVALID: "CONFIG_INVALID",
+    ACL_RULE_ERROR: "ACL_RULE_ERROR",
+    ACL_DENIED: "ACL_DENIED",
+    MODULE_NOT_FOUND: "MODULE_NOT_FOUND",
+    MODULE_TIMEOUT: "MODULE_TIMEOUT",
+    MODULE_LOAD_ERROR: "MODULE_LOAD_ERROR",
+    MODULE_EXECUTE_ERROR: "MODULE_EXECUTE_ERROR",
+    SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR",
+    SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND",
+    SCHEMA_PARSE_ERROR: "SCHEMA_PARSE_ERROR",
+    SCHEMA_CIRCULAR_REF: "SCHEMA_CIRCULAR_REF",
+    CALL_DEPTH_EXCEEDED: "CALL_DEPTH_EXCEEDED",
+    CIRCULAR_CALL: "CIRCULAR_CALL",
+    CALL_FREQUENCY_EXCEEDED: "CALL_FREQUENCY_EXCEEDED",
+    GENERAL_INVALID_INPUT: "GENERAL_INVALID_INPUT",
+    GENERAL_INTERNAL_ERROR: "GENERAL_INTERNAL_ERROR",
+    FUNC_MISSING_TYPE_HINT: "FUNC_MISSING_TYPE_HINT",
+    FUNC_MISSING_RETURN_TYPE: "FUNC_MISSING_RETURN_TYPE",
+    BINDING_INVALID_TARGET: "BINDING_INVALID_TARGET",
+    BINDING_MODULE_NOT_FOUND: "BINDING_MODULE_NOT_FOUND",
+    BINDING_CALLABLE_NOT_FOUND: "BINDING_CALLABLE_NOT_FOUND",
+    BINDING_NOT_CALLABLE: "BINDING_NOT_CALLABLE",
+    BINDING_SCHEMA_MISSING: "BINDING_SCHEMA_MISSING",
+    BINDING_FILE_INVALID: "BINDING_FILE_INVALID",
+    CIRCULAR_DEPENDENCY: "CIRCULAR_DEPENDENCY",
+    MIDDLEWARE_CHAIN_ERROR: "MIDDLEWARE_CHAIN_ERROR",
+    // Forward declarations for Level 2 Phase 2 features.
+    // Exception classes will be added when the corresponding features are implemented.
+    GENERAL_NOT_IMPLEMENTED: "GENERAL_NOT_IMPLEMENTED",
+    DEPENDENCY_NOT_FOUND: "DEPENDENCY_NOT_FOUND",
+});
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Executor and related utilities for apcore.
+ *
+ * Async-only execution pipeline. Python's call() + call_async() merge into one async call().
+ * Timeout uses Promise.race instead of threading.
+ */
+import type { ACL } from './acl.js';
+import type { Config } from './config.js';
+import { Context } from './context.js';
+import { Middleware } from './middleware/index.js';
+import type { ValidationResult } from './module.js';
+import type { Registry } from './registry/registry.js';
+export declare const REDACTED_VALUE: string;
+export declare function redactSensitive(data: Record<string, unknown>, schemaDict: Record<string, unknown>): Record<string, unknown>;
+export declare class Executor {
+    private _registry;
+    private _middlewareManager;
+    private _acl;
+    private _config;
+    private _defaultTimeout;
+    private _maxCallDepth;
+    private _maxModuleRepeat;
+    constructor(options: {
+        registry: Registry;
+        middlewares?: Middleware[] | null;
+        acl?: ACL | null;
+        config?: Config | null;
+    });
+    get registry(): Registry;
+    get middlewares(): Middleware[];
+    /** Set the access control provider. */
+    setAcl(acl: ACL): void;
+    use(middleware: Middleware): Executor;
+    useBefore(callback: (moduleId: string, inputs: Record<string, unknown>, context: Context) => Record<string, unknown> | null): Executor;
+    useAfter(callback: (moduleId: string, inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context) => Record<string, unknown> | null): Executor;
+    remove(middleware: Middleware): boolean;
+    call(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null): Promise<Record<string, unknown>>;
+    /**
+     * Alias for call(). Provided for compatibility with MCP bridge packages
+     * that may call callAsync() by convention.
+     */
+    callAsync(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null): Promise<Record<string, unknown>>;
+    /**
+     * Streaming execution pipeline. If the module exposes a stream() async generator,
+     * yields each chunk. Otherwise falls back to call() and yields a single chunk.
+     *
+     * Pipeline: context -> safety -> lookup -> ACL -> validate inputs -> before-middleware
+     *   -> stream (or fallback to execute) -> validate accumulated output -> after-middleware
+     *
+     * Note: In the streaming path, after-middleware runs on the accumulated output for
+     * validation/side-effects but its return value is not yielded since chunks were already
+     * emitted. In the non-streaming fallback, after-middleware can transform the output.
+     */
+    stream(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null): AsyncGenerator<Record<string, unknown>>;
+    private _streamWithMiddleware;
+    private _createContext;
+    private _lookupModule;
+    private _checkAcl;
+    private _validateInputs;
+    private _validateSchema;
+    private _executeWithMiddleware;
+    private _validateOutput;
+    validate(moduleId: string, inputs: Record<string, unknown>): ValidationResult;
+    private _checkSafety;
+    private _executeWithTimeout;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAYvC,OAAO,EAAqC,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,MAAyB,CAAC;AAEvD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAoDD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE;QACnB,QAAQ,EAAE,QAAQ,CAAC;QACnB,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAClC,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB;IAuBD,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,WAAW,IAAI,UAAU,EAAE,CAE9B;IAED,uCAAuC;IACvC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAItB,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ;IAKrC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,QAAQ;IAKtI,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,QAAQ;IAKtK,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAIjC,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAanC;;;OAGG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAInC;;;;;;;;;;OAUG;IACI,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAa3B,qBAAqB;IAwEpC,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,eAAe;YAkBT,sBAAsB;IAgDpC,OAAO,CAAC,eAAe;IAOvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IA4B7E,OAAO,CAAC,YAAY;YAyBN,mBAAmB;CAsClC"}