procxy 0.1.0-alpha.1

package/dist/parent/ipc-client.js

@@ -0,0 +1,316 @@
+import { randomUUID } from 'node:crypto';
+import { TimeoutError, ChildCrashedError } from '../shared/errors.js';
+import { EventEmitter } from 'node:events';
+import { CallbackRegistry, serializeWithCallbacks } from '../shared/serialization.js';
+export class IPCClient extends EventEmitter {
+    childProcess;
+    pendingRequests = new Map();
+    callbackRegistry = new CallbackRegistry();
+    propertyStore = new Map();
+    timeout;
+    retries;
+    isTerminated = false;
+    subscribedEvents = new Set();
+    constructor(childProcess, timeout = 30000, retries = 3) {
+        super();
+        this.childProcess = childProcess;
+        this.timeout = timeout;
+        this.retries = retries;
+        this.childProcess.on('message', this.handleMessage.bind(this));
+        this.childProcess.on('exit', this.handleExit.bind(this));
+        this.setupEventTracking();
+    }
+    get process() {
+        return this.childProcess;
+    }
+    setupEventTracking() {
+        const originalOn = this.on.bind(this);
+        const originalOnce = this.once.bind(this);
+        const originalOff = this.off.bind(this);
+        const originalRemoveListener = this.removeListener.bind(this);
+        const originalRemoveAllListeners = this.removeAllListeners.bind(this);
+        this.on = (event, listener) => {
+            const hadListeners = this.listenerCount(event) > 0;
+            const result = originalOn(event, listener);
+            if (!hadListeners && this.listenerCount(event) === 1) {
+                this.subscribeInChild(event);
+            }
+            return result;
+        };
+        this.once = (event, listener) => {
+            const hadListeners = this.listenerCount(event) > 0;
+            const result = originalOnce(event, listener);
+            if (!hadListeners && this.listenerCount(event) > 0) {
+                this.subscribeInChild(event);
+            }
+            return result;
+        };
+        this.off = (event, listener) => {
+            const result = originalOff(event, listener);
+            if (this.listenerCount(event) === 0) {
+                this.unsubscribeInChild(event);
+            }
+            return result;
+        };
+        this.removeListener = (event, listener) => {
+            const result = originalRemoveListener(event, listener);
+            if (this.listenerCount(event) === 0) {
+                this.unsubscribeInChild(event);
+            }
+            return result;
+        };
+        this.removeAllListeners = (event) => {
+            if (event) {
+                const hadListeners = this.listenerCount(event) > 0;
+                const result = originalRemoveAllListeners(event);
+                if (hadListeners) {
+                    this.unsubscribeInChild(event);
+                }
+                return result;
+            }
+            else {
+                const events = this.eventNames();
+                const result = originalRemoveAllListeners();
+                for (const evt of events) {
+                    this.unsubscribeInChild(evt);
+                }
+                return result;
+            }
+        };
+    }
+    subscribeInChild(event) {
+        if (this.isTerminated) {
+            return;
+        }
+        if (this.subscribedEvents.has(event)) {
+            return;
+        }
+        this.subscribedEvents.add(event);
+        const eventName = typeof event === 'symbol' ? event.toString() : event;
+        const message = {
+            type: 'EVENT_SUBSCRIBE',
+            eventName
+        };
+        this.childProcess.send(message);
+    }
+    unsubscribeInChild(event) {
+        if (this.isTerminated) {
+            return;
+        }
+        if (!this.subscribedEvents.has(event)) {
+            return;
+        }
+        this.subscribedEvents.delete(event);
+        const eventName = typeof event === 'symbol' ? event.toString() : event;
+        const message = {
+            type: 'EVENT_UNSUBSCRIBE',
+            eventName
+        };
+        this.childProcess.send(message);
+    }
+    async sendRequest(method, args, attemptNumber = 0) {
+        if (this.isTerminated) {
+            throw new Error('Child process has been terminated');
+        }
+        const id = randomUUID();
+        const serializedArgs = args.map((arg) => serializeWithCallbacks(arg, this.callbackRegistry));
+        const request = {
+            type: 'CALL',
+            id,
+            prop: method,
+            args: serializedArgs
+        };
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                if (attemptNumber < this.retries) {
+                    this.sendRequest(method, args, attemptNumber + 1)
+                        .then(resolve)
+                        .catch(reject);
+                }
+                else {
+                    reject(new TimeoutError(method, this.timeout));
+                }
+            }, this.timeout);
+            this.pendingRequests.set(id, {
+                resolve,
+                reject,
+                method,
+                timeoutId
+            });
+            this.childProcess.send(request);
+        });
+    }
+    handleMessage(message) {
+        if (message.type === 'RESULT' || message.type === 'ERROR') {
+            this.handleResponse(message);
+            return;
+        }
+        if (message.type === 'EVENT') {
+            this.handleEvent(message);
+            return;
+        }
+        if (message.type === 'CALLBACK_INVOKE') {
+            this.handleCallbackInvoke(message);
+            return;
+        }
+        if (message.type === 'PROPERTY_GET') {
+            this.handlePropertyGet(message);
+            return;
+        }
+        if (message.type === 'PROPERTY_SET') {
+            this.handlePropertySet(message);
+            return;
+        }
+        if (message.type === 'INIT_SUCCESS') {
+            this.emit('init_success');
+            return;
+        }
+        if (message.type === 'INIT_FAILURE') {
+            this.emit('init_failure', this.toError(message.error));
+            return;
+        }
+    }
+    handleResponse(response) {
+        const pending = this.pendingRequests.get(response.id);
+        if (!pending) {
+            return;
+        }
+        if (pending.timeoutId) {
+            clearTimeout(pending.timeoutId);
+        }
+        this.pendingRequests.delete(response.id);
+        if (response.type === 'RESULT') {
+            pending.resolve(response.value ?? null);
+        }
+        else {
+            pending.reject(this.toError(response.error));
+        }
+    }
+    handleEvent(message) {
+        this.emit(message.eventName, ...message.args);
+    }
+    async handleCallbackInvoke(message) {
+        const callback = this.callbackRegistry.get(message.callbackId);
+        if (!callback) {
+            const errorResponse = {
+                id: message.id,
+                type: 'CALLBACK_ERROR',
+                error: {
+                    name: 'Error',
+                    message: `Callback ${message.callbackId} not found`,
+                    stack: undefined
+                }
+            };
+            this.childProcess.send(errorResponse);
+            return;
+        }
+        try {
+            const result = await callback(...message.args);
+            const successResponse = {
+                id: message.id,
+                type: 'CALLBACK_RESULT',
+                value: result ?? null
+            };
+            this.childProcess.send(successResponse);
+        }
+        catch (error) {
+            const errorResponse = {
+                id: message.id,
+                type: 'CALLBACK_ERROR',
+                error: {
+                    name: error instanceof Error ? error.name : 'Error',
+                    message: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : undefined
+                }
+            };
+            this.childProcess.send(errorResponse);
+        }
+    }
+    handlePropertyGet(message) {
+        const value = this.propertyStore.get(message.prop) ?? null;
+        const response = {
+            id: message.id,
+            type: 'PROPERTY_RESULT',
+            value
+        };
+        this.childProcess.send(response);
+    }
+    handlePropertySet(message) {
+        this.propertyStore.set(message.prop, message.value);
+    }
+    hasProperty(prop) {
+        return this.propertyStore.has(prop);
+    }
+    getPropertySync(prop) {
+        return this.propertyStore.get(prop) ?? null;
+    }
+    handleExit(code, signal) {
+        this.isTerminated = true;
+        const error = new ChildCrashedError(code, signal);
+        for (const [_id, pending] of this.pendingRequests.entries()) {
+            if (pending.timeoutId) {
+                clearTimeout(pending.timeoutId);
+            }
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+        this.emit('child_exit', code, signal);
+    }
+    async terminate() {
+        this.childProcess.off('message', this.handleMessage);
+        if (this.isTerminated) {
+            return;
+        }
+        this.isTerminated = true;
+        try {
+            if (this.childProcess.connected && !this.childProcess.killed) {
+                const disposeRequest = { type: 'DISPOSE' };
+                this.childProcess.send(disposeRequest);
+                await Promise.race([
+                    new Promise((resolve) => {
+                        const handler = (msg) => {
+                            if (msg.type === 'DISPOSE_COMPLETE') {
+                                this.childProcess.off('message', handler);
+                                resolve();
+                            }
+                        };
+                        this.childProcess.on('message', handler);
+                    }),
+                    new Promise((resolve) => setTimeout(resolve, 1000))
+                ]);
+            }
+        }
+        catch {
+        }
+        for (const [_id, pending] of this.pendingRequests.entries()) {
+            if (pending.timeoutId) {
+                clearTimeout(pending.timeoutId);
+            }
+            pending.reject(new Error('Child process terminated'));
+        }
+        this.pendingRequests.clear();
+        this.childProcess.kill();
+        return new Promise((resolve) => {
+            if (!this.childProcess.connected) {
+                resolve();
+                return;
+            }
+            this.childProcess.once('exit', () => {
+                resolve();
+            });
+            setTimeout(() => {
+                this.childProcess.kill('SIGKILL');
+                resolve();
+            }, 5000);
+        });
+    }
+    toError(info) {
+        const error = new Error(info?.message ?? 'Unknown error');
+        error.name = info?.name ?? 'Error';
+        error.stack = info?.stack;
+        error.code = info?.code;
+        return error;
+    }
+}
+//# sourceMappingURL=ipc-client.js.map

package/dist/parent/ipc-client.js.map

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

package/dist/parent/parent-proxy.d.ts

@@ -0,0 +1,4 @@
+import type { Procxy } from '../types/procxy.js';
+import { IPCClient } from './ipc-client.js';
+export declare function createParentProxy<T extends object>(ipcClient: IPCClient): Procxy<T>;
+//# sourceMappingURL=parent-proxy.d.ts.map

package/dist/parent/parent-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-proxy.d.ts","sourceRoot":"","sources":["../../src/parent/parent-proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAsB5C,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAkFnF"}

package/dist/parent/parent-proxy.js

@@ -0,0 +1,76 @@
+import { ProcxyError } from '../shared/errors.js';
+const eventMethods = new Set([
+    'on',
+    'once',
+    'off',
+    'addListener',
+    'removeListener',
+    'removeAllListeners',
+    'emit',
+    'listeners',
+    'listenerCount',
+    'eventNames'
+]);
+function isValidIdentifier(name) {
+    return /^[A-Za-z_$][\w$]*$/.test(name);
+}
+export function createParentProxy(ipcClient) {
+    const base = {};
+    const proxy = new Proxy(base, {
+        get: (_target, prop) => {
+            if (prop === 'then') {
+                return undefined;
+            }
+            if (prop === '$terminate') {
+                return () => ipcClient.terminate();
+            }
+            if (prop === '$process') {
+                return ipcClient.process;
+            }
+            if (prop === Symbol.dispose) {
+                return () => {
+                    void ipcClient.terminate();
+                };
+            }
+            if (prop === Symbol.asyncDispose) {
+                return () => ipcClient.terminate();
+            }
+            if (typeof prop === 'symbol') {
+                return undefined;
+            }
+            if (eventMethods.has(prop)) {
+                const handler = ipcClient[prop];
+                return typeof handler === 'function' ? handler.bind(ipcClient) : undefined;
+            }
+            if (typeof prop !== 'string') {
+                return undefined;
+            }
+            if (prop.startsWith('$')) {
+                throw new ProcxyError(`Method '${prop}' is reserved and cannot be invoked`);
+            }
+            if (!isValidIdentifier(prop)) {
+                throw new ProcxyError(`Invalid method name '${prop}' (FR-014)`);
+            }
+            if (ipcClient.hasProperty(prop)) {
+                return ipcClient.getPropertySync(prop);
+            }
+            return (...args) => {
+                return ipcClient.sendRequest(prop, args);
+            };
+        },
+        set: (_target, prop, _value) => {
+            if (typeof prop !== 'string') {
+                return false;
+            }
+            if (prop.startsWith('$')) {
+                throw new ProcxyError(`Property '${prop}' is reserved and cannot be set`);
+            }
+            if (!isValidIdentifier(prop)) {
+                throw new ProcxyError(`Invalid property name '${prop}'`);
+            }
+            throw new ProcxyError(`Cannot set property '${prop}' from parent. Properties are read-only on parent and can only be modified by child.`);
+        }
+    });
+    return proxy;
+}
+//# sourceMappingURL=parent-proxy.js.map

package/dist/parent/parent-proxy.js.map

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

package/dist/parent/procxy.d.ts

@@ -0,0 +1,6 @@
+import type { Constructor } from 'type-fest';
+import type { Procxy } from '../types/procxy.js';
+import type { ProcxyOptions } from '../types/options.js';
+export declare function procxy<T extends Record<string, typeof Object>, C extends keyof T>(className: keyof T, modulePath?: string, options?: ProcxyOptions, ...constructorArgs: T[keyof T] extends Constructor<any> ? ConstructorParameters<T[keyof T]> : never): Promise<T[C] extends Constructor<infer U> ? Procxy<U> : never>;
+export declare function procxy<T extends object>(Class: Constructor<T>, modulePath?: string, options?: ProcxyOptions, ...constructorArgs: ConstructorParameters<Constructor<T>>): Promise<Procxy<T>>;
+//# sourceMappingURL=procxy.d.ts.map

package/dist/parent/procxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procxy.d.ts","sourceRoot":"","sources":["../../src/parent/procxy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwMzD,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACrF,SAAS,EAAE,MAAM,CAAC,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,aAAa,EACvB,GAAG,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,WAAW,CAAC,GAAG,CAAC,GACnD,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACjC,KAAK,GACR,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AAClE,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,aAAa,EACvB,GAAG,eAAe,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACxD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/parent/procxy.js

@@ -0,0 +1,120 @@
+import { fork } from 'node:child_process';
+import { existsSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveConstructorModule } from '../shared/module-resolver.js';
+import { validateJsonifiableArray } from '../shared/serialization.js';
+import { createParentProxy } from './parent-proxy.js';
+import { IPCClient } from './ipc-client.js';
+import { ChildCrashedError, OptionsValidationError, TimeoutError } from '../shared/errors.js';
+const DEFAULT_TIMEOUT_MS = 30000;
+const DEFAULT_RETRIES = 3;
+const MIN_INIT_TIMEOUT_MS = 1000;
+function validateOptions(options) {
+    if (options.timeout !== undefined &&
+        (typeof options.timeout !== 'number' || options.timeout <= 0)) {
+        throw new OptionsValidationError('timeout', options.timeout, 'must be a positive number');
+    }
+    if (options.retries !== undefined &&
+        (typeof options.retries !== 'number' || options.retries < 0)) {
+        throw new OptionsValidationError('retries', options.retries, 'must be a non-negative number');
+    }
+    if (options.env) {
+        for (const [key, value] of Object.entries(options.env)) {
+            if (typeof value !== 'string') {
+                throw new OptionsValidationError(`env.${key}`, value, 'environment variables must be strings');
+            }
+        }
+    }
+    if (options.args) {
+        validateJsonifiableArray(options.args, 'ProcxyOptions.args');
+    }
+    if (options.cwd) {
+        if (!existsSync(options.cwd) || !statSync(options.cwd).isDirectory()) {
+            throw new OptionsValidationError('cwd', options.cwd, 'must be an existing directory');
+        }
+    }
+}
+function pickAgentPath() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const built = resolve(currentDir, '../child/agent.js');
+    if (existsSync(built)) {
+        return built;
+    }
+    return resolve(currentDir, '../child/agent.ts');
+}
+const requireFromHere = createRequire(import.meta.url);
+function pickExecArgv(agentPath) {
+    if (!agentPath.endsWith('.ts'))
+        return [];
+    const tsxImportPath = requireFromHere.resolve('tsx/esm');
+    return ['--import', tsxImportPath];
+}
+function toArgStrings(args) {
+    if (!args)
+        return [];
+    return args.map((arg) => (typeof arg === 'string' ? arg : JSON.stringify(arg)));
+}
+async function waitForInitialization(ipcClient, timeoutMs) {
+    const effectiveTimeout = Math.max(timeoutMs, MIN_INIT_TIMEOUT_MS);
+    return new Promise((resolveInit, rejectInit) => {
+        const onSuccess = () => {
+            cleanup();
+            resolveInit();
+        };
+        const onFailure = (error) => {
+            cleanup();
+            rejectInit(error);
+        };
+        const onExit = (code, signal) => {
+            cleanup();
+            rejectInit(new ChildCrashedError(code, signal));
+        };
+        const timer = setTimeout(() => {
+            cleanup();
+            rejectInit(new TimeoutError('init', effectiveTimeout));
+        }, effectiveTimeout);
+        const cleanup = () => {
+            clearTimeout(timer);
+            ipcClient.off('init_success', onSuccess);
+            ipcClient.off('init_failure', onFailure);
+            ipcClient.off('child_exit', onExit);
+        };
+        ipcClient.once('init_success', onSuccess);
+        ipcClient.once('init_failure', onFailure);
+        ipcClient.once('child_exit', onExit);
+    });
+}
+export async function procxy(classOrClassName, modulePath, options, ...constructorArgs) {
+    validateOptions(options ?? {});
+    validateJsonifiableArray(constructorArgs, 'constructor arguments');
+    const moduleResolution = resolveConstructorModule(classOrClassName, typeof classOrClassName === 'string'
+        ? classOrClassName
+        : classOrClassName.name, modulePath);
+    const resolvedModulePath = moduleResolution.modulePath.startsWith('file://')
+        ? fileURLToPath(moduleResolution.modulePath)
+        : resolve(moduleResolution.modulePath);
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const retries = options?.retries ?? DEFAULT_RETRIES;
+    const agentPath = pickAgentPath();
+    const execArgv = pickExecArgv(agentPath);
+    const forkOptions = {
+        stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        cwd: options?.cwd ?? process.cwd(),
+        env: { ...process.env, ...options?.env },
+        execArgv
+    };
+    const child = fork(agentPath, toArgStrings(options?.args), forkOptions);
+    const ipcClient = new IPCClient(child, timeout, retries);
+    const initMessage = {
+        type: 'INIT',
+        modulePath: resolvedModulePath,
+        className: moduleResolution.className,
+        constructorArgs: [...constructorArgs]
+    };
+    child.send(initMessage);
+    await waitForInitialization(ipcClient, timeout);
+    return createParentProxy(ipcClient);
+}
+//# sourceMappingURL=procxy.js.map

package/dist/parent/procxy.js.map

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,31 @@
+export declare class ProcxyError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+export declare class TimeoutError extends ProcxyError {
+    readonly methodName: string;
+    readonly timeoutMs: number;
+    constructor(methodName: string, timeoutMs: number, context?: Record<string, unknown>);
+}
+export declare class ModuleResolutionError extends ProcxyError {
+    readonly className: string;
+    readonly reason: string;
+    constructor(className: string, reason: string, context?: Record<string, unknown>);
+}
+export declare class ChildCrashedError extends ProcxyError {
+    readonly exitCode?: number | null | undefined;
+    readonly signal?: string | null | undefined;
+    constructor(exitCode?: number | null | undefined, signal?: string | null | undefined, context?: Record<string, unknown>);
+}
+export declare class SerializationError extends ProcxyError {
+    readonly value: unknown;
+    readonly context_: string;
+    constructor(value: unknown, context_: string, context?: Record<string, unknown>);
+}
+export declare class OptionsValidationError extends ProcxyError {
+    readonly optionName: string;
+    readonly optionValue: unknown;
+    readonly reason: string;
+    constructor(optionName: string, optionValue: unknown, reason: string, context?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AASA,qBAAa,WAAY,SAAQ,KAAK;aAGlB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAMpD;AAMD,qBAAa,YAAa,SAAQ,WAAW;aAEzB,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;gBADjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQpC;AAMD,qBAAa,qBAAsB,SAAQ,WAAW;aAElC,SAAS,EAAE,MAAM;aACjB,MAAM,EAAE,MAAM;gBADd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASpC;AAMD,qBAAa,iBAAkB,SAAQ,WAAW;aAE9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;aACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;gBADtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,YAAA,EACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,YAAA,EACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAWpC;AAMD,qBAAa,kBAAmB,SAAQ,WAAW;aAE/B,KAAK,EAAE,OAAO;aACd,QAAQ,EAAE,MAAM;gBADhB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASpC;AAMD,qBAAa,sBAAuB,SAAQ,WAAW;aAEnC,UAAU,EAAE,MAAM;aAClB,WAAW,EAAE,OAAO;aACpB,MAAM,EAAE,MAAM;gBAFd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASpC"}