apcore-js 0.5.0 → 0.6.0

package/dist/acl.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ACL (Access Control List) types and implementation for apcore.
+ */
+import type { Context } from './context.js';
+export interface ACLRule {
+    callers: string[];
+    targets: string[];
+    effect: string;
+    description: string;
+    conditions?: Record<string, unknown> | null;
+}
+export declare class ACL {
+    private _rules;
+    private _defaultEffect;
+    private _yamlPath;
+    debug: boolean;
+    constructor(rules: ACLRule[], defaultEffect?: string);
+    static load(yamlPath: string): ACL;
+    check(callerId: string | null, targetId: string, context?: Context | null): boolean;
+    private _matchPattern;
+    private _matchesRule;
+    private _checkConditions;
+    addRule(rule: ACLRule): void;
+    removeRule(callers: string[], targets: string[]): boolean;
+    reload(): void;
+}
+//# sourceMappingURL=acl.d.ts.map

package/dist/acl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acl.d.ts","sourceRoot":"","sources":["../src/acl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ5C,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C;AAsCD,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAuB;IACxC,KAAK,EAAE,OAAO,CAAS;gBAEX,KAAK,EAAE,OAAO,EAAE,EAAE,aAAa,GAAE,MAAe;IAQ5D,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAqClC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO;IAYnF,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO;IAczD,MAAM,IAAI,IAAI;CAQf"}

package/dist/acl.js

@@ -0,0 +1,175 @@
+/**
+ * ACL (Access Control List) types and implementation for apcore.
+ */
+import yaml from 'js-yaml';
+import { ACLRuleError, ConfigNotFoundError } from './errors.js';
+import { matchPattern } from './utils/pattern.js';
+// Lazy-load Node.js built-in modules for browser compatibility
+let _nodeFs = null;
+try {
+    _nodeFs = await import('node:fs');
+}
+catch { /* browser environment */ }
+function parseAclRule(rawRule, index) {
+    if (typeof rawRule !== 'object' || rawRule === null || Array.isArray(rawRule)) {
+        throw new ACLRuleError(`Rule ${index} must be a mapping, got ${typeof rawRule}`);
+    }
+    const ruleObj = rawRule;
+    for (const key of ['callers', 'targets', 'effect']) {
+        if (!(key in ruleObj)) {
+            throw new ACLRuleError(`Rule ${index} missing required key '${key}'`);
+        }
+    }
+    const effect = ruleObj['effect'];
+    if (effect !== 'allow' && effect !== 'deny') {
+        throw new ACLRuleError(`Rule ${index} has invalid effect '${effect}', must be 'allow' or 'deny'`);
+    }
+    const callers = ruleObj['callers'];
+    if (!Array.isArray(callers)) {
+        throw new ACLRuleError(`Rule ${index} 'callers' must be a list, got ${typeof callers}`);
+    }
+    const targets = ruleObj['targets'];
+    if (!Array.isArray(targets)) {
+        throw new ACLRuleError(`Rule ${index} 'targets' must be a list, got ${typeof targets}`);
+    }
+    return {
+        callers: callers,
+        targets: targets,
+        effect,
+        description: ruleObj['description'] ?? '',
+        conditions: ruleObj['conditions'] ?? null,
+    };
+}
+export class ACL {
+    _rules;
+    _defaultEffect;
+    _yamlPath = null;
+    debug = false;
+    constructor(rules, defaultEffect = 'deny') {
+        if (defaultEffect !== 'allow' && defaultEffect !== 'deny') {
+            throw new ACLRuleError(`Invalid default_effect '${defaultEffect}', must be 'allow' or 'deny'`);
+        }
+        this._rules = [...rules];
+        this._defaultEffect = defaultEffect;
+    }
+    static load(yamlPath) {
+        const { existsSync, readFileSync } = _nodeFs;
+        if (!existsSync(yamlPath)) {
+            throw new ConfigNotFoundError(yamlPath);
+        }
+        let data;
+        try {
+            const content = readFileSync(yamlPath, 'utf-8');
+            data = yaml.load(content);
+        }
+        catch (e) {
+            if (e instanceof ConfigNotFoundError)
+                throw e;
+            throw new ACLRuleError(`Invalid YAML in ${yamlPath}: ${e}`);
+        }
+        if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+            throw new ACLRuleError(`ACL config must be a mapping, got ${typeof data}`);
+        }
+        const dataObj = data;
+        if (!('rules' in dataObj)) {
+            throw new ACLRuleError("ACL config missing required 'rules' key");
+        }
+        const rawRules = dataObj['rules'];
+        if (!Array.isArray(rawRules)) {
+            throw new ACLRuleError(`'rules' must be a list, got ${typeof rawRules}`);
+        }
+        const defaultEffect = dataObj['default_effect'] ?? 'deny';
+        const rules = rawRules.map((raw, i) => parseAclRule(raw, i));
+        const acl = new ACL(rules, defaultEffect);
+        acl._yamlPath = yamlPath;
+        return acl;
+    }
+    check(callerId, targetId, context) {
+        const effectiveCaller = callerId === null ? '@external' : callerId;
+        for (const rule of this._rules) {
+            if (this._matchesRule(rule, effectiveCaller, targetId, context ?? null)) {
+                return rule.effect === 'allow';
+            }
+        }
+        return this._defaultEffect === 'allow';
+    }
+    _matchPattern(pattern, value, context) {
+        if (pattern === '@external')
+            return value === '@external';
+        if (pattern === '@system') {
+            return context !== null && context.identity !== null && context.identity.type === 'system';
+        }
+        return matchPattern(pattern, value);
+    }
+    _matchesRule(rule, caller, target, context) {
+        const callerMatch = rule.callers.some((p) => this._matchPattern(p, caller, context));
+        if (!callerMatch)
+            return false;
+        const targetMatch = rule.targets.some((p) => this._matchPattern(p, target, context));
+        if (!targetMatch)
+            return false;
+        if (rule.conditions != null) {
+            if (!this._checkConditions(rule.conditions, context))
+                return false;
+        }
+        return true;
+    }
+    _checkConditions(conditions, context) {
+        if (context === null)
+            return false;
+        if ('identity_types' in conditions) {
+            const types = conditions['identity_types'];
+            if (!Array.isArray(types)) {
+                console.warn('[apcore:acl] identity_types condition must be an array');
+                return false;
+            }
+            if (context.identity === null || !types.includes(context.identity.type))
+                return false;
+        }
+        if ('roles' in conditions) {
+            const roles = conditions['roles'];
+            if (!Array.isArray(roles)) {
+                console.warn('[apcore:acl] roles condition must be an array');
+                return false;
+            }
+            if (context.identity === null)
+                return false;
+            const identityRoles = new Set(context.identity.roles);
+            if (!roles.some((r) => identityRoles.has(r)))
+                return false;
+        }
+        if ('max_call_depth' in conditions) {
+            const maxDepth = conditions['max_call_depth'];
+            if (typeof maxDepth !== 'number') {
+                console.warn('[apcore:acl] max_call_depth condition must be a number');
+                return false;
+            }
+            if (context.callChain.length > maxDepth)
+                return false;
+        }
+        return true;
+    }
+    addRule(rule) {
+        this._rules.unshift(rule);
+    }
+    removeRule(callers, targets) {
+        for (let i = 0; i < this._rules.length; i++) {
+            const rule = this._rules[i];
+            if (JSON.stringify(rule.callers) === JSON.stringify(callers) &&
+                JSON.stringify(rule.targets) === JSON.stringify(targets)) {
+                this._rules.splice(i, 1);
+                return true;
+            }
+        }
+        return false;
+    }
+    reload() {
+        if (this._yamlPath === null) {
+            throw new ACLRuleError('Cannot reload: ACL was not loaded from a YAML file');
+        }
+        const reloaded = ACL.load(this._yamlPath);
+        this._rules = reloaded._rules;
+        this._defaultEffect = reloaded._defaultEffect;
+    }
+}
+//# sourceMappingURL=acl.js.map

package/dist/acl.js.map

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

package/dist/async-task.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Async task manager for background module execution.
+ */
+import type { Context } from './context.js';
+import type { Executor } from './executor.js';
+export declare enum TaskStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+export interface TaskInfo {
+    readonly taskId: string;
+    readonly moduleId: string;
+    readonly status: TaskStatus;
+    readonly submittedAt: number;
+    readonly startedAt: number | null;
+    readonly completedAt: number | null;
+    readonly result: Record<string, unknown> | null;
+    readonly error: string | null;
+}
+/**
+ * Manages background execution of modules via Promises.
+ *
+ * Uses a simple counter-based concurrency limiter instead of a semaphore.
+ */
+export declare class AsyncTaskManager {
+    private readonly _executor;
+    private readonly _maxConcurrent;
+    private readonly _maxTasks;
+    private readonly _tasks;
+    private _runningCount;
+    private readonly _waitQueue;
+    constructor(executor: Executor, maxConcurrent?: number, maxTasks?: number);
+    /**
+     * Submit a module for background execution.
+     *
+     * Returns the generated task_id immediately.
+     */
+    submit(moduleId: string, inputs: Record<string, unknown>, context?: Context | null): string;
+    /**
+     * Return the TaskInfo for a task, or null if not found.
+     */
+    getStatus(taskId: string): TaskInfo | null;
+    /**
+     * Return the result of a completed task.
+     *
+     * Throws if the task is not found or not in COMPLETED status.
+     */
+    getResult(taskId: string): Record<string, unknown>;
+    /**
+     * Cancel a running or pending task.
+     *
+     * Sets the cancelled flag and updates status immediately.
+     * The underlying execution may still be in-flight but its result
+     * will be discarded when it completes.
+     *
+     * Returns true if the task was successfully marked as cancelled.
+     */
+    cancel(taskId: string): boolean;
+    /**
+     * Return all tasks, optionally filtered by status.
+     */
+    listTasks(status?: TaskStatus): TaskInfo[];
+    /**
+     * Remove terminal-state tasks older than maxAgeSeconds seconds.
+     *
+     * Terminal states: COMPLETED, FAILED, CANCELLED.
+     * Returns the number of tasks removed.
+     */
+    cleanup(maxAgeSeconds?: number): number;
+    /**
+     * Cancel all pending and running tasks.
+     */
+    shutdown(): void;
+    /**
+     * Acquire a concurrency slot. Resolves when a slot is available.
+     */
+    private _acquireSlot;
+    /**
+     * Release a concurrency slot and notify the next waiter.
+     */
+    private _releaseSlot;
+    /**
+     * Enqueue the task for execution under the concurrency limit.
+     */
+    private _enqueue;
+}
+//# sourceMappingURL=async-task.d.ts.map

package/dist/async-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-task.d.ts","sourceRoot":"","sources":["../src/async-task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAWD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBAExC,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAE,MAAW,EAAE,QAAQ,GAAE,MAAa;IAMnF;;;;OAIG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,MAAM;IAiCT;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAK1C;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWlD;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAe/B;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,EAAE;IAM1C;;;;;OAKG;IACH,OAAO,CAAC,aAAa,GAAE,MAAa,GAAG,MAAM;IAiB7C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAgDjB"}

package/dist/async-task.js

@@ -0,0 +1,215 @@
+/**
+ * Async task manager for background module execution.
+ */
+import { v4 as uuidv4 } from 'uuid';
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["PENDING"] = "pending";
+    TaskStatus["RUNNING"] = "running";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["CANCELLED"] = "cancelled";
+})(TaskStatus || (TaskStatus = {}));
+/**
+ * Manages background execution of modules via Promises.
+ *
+ * Uses a simple counter-based concurrency limiter instead of a semaphore.
+ */
+export class AsyncTaskManager {
+    _executor;
+    _maxConcurrent;
+    _maxTasks;
+    _tasks = new Map();
+    _runningCount = 0;
+    _waitQueue = [];
+    constructor(executor, maxConcurrent = 10, maxTasks = 1000) {
+        this._executor = executor;
+        this._maxConcurrent = maxConcurrent;
+        this._maxTasks = maxTasks;
+    }
+    /**
+     * Submit a module for background execution.
+     *
+     * Returns the generated task_id immediately.
+     */
+    submit(moduleId, inputs, context) {
+        if (this._tasks.size >= this._maxTasks) {
+            throw new Error(`Task limit reached (${this._maxTasks})`);
+        }
+        const taskId = uuidv4();
+        const info = {
+            taskId,
+            moduleId,
+            status: TaskStatus.PENDING,
+            submittedAt: Date.now() / 1000,
+            startedAt: null,
+            completedAt: null,
+            result: null,
+            error: null,
+        };
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        const internal = {
+            info,
+            promise,
+            cancelled: false,
+            resolve: resolvePromise,
+        };
+        this._tasks.set(taskId, internal);
+        this._enqueue(taskId, moduleId, inputs, context ?? null);
+        return taskId;
+    }
+    /**
+     * Return the TaskInfo for a task, or null if not found.
+     */
+    getStatus(taskId) {
+        const internal = this._tasks.get(taskId);
+        return internal ? { ...internal.info } : null;
+    }
+    /**
+     * Return the result of a completed task.
+     *
+     * Throws if the task is not found or not in COMPLETED status.
+     */
+    getResult(taskId) {
+        const internal = this._tasks.get(taskId);
+        if (!internal) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        if (internal.info.status !== TaskStatus.COMPLETED) {
+            throw new Error(`Task ${taskId} is not completed (status=${internal.info.status})`);
+        }
+        return internal.info.result;
+    }
+    /**
+     * Cancel a running or pending task.
+     *
+     * Sets the cancelled flag and updates status immediately.
+     * The underlying execution may still be in-flight but its result
+     * will be discarded when it completes.
+     *
+     * Returns true if the task was successfully marked as cancelled.
+     */
+    cancel(taskId) {
+        const internal = this._tasks.get(taskId);
+        if (!internal)
+            return false;
+        const { info } = internal;
+        if (info.status !== TaskStatus.PENDING && info.status !== TaskStatus.RUNNING) {
+            return false;
+        }
+        internal.cancelled = true;
+        info.status = TaskStatus.CANCELLED;
+        info.completedAt = Date.now() / 1000;
+        return true;
+    }
+    /**
+     * Return all tasks, optionally filtered by status.
+     */
+    listTasks(status) {
+        const tasks = [...this._tasks.values()];
+        const filtered = status ? tasks.filter(t => t.info.status === status) : tasks;
+        return filtered.map(t => ({ ...t.info }));
+    }
+    /**
+     * Remove terminal-state tasks older than maxAgeSeconds seconds.
+     *
+     * Terminal states: COMPLETED, FAILED, CANCELLED.
+     * Returns the number of tasks removed.
+     */
+    cleanup(maxAgeSeconds = 3600) {
+        const terminal = new Set([TaskStatus.COMPLETED, TaskStatus.FAILED, TaskStatus.CANCELLED]);
+        const now = Date.now() / 1000;
+        let removed = 0;
+        for (const [taskId, internal] of this._tasks.entries()) {
+            if (!terminal.has(internal.info.status))
+                continue;
+            const refTime = internal.info.completedAt ?? internal.info.submittedAt;
+            if ((now - refTime) >= maxAgeSeconds) {
+                this._tasks.delete(taskId);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Cancel all pending and running tasks.
+     */
+    shutdown() {
+        for (const [taskId, task] of this._tasks) {
+            if (task.info.status === TaskStatus.PENDING || task.info.status === TaskStatus.RUNNING) {
+                this.cancel(taskId);
+            }
+        }
+    }
+    /**
+     * Acquire a concurrency slot. Resolves when a slot is available.
+     */
+    _acquireSlot() {
+        if (this._runningCount < this._maxConcurrent) {
+            this._runningCount++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this._waitQueue.push(() => {
+                this._runningCount++;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Release a concurrency slot and notify the next waiter.
+     */
+    _releaseSlot() {
+        this._runningCount--;
+        if (this._waitQueue.length > 0) {
+            const next = this._waitQueue.shift();
+            next();
+        }
+    }
+    /**
+     * Enqueue the task for execution under the concurrency limit.
+     */
+    _enqueue(taskId, moduleId, inputs, context) {
+        const run = async () => {
+            const internal = this._tasks.get(taskId);
+            if (!internal)
+                return;
+            try {
+                await this._acquireSlot();
+                // Check if cancelled while waiting for a slot
+                if (internal.cancelled) {
+                    return; // finally block handles releaseSlot + resolve
+                }
+                internal.info.status = TaskStatus.RUNNING;
+                internal.info.startedAt = Date.now() / 1000;
+                const result = await this._executor.call(moduleId, inputs, context);
+                // Check if cancelled during execution
+                if (internal.cancelled) {
+                    return; // finally block handles releaseSlot + resolve
+                }
+                internal.info.status = TaskStatus.COMPLETED;
+                internal.info.completedAt = Date.now() / 1000;
+                internal.info.result = result;
+            }
+            catch (err) {
+                if (!internal.cancelled) {
+                    internal.info.status = TaskStatus.FAILED;
+                    internal.info.completedAt = Date.now() / 1000;
+                    internal.info.error = err instanceof Error ? err.message : String(err);
+                }
+            }
+            finally {
+                this._releaseSlot();
+                internal.resolve();
+            }
+        };
+        // Fire and forget -- errors are captured inside run()
+        run().catch((err) => {
+            console.warn('[apcore:async-task] Unexpected error in task runner:', err);
+        });
+    }
+}
+//# sourceMappingURL=async-task.js.map

package/dist/async-task.js.map

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

package/dist/bindings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * YAML binding loader for zero-code-modification module integration.
+ */
+import { FunctionModule } from './decorator.js';
+import type { Registry } from './registry/registry.js';
+export declare class BindingLoader {
+    loadBindings(filePath: string, registry: Registry): Promise<FunctionModule[]>;
+    loadBindingDir(dirPath: string, registry: Registry, pattern?: string): Promise<FunctionModule[]>;
+    resolveTarget(targetString: string): Promise<(...args: unknown[]) => unknown>;
+    private _createModuleFromBinding;
+}
+//# sourceMappingURL=bindings.d.ts.map

package/dist/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAehD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,qBAAa,aAAa;IAClB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmD7E,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,MAAyB,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC;IAuBtB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;YA0DrE,wBAAwB;CAuDvC"}