@namzu/sandbox 24.0.0 → 25.0.0

package/dist/local-virtual-computer/setup/run.js

@@ -0,0 +1,200 @@
+import { runElevatedWslcSteps } from './elevated.js';
+import { createWslcSetupHost } from './host.js';
+import { loadWslcImage } from './image.js';
+import { planWslcSetup } from './plan.js';
+import { inspectWslcReadiness } from './readiness.js';
+import { clearRestartMarker, readRestartMarker, writeRestartMarker } from './restart.js';
+import { clearResumeAtSignIn, registerResumeAtSignIn } from './resume.js';
+import { PINNED_WSL_PACKAGE, downloadWslPackage } from './wsl-package.js';
+import { readManifest, writeImageRecord } from './wslc-shared.js';
+const isElevated = (kind) => kind === 'enable-windows-features' || kind === 'install-wsl';
+const ELEVATED_WORDS = {
+    'enable-windows-features': 'Turning on Windows features',
+    'install-wsl': 'Installing Linux support',
+};
+const elevatedFailureDetail = (step, exitCode) => {
+    const words = isElevated(step) ? ELEVATED_WORDS[step] : 'This step';
+    return exitCode === undefined
+        ? `${words} did not finish.`
+        : `${words} stopped with exit code ${exitCode}.`;
+};
+/**
+ * Run the plan the person agreed to. Inspects again first, with the session
+ * probe, and refuses with `plan-changed` when the plan it would run is not the
+ * one named by the consent.
+ */
+export const runWslcSetup = async (consent, options) => {
+    const host = createWslcSetupHost(options.host);
+    const { signal } = options;
+    const pinned = options.wslPackage ?? PINNED_WSL_PACKAGE;
+    const inspectOptions = { ...options, host, probeSession: true };
+    const markerBefore = await readRestartMarker(host);
+    const readiness = await inspectWslcReadiness(inspectOptions);
+    let manifest;
+    if (readiness.image.bundled) {
+        try {
+            manifest = await readManifest(readiness.image.bundled.manifestPath);
+        }
+        catch {
+            manifest = undefined;
+        }
+    }
+    const plan = planWslcSetup(readiness, { wslPackage: options.wslPackage, manifest });
+    if (plan.id !== consent.planId) {
+        // The PC is already ready (for example the image was loaded before Namzu kept a record of
+        // it): nothing is left to do, but the next quiet status must say so, so record it now.
+        if (readiness.state === 'ready' && manifest) {
+            await writeImageRecord(host, {
+                imageRef: manifest.imageRef,
+                imageId: manifest.imageId,
+                loadedAt: host.now().toISOString(),
+            });
+            return { outcome: 'ready' };
+        }
+        return { outcome: 'plan-changed', plan };
+    }
+    if (plan.blocked)
+        return { outcome: 'blocked', blocked: plan.blocked };
+    // Each step reports started and finished once, whoever emits it.
+    const announced = new Set();
+    const emit = (progress) => {
+        if (progress.phase !== 'progress') {
+            const key = `${progress.step}:${progress.phase}`;
+            if (announced.has(key))
+                return;
+            announced.add(key);
+        }
+        options.onProgress?.(progress);
+    };
+    const started = (step) => emit({ step, phase: 'started' });
+    const finished = (step, result) => emit({ step, phase: 'finished', result });
+    const failed = (step, code, detail, exitCode) => ({
+        outcome: 'failed',
+        step,
+        code,
+        ...(detail ? { detail } : {}),
+        ...(exitCode === undefined ? {} : { exitCode }),
+    });
+    const kinds = plan.steps.map((step) => step.kind);
+    let packagePath;
+    let elevatedOk = false;
+    for (const step of plan.steps) {
+        if (step.kind === 'restart') {
+            // Windows said the elevated steps need no restart: nothing to wait for.
+            if (elevatedOk)
+                continue;
+            return { outcome: 'restart-required' };
+        }
+        if (step.kind === 'download-wsl') {
+            started('download-wsl');
+            const downloaded = await downloadWslPackage({
+                pinned,
+                directory: host.stateDirectory,
+                onProgress: emit,
+                signal,
+            });
+            if (downloaded.outcome === 'failed')
+                return failed('download-wsl', downloaded.code, downloaded.detail);
+            packagePath = downloaded.path;
+            finished('download-wsl', 'ok');
+        }
+        if (isElevated(step.kind)) {
+            // All elevated steps share one call, made at the first of them.
+            if (step.kind !== kinds.find(isElevated))
+                continue;
+            const elevated = kinds.filter(isElevated);
+            // Only the first step is announced now; the tail of the elevated progress file announces
+            // each later one when the script reaches it, so a failure never shows a step that did not start.
+            started(elevated[0]);
+            const outcome = await (options.runElevated ?? runElevatedWslcSteps)({
+                steps: elevated,
+                ...(elevated.includes('install-wsl') && packagePath
+                    ? { wslPackage: { path: packagePath, sha256: pinned.sha256 } }
+                    : {}),
+                host,
+                onProgress: emit,
+                signal,
+            });
+            switch (outcome.outcome) {
+                case 'cancelled':
+                    return { outcome: 'cancelled' };
+                case 'needs-administrator':
+                    return { outcome: 'needs-administrator' };
+                case 'failed': {
+                    // The steps before the failing one finished, and the failing one started, whether or
+                    // not the progress tail saw it; the later steps never began.
+                    const at = elevated.indexOf(outcome.step);
+                    if (at >= 0) {
+                        for (const kind of elevated.slice(0, at)) {
+                            started(kind);
+                            finished(kind, 'ok');
+                        }
+                        started(elevated[at]);
+                    }
+                    return failed(outcome.step, outcome.code, elevatedFailureDetail(outcome.step, outcome.exitCode), outcome.exitCode);
+                }
+                case 'restart-required': {
+                    const last = elevated[elevated.length - 1];
+                    for (const kind of elevated) {
+                        started(kind);
+                        finished(kind, kind === last ? 'restart-required' : 'ok');
+                    }
+                    const after = kinds.slice(kinds.lastIndexOf(last) + 1);
+                    await writeRestartMarker(host, {
+                        recordedAt: host.now().toISOString(),
+                        planId: plan.id,
+                        remaining: after.filter((kind) => kind !== 'restart'),
+                    });
+                    if (options.resumeCommand)
+                        await registerResumeAtSignIn(host, options.resumeCommand);
+                    return { outcome: 'restart-required' };
+                }
+                case 'ok':
+                    for (const kind of elevated) {
+                        started(kind);
+                        finished(kind, 'ok');
+                    }
+                    elevatedOk = true;
+                    break;
+            }
+        }
+        if (step.kind === 'load-image') {
+            if (!readiness.image.bundled)
+                return { outcome: 'blocked', blocked: 'image-unavailable' };
+            started('load-image');
+            const loaded = await loadWslcImage({
+                manifestPath: readiness.image.bundled.manifestPath,
+                host,
+                onProgress: emit,
+                signal,
+            });
+            if (loaded.outcome === 'failed')
+                return failed('load-image', loaded.code, loaded.detail);
+            finished('load-image', 'ok');
+        }
+    }
+    const after = await inspectWslcReadiness(inspectOptions);
+    switch (after.state) {
+        case 'ready':
+            if (markerBefore !== undefined) {
+                await clearRestartMarker(host);
+                try {
+                    await clearResumeAtSignIn(host);
+                }
+                catch {
+                    // The resume entry is a convenience; a leftover one is harmless.
+                }
+            }
+            return { outcome: 'ready' };
+        case 'restart-pending':
+            return { outcome: 'restart-required' };
+        case 'virtualization-off':
+        case 'sdk-mismatch':
+        case 'blocked-by-policy':
+        case 'unsupported':
+            return { outcome: 'blocked', blocked: after.state };
+        default:
+            return failed(plan.steps[plan.steps.length - 1]?.kind ?? 'load-image', 'engine-failed', 'Setup finished, but the Pal computer is still not ready on this PC.');
+    }
+};
+//# sourceMappingURL=run.js.map

package/dist/local-virtual-computer/setup/run.js.map

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

package/dist/local-virtual-computer/setup/windows-folder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The Windows folder as a path setup code may run programs from.
+ *
+ * The environment is only a claim, so a value is accepted when it is a drive
+ * root followed by `Windows` or `WINNT`; anything else becomes `C:\Windows`.
+ * A PC whose Windows folder has another name therefore cannot be set up by
+ * this code: the launch fails (reported as `elevation-failed`) rather than
+ * running a program from a folder the environment picked.
+ */
+export declare function trustedWindowsDirectory(env: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=windows-folder.d.ts.map

package/dist/local-virtual-computer/setup/windows-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-folder.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/windows-folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAGtE"}

package/dist/local-virtual-computer/setup/windows-folder.js

@@ -0,0 +1,14 @@
+/**
+ * The Windows folder as a path setup code may run programs from.
+ *
+ * The environment is only a claim, so a value is accepted when it is a drive
+ * root followed by `Windows` or `WINNT`; anything else becomes `C:\Windows`.
+ * A PC whose Windows folder has another name therefore cannot be set up by
+ * this code: the launch fails (reported as `elevation-failed`) rather than
+ * running a program from a folder the environment picked.
+ */
+export function trustedWindowsDirectory(env) {
+    const claimed = (env.SystemRoot ?? env.windir ?? '').replace(/[\\/]+$/, '');
+    return /^[A-Za-z]:\\(Windows|WINNT)$/i.test(claimed) ? claimed : 'C:\\Windows';
+}
+//# sourceMappingURL=windows-folder.js.map

package/dist/local-virtual-computer/setup/windows-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-folder.js","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/windows-folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC7D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAC3E,OAAO,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAA;AAC/E,CAAC"}

package/dist/local-virtual-computer/setup/wsl-package.d.ts

@@ -0,0 +1,19 @@
+import type { DownloadWslPackage, PinnedWslPackage } from './contract.js';
+/**
+ * The WSL release setup installs: Microsoft's per-machine MSI for x64 from
+ * https://github.com/microsoft/WSL/releases/tag/3.0.1. The size and digest are
+ * the ones the release API reports for the asset, and were recomputed from a
+ * download of the file.
+ */
+export declare const PINNED_WSL_PACKAGE: PinnedWslPackage;
+/**
+ * Fetch the pinned package into `directory/<file name>.part` (resuming it with
+ * a Range request when a partial file exists), check the SHA-256, and
+ * rename it to `directory/<file name>`. A file that fails the check is
+ * deleted. Network trouble and 5xx answers retry with exponential backoff; a
+ * 4xx answer fails at once. Emits only `progress` events; the caller owns
+ * `started` and `finished`. An aborted signal rejects with the signal's reason
+ * and leaves the partial file for the next run.
+ */
+export declare const downloadWslPackage: DownloadWslPackage;
+//# sourceMappingURL=wsl-package.d.ts.map

package/dist/local-virtual-computer/setup/wsl-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsl-package.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/wsl-package.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAqB,MAAM,eAAe,CAAA;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAMhC,CAAA;AA+JD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAuDhC,CAAA"}

package/dist/local-virtual-computer/setup/wsl-package.js

@@ -0,0 +1,242 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { mkdir, open, rename, rm, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * The WSL release setup installs: Microsoft's per-machine MSI for x64 from
+ * https://github.com/microsoft/WSL/releases/tag/3.0.1. The size and digest are
+ * the ones the release API reports for the asset, and were recomputed from a
+ * download of the file.
+ */
+export const PINNED_WSL_PACKAGE = {
+    version: '3.0.1.0',
+    architecture: 'x64',
+    url: 'https://github.com/microsoft/WSL/releases/download/3.0.1/wsl.3.0.1.0.x64.msi',
+    sha256: '28b1a0d013640a2ac95898ea705fa186e5b4ff767a1c1b49257161bc106599c6',
+    sizeBytes: 367669248,
+};
+/** Attempts before a download gives up, counting the first. */
+const MAX_ATTEMPTS = 5;
+/** Backoff before attempt n+1 is `BASE_DELAY_MS * 2 ** n`. */
+const BASE_DELAY_MS = 1000;
+/** Report progress at most once per this many bytes (and at the end). */
+const PROGRESS_STEP_BYTES = 512 * 1024;
+class RetryableError extends Error {
+}
+class FatalError extends Error {
+}
+function fileNameOf(url) {
+    const name = new URL(url).pathname.split('/').pop() ?? '';
+    if (!/^[A-Za-z0-9._-]+$/.test(name) || name.startsWith('.')) {
+        throw new FatalError('The package address has no usable file name.');
+    }
+    return name;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+async function sizeOf(path) {
+    try {
+        return (await stat(path)).size;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sha256Of(path, signal) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(path, { signal });
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('error', reject);
+        stream.on('end', () => resolve(hash.digest('hex')));
+    });
+}
+/** Like {@link sha256Of}, but an abort rejects with the signal's reason, as everywhere else here. */
+async function hashOrAbort(path, signal) {
+    try {
+        return await sha256Of(path, signal);
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw signal.reason;
+        throw error;
+    }
+}
+/**
+ * One attempt: continue `part` from its current size when the server honours
+ * the range, or start over when it does not. Resolves when `part` holds
+ * `sizeBytes`.
+ */
+async function attempt(pinned, part, fetchImpl, onProgress, signal) {
+    let have = (await sizeOf(part)) ?? 0;
+    if (have > pinned.sizeBytes) {
+        await rm(part, { force: true });
+        have = 0;
+    }
+    if (have === pinned.sizeBytes)
+        return;
+    let response;
+    try {
+        response = await fetchImpl(pinned.url, {
+            headers: have > 0 ? { Range: `bytes=${have}-` } : {},
+            redirect: 'follow',
+            signal,
+        });
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw signal.reason;
+        throw new RetryableError(error instanceof Error ? error.message : 'The request failed.');
+    }
+    if (response.status === 416) {
+        // The partial file does not fit what the server has; start over.
+        await rm(part, { force: true });
+        throw new RetryableError('The server refused the resume range.');
+    }
+    if (response.status !== 200 && response.status !== 206) {
+        const message = `The server answered ${response.status}.`;
+        if (response.status === 429 || response.status >= 500)
+            throw new RetryableError(message);
+        throw new FatalError(message);
+    }
+    if (!response.body)
+        throw new RetryableError('The server sent no data.');
+    let resumed = response.status === 206 && have > 0;
+    if (resumed) {
+        // A 206 for another offset would append misaligned bytes: drop the
+        // partial file and fetch again from zero.
+        const start = /^bytes (\d+)-/.exec(response.headers.get('content-range') ?? '')?.[1];
+        if (start === undefined || Number(start) !== have) {
+            await response.body.cancel().catch(() => undefined);
+            await rm(part, { force: true });
+            throw new RetryableError('The server answered for a different part of the file.');
+        }
+    }
+    else {
+        resumed = false;
+        have = 0;
+    }
+    const handle = await open(part, resumed ? 'a' : 'w');
+    let done = have;
+    let reported = have;
+    try {
+        const reader = response.body.getReader();
+        try {
+            for (;;) {
+                const { value, done: finished } = await reader.read();
+                if (finished)
+                    break;
+                await handle.write(value);
+                done += value.byteLength;
+                if (done - reported >= PROGRESS_STEP_BYTES) {
+                    reported = done;
+                    onProgress?.({
+                        step: 'download-wsl',
+                        phase: 'progress',
+                        done,
+                        total: pinned.sizeBytes,
+                        unit: 'bytes',
+                    });
+                }
+            }
+        }
+        catch (error) {
+            if (signal?.aborted)
+                throw signal.reason;
+            throw new RetryableError(error instanceof Error ? error.message : 'The download broke off.');
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    onProgress?.({
+        step: 'download-wsl',
+        phase: 'progress',
+        done,
+        total: pinned.sizeBytes,
+        unit: 'bytes',
+    });
+    if (done < pinned.sizeBytes)
+        throw new RetryableError('The download ended early.');
+}
+/**
+ * Fetch the pinned package into `directory/<file name>.part` (resuming it with
+ * a Range request when a partial file exists), check the SHA-256, and
+ * rename it to `directory/<file name>`. A file that fails the check is
+ * deleted. Network trouble and 5xx answers retry with exponential backoff; a
+ * 4xx answer fails at once. Emits only `progress` events; the caller owns
+ * `started` and `finished`. An aborted signal rejects with the signal's reason
+ * and leaves the partial file for the next run.
+ */
+export const downloadWslPackage = async (options) => {
+    const { pinned, directory, signal, onProgress } = options;
+    const fetchImpl = options.fetch ?? fetch;
+    let target;
+    try {
+        target = join(directory, fileNameOf(pinned.url));
+    }
+    catch (error) {
+        return { outcome: 'failed', code: 'download-failed', detail: error.message };
+    }
+    const part = `${target}.part`;
+    await mkdir(directory, { recursive: true });
+    // A previous run may have left a finished, verified file.
+    if ((await sizeOf(target)) === pinned.sizeBytes &&
+        (await hashOrAbort(target, signal)) === pinned.sha256) {
+        return { outcome: 'ok', path: target };
+    }
+    await rm(target, { force: true });
+    let lastError = 'The download failed.';
+    for (let n = 0; n < MAX_ATTEMPTS; n++) {
+        signal?.throwIfAborted();
+        if (n > 0)
+            await sleep(BASE_DELAY_MS * 2 ** (n - 1), signal);
+        try {
+            await attempt(pinned, part, fetchImpl, onProgress, signal);
+        }
+        catch (error) {
+            if (signal?.aborted)
+                throw signal.reason;
+            if (error instanceof FatalError) {
+                return { outcome: 'failed', code: 'download-failed', detail: error.message };
+            }
+            if (error instanceof RetryableError) {
+                lastError = error.message;
+                continue;
+            }
+            return {
+                outcome: 'failed',
+                code: 'download-failed',
+                detail: 'The package could not be written to disk.',
+            };
+        }
+        // The digest decides; a file of the wrong length cannot have the right one.
+        if ((await hashOrAbort(part, signal)) !== pinned.sha256) {
+            await rm(part, { force: true });
+            return {
+                outcome: 'failed',
+                code: 'download-corrupt',
+                detail: 'The downloaded package does not match the release Namzu expects.',
+            };
+        }
+        await rename(part, target);
+        return { outcome: 'ok', path: target };
+    }
+    return { outcome: 'failed', code: 'download-failed', detail: lastError };
+};
+//# sourceMappingURL=wsl-package.js.map

package/dist/local-virtual-computer/setup/wsl-package.js.map

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

package/dist/local-virtual-computer/setup/wslc-shared.d.ts

@@ -0,0 +1,27 @@
+import type { WslcImageManifest, WslcSetupHost } from './contract.js';
+/** The label every Pal computer image carries; it names the guest protocol. */
+export declare const PROTOCOL_LABEL = "org.namzu.local-computer.protocol";
+/** Where the WSL package puts wslc. */
+export declare function wslcBinaryOf(host: Pick<WslcSetupHost, 'env'>): string;
+/** Why a manifest was refused, in words safe to show. */
+export declare class ManifestError extends Error {
+    readonly name = "ManifestError";
+}
+/** Validate a parsed manifest. Throws {@link ManifestError}. */
+export declare function validateManifest(value: unknown): WslcImageManifest;
+export declare function readManifest(manifestPath: string): Promise<WslcImageManifest>;
+/** The archive lies beside its manifest. */
+export declare function archivePathOf(manifestPath: string, manifest: WslcImageManifest): string;
+/** `[{ Id, Config: { Labels } }]` from `wslc image inspect -f json`. */
+export declare function parseImageInspect(output: string): {
+    id: string;
+    protocol: string | undefined;
+} | undefined;
+export interface WslcImageRecord {
+    readonly imageRef: string;
+    readonly imageId: string;
+    readonly loadedAt: string;
+}
+export declare function readImageRecord(host: Pick<WslcSetupHost, 'stateDirectory'>): Promise<WslcImageRecord | undefined>;
+export declare function writeImageRecord(host: Pick<WslcSetupHost, 'stateDirectory'>, record: WslcImageRecord): Promise<void>;
+//# sourceMappingURL=wslc-shared.d.ts.map

package/dist/local-virtual-computer/setup/wslc-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wslc-shared.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/wslc-shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAErE,+EAA+E;AAC/E,eAAO,MAAM,cAAc,sCAAsC,CAAA;AAEjE,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,CAIrE;AAED,yDAAyD;AACzD,qBAAa,aAAc,SAAQ,KAAK;IACvC,SAAkB,IAAI,mBAAkB;CACxC;AAQD,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA0ClE;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAcnF;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEvF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAa1D;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAMD,wBAAsB,eAAe,CACpC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,GACzC,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAStC;AAED,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,EAC3C,MAAM,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf"}