rivet-design 0.16.2 → 0.17.0

package/dist/services/ProjectFolderPicker.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectFolderPicker = void 0;
+const child_process_1 = require("child_process");
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const util_1 = require("util");
+const libraryErrors_1 = require("./libraryErrors");
+const windowPlacement_1 = require("../utils/windowPlacement");
+const execute = (0, util_1.promisify)(child_process_1.execFile);
+const PICKER_TIMEOUT_MS = 5 * 60 * 1000;
+const PICKER_OUTPUT_LIMIT = 64 * 1024;
+const PICKER_TITLE = 'Open a Rivet project';
+const MAC_FOLDER_SCRIPT = `
+ObjC.import('AppKit');
+const anchor = $.NSEvent.mouseLocation;
+const application = $.NSApplication.sharedApplication;
+application.setActivationPolicy($.NSApplicationActivationPolicyAccessory);
+application.finishLaunching;
+const panel = $.NSOpenPanel.openPanel;
+panel.canChooseFiles = false;
+panel.canChooseDirectories = true;
+panel.allowsMultipleSelection = false;
+panel.title = 'Open a Rivet project';
+panel.prompt = 'Open';
+const screens = $.NSScreen.screens;
+let screen = $.NSScreen.mainScreen;
+for (let index = 0; index < screens.count; index++) {
+  const candidate = screens.objectAtIndex(index);
+  if ($.NSPointInRect(anchor, candidate.frame)) {
+    screen = candidate;
+    break;
+  }
+}
+const visible = screen.visibleFrame;
+const position = (${windowPlacement_1.getWindowTopLeft.toString()})({
+  anchor,
+  bounds: {
+    x: visible.origin.x,
+    y: visible.origin.y,
+    width: visible.size.width,
+    height: visible.size.height,
+  },
+  size: {
+    width: panel.frame.size.width,
+    height: panel.frame.size.height,
+  },
+});
+panel.setFrameTopLeftPoint($.NSMakePoint(position.x, position.y));
+application.activateIgnoringOtherApps(true);
+panel.makeKeyAndOrderFront(null);
+panel.runModal === $.NSModalResponseOK ? ObjC.unwrap(panel.URL.path) : '';
+`;
+const WINDOWS_FOLDER_SCRIPT = `
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+Add-Type -AssemblyName System.Windows.Forms
+[System.Windows.Forms.Application]::EnableVisualStyles()
+$dialog = [System.Windows.Forms.FolderBrowserDialog]::new()
+$dialog.Description = 'Open a Rivet project'
+try {
+  if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
+    [Console]::Write($dialog.SelectedPath)
+  }
+} finally {
+  $dialog.Dispose()
+}`;
+/** Selects host folder dialogs without constructing a shell command from user input. */
+const folderPickerCommands = () => {
+    switch (process.platform) {
+        case 'darwin':
+            return [
+                {
+                    executable: '/usr/bin/osascript',
+                    args: ['-l', 'JavaScript', '-e', MAC_FOLDER_SCRIPT],
+                },
+            ];
+        case 'win32':
+            return [
+                {
+                    executable: 'powershell.exe',
+                    args: [
+                        '-NoProfile',
+                        '-NonInteractive',
+                        '-STA',
+                        '-Command',
+                        WINDOWS_FOLDER_SCRIPT,
+                    ],
+                },
+            ];
+        case 'linux': {
+            const zenity = {
+                executable: 'zenity',
+                args: ['--file-selection', '--directory', '--title', PICKER_TITLE],
+                cancelExitCode: 1,
+            };
+            const kdialog = {
+                executable: 'kdialog',
+                args: ['--getexistingdirectory', os_1.default.homedir(), '--title', PICKER_TITLE],
+                cancelExitCode: 1,
+            };
+            return process.env.XDG_CURRENT_DESKTOP?.toLowerCase().includes('kde')
+                ? [kdialog, zenity]
+                : [zenity, kdialog];
+        }
+        default:
+            return [];
+    }
+};
+/** Owns one system folder dialog at a time, independently of project registration. */
+class ProjectFolderPicker {
+    active = null;
+    commands;
+    constructor({ commands = folderPickerCommands() } = {}) {
+        this.commands = commands;
+    }
+    /** Opens the host dialog and returns a verified folder, or null when cancelled. */
+    async pick() {
+        if (this.active)
+            throw new libraryErrors_1.LibraryError('folder_picker_busy', 'A folder picker is already open. Choose a folder or cancel it first.');
+        const controller = new AbortController();
+        this.active = controller;
+        try {
+            for (const command of this.commands) {
+                let output;
+                try {
+                    const result = await execute(command.executable, command.args, {
+                        encoding: 'utf8',
+                        windowsHide: true,
+                        timeout: PICKER_TIMEOUT_MS,
+                        maxBuffer: PICKER_OUTPUT_LIMIT,
+                        signal: controller.signal,
+                    });
+                    output = result.stdout;
+                }
+                catch (error) {
+                    if (controller.signal.aborted)
+                        return null;
+                    const failure = error;
+                    if (failure.code === 'ENOENT')
+                        continue;
+                    if (command.cancelExitCode !== undefined &&
+                        failure.code === command.cancelExitCode &&
+                        !failure.stderr?.trim())
+                        return null;
+                    throw new libraryErrors_1.LibraryError('folder_picker_unavailable', 'Could not open the system folder picker. Try again, or run rivet open --project <path> in a terminal.');
+                }
+                const selected = output.replace(/\r?\n$/, '');
+                if (!selected)
+                    return null;
+                if (!path_1.default.isAbsolute(selected))
+                    throw new Error('Select an existing folder.');
+                const canonical = await promises_1.default.realpath(selected);
+                if (!(await promises_1.default.stat(canonical)).isDirectory())
+                    throw new Error('Select an existing folder.');
+                return canonical;
+            }
+            throw new libraryErrors_1.LibraryError('folder_picker_unavailable', 'No system folder picker is available. On Linux, install Zenity or KDialog, or run rivet open --project <path> in a terminal.');
+        }
+        finally {
+            this.active = null;
+        }
+    }
+    /** Dismisses the owned dialog when the coordinator shuts down. */
+    close() {
+        this.active?.abort();
+    }
+}
+exports.ProjectFolderPicker = ProjectFolderPicker;
+//# sourceMappingURL=ProjectFolderPicker.js.map

package/dist/services/ProjectFolderPicker.js.map

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

package/dist/services/ProjectImport.d.ts

@@ -0,0 +1,13 @@
+import type { ProjectRegistry } from './ProjectRegistry';
+interface ImportOptions {
+    registry: ProjectRegistry;
+    projectId: string;
+}
+export type ProjectImportResult = {
+    status: 'imported' | 'current' | 'deferred' | 'diverged';
+    reason?: string;
+};
+/** Copies and verifies a quiescent source before publishing its durable bundle. */
+export declare const importProject: ({ registry, projectId, }: ImportOptions) => Promise<ProjectImportResult>;
+export {};
+//# sourceMappingURL=ProjectImport.d.ts.map

package/dist/services/ProjectImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectImport.d.ts","sourceRoot":"","sources":["../../src/services/ProjectImport.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASzD,UAAU,aAAa;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuEF,mFAAmF;AACnF,eAAO,MAAM,aAAa,GAAU,0BAGjC,aAAa,KAAG,OAAO,CAAC,mBAAmB,CAiM7C,CAAC"}

package/dist/services/ProjectImport.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importProject = void 0;
+const sourcePresentation_1 = require("../storage/library/sourcePresentation");
+const promises_1 = __importDefault(require("fs/promises"));
+const historyRoots_1 = require("./historyRoots");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const serverHandshake_1 = require("../cli/serverHandshake");
+const pid_1 = require("../utils/pid");
+const TreeStore_1 = require("./TreeStore");
+const ProjectStorage_1 = require("./ProjectStorage");
+const BundleMetadataStore_1 = require("../storage/library/BundleMetadataStore");
+const importFiles_1 = require("../library/importFiles");
+const RECEIPT_FILENAME = 'import-receipt.json';
+const RUNTIME_CHANNELS = ['production', 'local'];
+/** Preserves active and uncertain writers rather than attempting to stop their work. */
+const sourceCanWrite = (projectPath, channel) => {
+    const discovery = (0, serverHandshake_1.readHandshakeResult)(projectPath, channel);
+    if (discovery.status === 'invalid')
+        return true;
+    if (discovery.status === 'found' && (0, pid_1.isPidAlive)(discovery.handshake.pid))
+        return true;
+    const lock = path_1.default.join((0, serverHandshake_1.serverRuntimeDirectory)(projectPath, channel), 'server.lock');
+    try {
+        const holder = Number(fs_1.default.readFileSync(lock, 'utf8'));
+        return !Number.isInteger(holder) || holder <= 0 || (0, pid_1.isPidAlive)(holder);
+    }
+    catch (error) {
+        return error.code !== 'ENOENT';
+    }
+};
+/** Verifies every referenced file and snapshot before an imported record is activated. */
+const verifyImportedVariant = async ({ manifest, artifactRoot, trees, projectPath, }) => {
+    if (manifest.artifact.kind === 'diff')
+        await (0, importFiles_1.verifyArtifactFile)(artifactRoot, manifest.artifact.diffPath);
+    if (manifest.artifact.filesPath &&
+        !(await promises_1.default.stat(path_1.default.join(artifactRoot, manifest.artifact.filesPath))).isDirectory())
+        throw new Error('Missing saved files');
+    if (manifest.preview.kind === 'static')
+        await (0, importFiles_1.verifyArtifactFile)(artifactRoot, path_1.default.join(manifest.preview.rootPath, manifest.preview.entryPath));
+    for (const pointer of [manifest.tree, manifest.base, manifest.parent]) {
+        if (!pointer)
+            continue;
+        const resolved = await trees.resolveRef(projectPath, pointer.commitSha);
+        if (!resolved ||
+            ('treeSha' in pointer && pointer.treeSha !== resolved.treeSha))
+            throw new Error(`Missing snapshot: ${pointer.commitSha}`);
+        await trees.retainSnapshot(projectPath, pointer.commitSha);
+    }
+    if (manifest.tree && manifest.serve?.kind === 'static') {
+        const extracted = await trees.extractToCache({
+            projectPath,
+            treeSha: manifest.tree.treeSha,
+            commitish: manifest.tree.commitSha,
+        });
+        await (0, importFiles_1.verifyArtifactFile)(extracted, manifest.serve.entryPath);
+    }
+};
+/** Copies and verifies a quiescent source before publishing its durable bundle. */
+const importProject = async ({ registry, projectId, }) => {
+    const project = registry.get(projectId);
+    const source = path_1.default.join(project.projectPath, '.rivet');
+    const nestedRoots = (0, historyRoots_1.nestedFreshSessionWorkdirs)(project.projectPath);
+    if (nestedRoots.length > 0) {
+        for (const projectPath of nestedRoots)
+            registry.attachHistoryRoot({ projectId, projectPath });
+        return {
+            status: 'deferred',
+            reason: 'This workspace contains nested project histories; they remain readable in their original locations',
+        };
+    }
+    if (!project.isAvailable)
+        return {
+            status: project.storageKind === 'bundle' ? 'current' : 'deferred',
+            reason: 'Workspace is unavailable',
+        };
+    if (RUNTIME_CHANNELS.some((channel) => sourceCanWrite(project.projectPath, channel)))
+        return {
+            status: 'deferred',
+            reason: 'A source runtime or opener may still write history',
+        };
+    const locks = [];
+    try {
+        for (const channel of RUNTIME_CHANNELS) {
+            const lock = (0, serverHandshake_1.acquireStartLock)(project.projectPath, channel);
+            if (!lock) {
+                return {
+                    status: 'deferred',
+                    reason: 'A project opener holds the startup lock',
+                };
+            }
+            locks.push(lock);
+        }
+        const hasWriter = RUNTIME_CHANNELS.some((channel) => {
+            const discovery = (0, serverHandshake_1.readHandshakeResult)(project.projectPath, channel);
+            return (discovery.status === 'invalid' ||
+                (discovery.status === 'found' && (0, pid_1.isPidAlive)(discovery.handshake.pid)));
+        });
+        if (hasWriter)
+            return { status: 'deferred', reason: 'Source runtime became available' };
+        const fingerprint = await (0, importFiles_1.sourceFingerprint)(source);
+        if (project.storageKind === 'bundle') {
+            return {
+                status: project.sourceFingerprint === fingerprint ? 'current' : 'diverged',
+            };
+        }
+        const destination = registry.bundleDirectory(projectId);
+        if (fs_1.default.existsSync(destination)) {
+            const receipt = JSON.parse(await promises_1.default.readFile(path_1.default.join(destination, RECEIPT_FILENAME), 'utf8'));
+            if (receipt.projectId !== projectId ||
+                receipt.sourceFingerprint !== fingerprint)
+                return {
+                    status: 'diverged',
+                    reason: 'An unpublished bundle differs from this source',
+                };
+            const metadata = await BundleMetadataStore_1.BundleMetadataStore.open({
+                directory: destination,
+                project,
+            });
+            try {
+                const trees = new TreeStore_1.TreeStore(new ProjectStorage_1.ProjectStorage([
+                    {
+                        projectPath: project.projectPath,
+                        dataDirectory: destination,
+                        cacheDirectory: path_1.default.join(registry.root, 'cache', projectId),
+                    },
+                ]));
+                const manifests = metadata.listVariants();
+                if (manifests.length !== (await (0, importFiles_1.readSourceManifests)(source)).length)
+                    throw new Error('Incomplete published bundle');
+                for (const manifest of manifests) {
+                    const relative = metadata.artifactPath(manifest.sessionId, manifest.variantId);
+                    if (!relative)
+                        throw new Error('Missing imported artifact path');
+                    const artifactRoot = path_1.default.resolve(destination, relative);
+                    if (!artifactRoot.startsWith(destination + path_1.default.sep))
+                        throw new Error('Artifact escapes bundle');
+                    await verifyImportedVariant({
+                        manifest,
+                        artifactRoot,
+                        trees,
+                        projectPath: project.projectPath,
+                    });
+                }
+            }
+            finally {
+                metadata.close();
+            }
+            registry.activateBundle({ projectId, sourceFingerprint: fingerprint });
+            return { status: 'imported' };
+        }
+        const stage = path_1.default.join(registry.root, 'staging', `${projectId}-${(0, crypto_1.randomUUID)()}`);
+        await promises_1.default.mkdir(stage, { recursive: true });
+        let metadata;
+        try {
+            const manifests = await (0, importFiles_1.readSourceManifests)(source);
+            const presentation = await (0, sourcePresentation_1.readSourcePresentation)(source);
+            await (0, importFiles_1.copySourceFiles)(source, stage);
+            await (0, importFiles_1.relocateContext)({
+                sourceDirectory: source,
+                stageDirectory: stage,
+                bundleDirectory: destination,
+            });
+            metadata = await BundleMetadataStore_1.BundleMetadataStore.open({ directory: stage, project });
+            const trees = new TreeStore_1.TreeStore(new ProjectStorage_1.ProjectStorage([
+                {
+                    projectPath: project.projectPath,
+                    dataDirectory: stage,
+                    cacheDirectory: path_1.default.join(registry.root, 'cache', projectId),
+                },
+            ]));
+            if (trees.hasStore(project.projectPath))
+                await trees.fsck(project.projectPath);
+            for (const manifest of manifests) {
+                const relative = path_1.default.join('variants', manifest.sessionId, manifest.variantId);
+                const artifactRoot = path_1.default.join(stage, relative);
+                await verifyImportedVariant({
+                    manifest,
+                    artifactRoot,
+                    trees,
+                    projectPath: project.projectPath,
+                });
+                metadata.upsertVariant(manifest, relative);
+            }
+            const sessions = new Set(manifests.map((manifest) => manifest.sessionId));
+            for (const sessionId of sessions) {
+                const sessionPath = path_1.default.join(stage, 'variants', sessionId, 'session.json');
+                if (!fs_1.default.existsSync(sessionPath))
+                    continue;
+                const session = JSON.parse(await promises_1.default.readFile(sessionPath, 'utf8'));
+                if (session.schemaVersion !== 2 || session.sessionId !== sessionId)
+                    throw new Error('Unsupported session metadata');
+                metadata.putSession(session);
+            }
+            if (presentation !== null)
+                metadata.setPresentation(JSON.parse(presentation));
+            if (metadata.listVariants().length !== manifests.length)
+                throw new Error('Imported history count does not match source');
+            metadata.close();
+            metadata = undefined;
+            if ((await (0, importFiles_1.sourceFingerprint)(source)) !== fingerprint)
+                throw new Error('Source history changed during import; retry after its writer stops');
+            await promises_1.default.writeFile(path_1.default.join(stage, RECEIPT_FILENAME), JSON.stringify({ projectId, sourceFingerprint: fingerprint }), { mode: 0o600 });
+            await promises_1.default.mkdir(path_1.default.dirname(destination), { recursive: true });
+            await promises_1.default.rename(stage, destination);
+            registry.activateBundle({ projectId, sourceFingerprint: fingerprint });
+            return { status: 'imported' };
+        }
+        catch (error) {
+            metadata?.close();
+            await promises_1.default.rm(stage, { recursive: true, force: true });
+            throw error;
+        }
+    }
+    finally {
+        for (const lock of locks)
+            lock.release();
+    }
+};
+exports.importProject = importProject;
+//# sourceMappingURL=ProjectImport.js.map

package/dist/services/ProjectImport.js.map

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

package/dist/services/ProjectLibrary.d.ts

@@ -0,0 +1,74 @@
+import type { LibraryProject, ProjectLibrarySnapshot } from '../types/project-library';
+import type { HubNavigationTarget } from './HubNavigation';
+import { ProjectRegistry, type RegisteredProject } from './ProjectRegistry';
+import { type ProjectImportResult } from './ProjectImport';
+import { VariantHistoryService, type VariantHistoryEntry, type VariantHistoryDetail } from './VariantHistoryService';
+export interface LibraryVariant extends VariantHistoryEntry {
+    projectId: string;
+    projectPath: string;
+}
+interface VariantReference {
+    projectId: string;
+    sessionId: string;
+    variantId: string;
+}
+/** Resolves the installation's library root, with explicit isolated roots for automation. */
+export declare const currentLibraryRoot: (env?: NodeJS.ProcessEnv) => string;
+/** Serves project-scoped saved history without starting application runtimes. */
+export declare class ProjectLibrary {
+    readonly registry: ProjectRegistry;
+    private readonly owners;
+    readonly issues: Map<string, string>;
+    private isClosed;
+    private constructor();
+    /** Opens the project library independently of any selected workspace. */
+    static open(root?: string): Promise<ProjectLibrary>;
+    /** Registers an opened project and imports its quiescent supported history. */
+    prepare(projectPath: string): Promise<{
+        project: RegisteredProject;
+        migration: ProjectImportResult;
+    }>;
+    /** Relinks a working folder and refreshes its storage attachment. */
+    relink(args: {
+        projectId: string;
+        projectPath: string;
+    }): Promise<RegisteredProject>;
+    /** Closes cached metadata before changing the project's storage attachment. */
+    private invalidate;
+    /** Lists registered workspaces and known issues without opening saved history. */
+    listProjects(): LibraryProject[];
+    /** Builds the library view from saved history and current workspace availability. */
+    snapshot(): Promise<ProjectLibrarySnapshot>;
+    /** Applies metadata edits through the exact direction's authoritative history owner. */
+    updateVariant(args: VariantReference & {
+        label?: string;
+        status?: 'removed';
+    }): Promise<void>;
+    /** Verifies the selected project and saved direction before delivering navigation. */
+    assertNavigationTarget(target: HubNavigationTarget): Promise<void>;
+    /** Returns one shared history service for a project's persisted storage owner. */
+    history(projectId: string): Promise<VariantHistoryService>;
+    /** Registers a generated directory with the same history owner before generation writes. */
+    attachGeneratedRoot({ projectId, projectPath, }: {
+        projectId: string;
+        projectPath: string;
+    }): Promise<void>;
+    /** Lists one project's directions, including preserved generated history roots. */
+    private listProject;
+    /** Aggregates readable projects while retaining individual project availability errors. */
+    listVariants(projectId?: string): Promise<LibraryVariant[]>;
+    /** Resolves an exact reference together with the filesystem root that owns it. */
+    variant(reference: VariantReference): Promise<{
+        detail: VariantHistoryDetail;
+        projectPath: string;
+        history: VariantHistoryService;
+    } | null>;
+    /** Releases metadata connections; running project processes have separate lifetimes. */
+    close(): void;
+    /** Initializes one storage owner and shares it across concurrent library reads. */
+    private owner;
+    /** Attaches bundle metadata only when its registry activation is committed. */
+    private createOwner;
+}
+export {};
+//# sourceMappingURL=ProjectLibrary.d.ts.map

package/dist/services/ProjectLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectLibrary.d.ts","sourceRoot":"","sources":["../../src/services/ProjectLibrary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,OAAO,EACL,eAAe,EAEf,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI1E,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAC7B,MAAK,MAAM,CAAC,UAAwB,KACnC,MAKF,CAAC;AAEF,iFAAiF;AACjF,qBAAa,cAAc;IAIL,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAHtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IACnE,QAAQ,CAAC,MAAM,sBAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO;IAEP,yEAAyE;WAC5D,IAAI,CAAC,IAAI,SAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIvE,+EAA+E;IACzE,OAAO,CACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAgC1E,qEAAqE;IAC/D,MAAM,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO9B,+EAA+E;YACjE,UAAU;IASxB,kFAAkF;IAClF,YAAY,IAAI,cAAc,EAAE;IAMhC,qFAAqF;IAC/E,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAiBjD,wFAAwF;IAClF,aAAa,CACjB,IAAI,EAAE,gBAAgB,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,GAC9D,OAAO,CAAC,IAAI,CAAC;IAWhB,sFAAsF;IAChF,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAexE,kFAAkF;IAC5E,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhE,4FAA4F;IACtF,mBAAmB,CAAC,EACxB,SAAS,EACT,WAAW,GACZ,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB,mFAAmF;YACrE,WAAW;IAuCzB,2FAA2F;IACrF,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBjE,kFAAkF;IAC5E,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAClD,MAAM,EAAE,oBAAoB,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,qBAAqB,CAAC;KAChC,GAAG,IAAI,CAAC;IAcT,wFAAwF;IACxF,KAAK,IAAI,IAAI;IAcb,mFAAmF;IACnF,OAAO,CAAC,KAAK;IASb,+EAA+E;YACjE,WAAW;CA4B1B"}