@anthropic-field/core 0.1.0

package/dist/src/hooks/types.js

@@ -0,0 +1,303 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { defaultHookTranslator } from './hookTranslator.js';
+/**
+ * Configuration source levels in precedence order (highest to lowest)
+ */
+export var ConfigSource;
+(function (ConfigSource) {
+    ConfigSource["Project"] = "project";
+    ConfigSource["User"] = "user";
+    ConfigSource["System"] = "system";
+    ConfigSource["Extensions"] = "extensions";
+})(ConfigSource || (ConfigSource = {}));
+/**
+ * Event names for the hook system
+ */
+export var HookEventName;
+(function (HookEventName) {
+    HookEventName["BeforeTool"] = "BeforeTool";
+    HookEventName["AfterTool"] = "AfterTool";
+    HookEventName["BeforeAgent"] = "BeforeAgent";
+    HookEventName["Notification"] = "Notification";
+    HookEventName["AfterAgent"] = "AfterAgent";
+    HookEventName["SessionStart"] = "SessionStart";
+    HookEventName["SessionEnd"] = "SessionEnd";
+    HookEventName["PreCompress"] = "PreCompress";
+    HookEventName["BeforeModel"] = "BeforeModel";
+    HookEventName["AfterModel"] = "AfterModel";
+    HookEventName["BeforeToolSelection"] = "BeforeToolSelection";
+})(HookEventName || (HookEventName = {}));
+/**
+ * Fields in the hooks configuration that are not hook event names
+ */
+export const HOOKS_CONFIG_FIELDS = ['enabled', 'disabled', 'notifications'];
+/**
+ * Hook implementation types
+ */
+export var HookType;
+(function (HookType) {
+    HookType["Command"] = "command";
+})(HookType || (HookType = {}));
+/**
+ * Generate a unique key for a hook configuration
+ */
+export function getHookKey(hook) {
+    const name = hook.name || '';
+    const command = hook.command || '';
+    return `${name}:${command}`;
+}
+/**
+ * Factory function to create the appropriate hook output class based on event name
+ * Returns DefaultHookOutput for all events since it contains all necessary methods
+ */
+export function createHookOutput(eventName, data) {
+    switch (eventName) {
+        case 'BeforeModel':
+            return new BeforeModelHookOutput(data);
+        case 'AfterModel':
+            return new AfterModelHookOutput(data);
+        case 'BeforeToolSelection':
+            return new BeforeToolSelectionHookOutput(data);
+        case 'BeforeTool':
+            return new BeforeToolHookOutput(data);
+        case 'AfterAgent':
+            return new AfterAgentHookOutput(data);
+        default:
+            return new DefaultHookOutput(data);
+    }
+}
+/**
+ * Default implementation of HookOutput with utility methods
+ */
+export class DefaultHookOutput {
+    continue;
+    stopReason;
+    suppressOutput;
+    systemMessage;
+    decision;
+    reason;
+    hookSpecificOutput;
+    constructor(data = {}) {
+        this.continue = data.continue;
+        this.stopReason = data.stopReason;
+        this.suppressOutput = data.suppressOutput;
+        this.systemMessage = data.systemMessage;
+        this.decision = data.decision;
+        this.reason = data.reason;
+        this.hookSpecificOutput = data.hookSpecificOutput;
+    }
+    /**
+     * Check if this output represents a blocking decision
+     */
+    isBlockingDecision() {
+        return this.decision === 'block' || this.decision === 'deny';
+    }
+    /**
+     * Check if this output requests to stop execution
+     */
+    shouldStopExecution() {
+        return this.continue === false;
+    }
+    /**
+     * Get the effective reason for blocking or stopping
+     */
+    getEffectiveReason() {
+        return this.stopReason || this.reason || 'No reason provided';
+    }
+    /**
+     * Apply LLM request modifications (specific method for BeforeModel hooks)
+     */
+    applyLLMRequestModifications(target) {
+        // Base implementation - overridden by BeforeModelHookOutput
+        return target;
+    }
+    /**
+     * Apply tool config modifications (specific method for BeforeToolSelection hooks)
+     */
+    applyToolConfigModifications(target) {
+        // Base implementation - overridden by BeforeToolSelectionHookOutput
+        return target;
+    }
+    /**
+     * Get sanitized additional context for adding to responses.
+     */
+    getAdditionalContext() {
+        if (this.hookSpecificOutput &&
+            'additionalContext' in this.hookSpecificOutput) {
+            const context = this.hookSpecificOutput['additionalContext'];
+            if (typeof context !== 'string') {
+                return undefined;
+            }
+            // Sanitize by escaping < and > to prevent tag injection
+            return context.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        }
+        return undefined;
+    }
+    /**
+     * Check if execution should be blocked and return error info
+     */
+    getBlockingError() {
+        if (this.isBlockingDecision()) {
+            return {
+                blocked: true,
+                reason: this.getEffectiveReason(),
+            };
+        }
+        return { blocked: false, reason: '' };
+    }
+    /**
+     * Check if context clearing was requested by hook.
+     */
+    shouldClearContext() {
+        return false;
+    }
+}
+/**
+ * Specific hook output class for BeforeTool events.
+ */
+export class BeforeToolHookOutput extends DefaultHookOutput {
+    /**
+     * Get modified tool input if provided by hook
+     */
+    getModifiedToolInput() {
+        if (this.hookSpecificOutput && 'tool_input' in this.hookSpecificOutput) {
+            const input = this.hookSpecificOutput['tool_input'];
+            if (typeof input === 'object' &&
+                input !== null &&
+                !Array.isArray(input)) {
+                return input;
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * Specific hook output class for BeforeModel events
+ */
+export class BeforeModelHookOutput extends DefaultHookOutput {
+    /**
+     * Get synthetic LLM response if provided by hook
+     */
+    getSyntheticResponse() {
+        if (this.hookSpecificOutput && 'llm_response' in this.hookSpecificOutput) {
+            const hookResponse = this.hookSpecificOutput['llm_response'];
+            if (hookResponse) {
+                // Convert hook format to SDK format
+                return defaultHookTranslator.fromHookLLMResponse(hookResponse);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Apply modifications to LLM request
+     */
+    applyLLMRequestModifications(target) {
+        if (this.hookSpecificOutput && 'llm_request' in this.hookSpecificOutput) {
+            const hookRequest = this.hookSpecificOutput['llm_request'];
+            if (hookRequest) {
+                // Convert hook format to SDK format
+                const sdkRequest = defaultHookTranslator.fromHookLLMRequest(hookRequest, target);
+                return {
+                    ...target,
+                    ...sdkRequest,
+                };
+            }
+        }
+        return target;
+    }
+}
+/**
+ * Specific hook output class for BeforeToolSelection events
+ */
+export class BeforeToolSelectionHookOutput extends DefaultHookOutput {
+    /**
+     * Apply tool configuration modifications
+     */
+    applyToolConfigModifications(target) {
+        if (this.hookSpecificOutput && 'toolConfig' in this.hookSpecificOutput) {
+            const hookToolConfig = this.hookSpecificOutput['toolConfig'];
+            if (hookToolConfig) {
+                // Convert hook format to SDK format
+                const sdkToolConfig = defaultHookTranslator.fromHookToolConfig(hookToolConfig);
+                return {
+                    ...target,
+                    tools: target.tools || [],
+                    toolConfig: sdkToolConfig,
+                };
+            }
+        }
+        return target;
+    }
+}
+/**
+ * Specific hook output class for AfterModel events
+ */
+export class AfterModelHookOutput extends DefaultHookOutput {
+    /**
+     * Get modified LLM response if provided by hook
+     */
+    getModifiedResponse() {
+        if (this.hookSpecificOutput && 'llm_response' in this.hookSpecificOutput) {
+            const hookResponse = this.hookSpecificOutput['llm_response'];
+            if (hookResponse?.candidates?.[0]?.content?.parts?.length) {
+                // Convert hook format to SDK format
+                return defaultHookTranslator.fromHookLLMResponse(hookResponse);
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * Specific hook output class for AfterAgent events
+ */
+export class AfterAgentHookOutput extends DefaultHookOutput {
+    /**
+     * Check if context clearing was requested by hook
+     */
+    shouldClearContext() {
+        if (this.hookSpecificOutput && 'clearContext' in this.hookSpecificOutput) {
+            return this.hookSpecificOutput['clearContext'] === true;
+        }
+        return false;
+    }
+}
+/**
+ * Notification types
+ */
+export var NotificationType;
+(function (NotificationType) {
+    NotificationType["ToolPermission"] = "ToolPermission";
+})(NotificationType || (NotificationType = {}));
+/**
+ * SessionStart source types
+ */
+export var SessionStartSource;
+(function (SessionStartSource) {
+    SessionStartSource["Startup"] = "startup";
+    SessionStartSource["Resume"] = "resume";
+    SessionStartSource["Clear"] = "clear";
+})(SessionStartSource || (SessionStartSource = {}));
+/**
+ * SessionEnd reason types
+ */
+export var SessionEndReason;
+(function (SessionEndReason) {
+    SessionEndReason["Exit"] = "exit";
+    SessionEndReason["Clear"] = "clear";
+    SessionEndReason["Logout"] = "logout";
+    SessionEndReason["PromptInputExit"] = "prompt_input_exit";
+    SessionEndReason["Other"] = "other";
+})(SessionEndReason || (SessionEndReason = {}));
+/**
+ * PreCompress trigger types
+ */
+export var PreCompressTrigger;
+(function (PreCompressTrigger) {
+    PreCompressTrigger["Manual"] = "manual";
+    PreCompressTrigger["Auto"] = "auto";
+})(PreCompressTrigger || (PreCompressTrigger = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/hooks/types.js.map

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

package/dist/src/ide/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const GEMINI_CLI_COMPANION_EXTENSION_NAME = "Gemini CLI Companion";
+export declare const IDE_MAX_OPEN_FILES = 10;
+export declare const IDE_MAX_SELECTED_TEXT_LENGTH = 16384;
+export declare const IDE_REQUEST_TIMEOUT_MS: number;

package/dist/src/ide/constants.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const GEMINI_CLI_COMPANION_EXTENSION_NAME = 'Gemini CLI Companion';
+export const IDE_MAX_OPEN_FILES = 10;
+export const IDE_MAX_SELECTED_TEXT_LENGTH = 16384; // 16 KiB limit
+export const IDE_REQUEST_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+//# sourceMappingURL=constants.js.map

package/dist/src/ide/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/ide/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mCAAmC,GAAG,sBAAsB,CAAC;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,CAAC,eAAe;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa"}

package/dist/src/ide/detect-ide.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const IDE_DEFINITIONS: {
+    readonly devin: {
+        readonly name: "devin";
+        readonly displayName: "Devin";
+    };
+    readonly replit: {
+        readonly name: "replit";
+        readonly displayName: "Replit";
+    };
+    readonly cursor: {
+        readonly name: "cursor";
+        readonly displayName: "Cursor";
+    };
+    readonly cloudshell: {
+        readonly name: "cloudshell";
+        readonly displayName: "Cloud Shell";
+    };
+    readonly codespaces: {
+        readonly name: "codespaces";
+        readonly displayName: "GitHub Codespaces";
+    };
+    readonly firebasestudio: {
+        readonly name: "firebasestudio";
+        readonly displayName: "Firebase Studio";
+    };
+    readonly trae: {
+        readonly name: "trae";
+        readonly displayName: "Trae";
+    };
+    readonly vscode: {
+        readonly name: "vscode";
+        readonly displayName: "VS Code";
+    };
+    readonly vscodefork: {
+        readonly name: "vscodefork";
+        readonly displayName: "IDE";
+    };
+    readonly positron: {
+        readonly name: "positron";
+        readonly displayName: "Positron";
+    };
+    readonly antigravity: {
+        readonly name: "antigravity";
+        readonly displayName: "Antigravity";
+    };
+    readonly sublimetext: {
+        readonly name: "sublimetext";
+        readonly displayName: "Sublime Text";
+    };
+    readonly jetbrains: {
+        readonly name: "jetbrains";
+        readonly displayName: "JetBrains IDE";
+    };
+    readonly intellijidea: {
+        readonly name: "intellijidea";
+        readonly displayName: "IntelliJ IDEA";
+    };
+    readonly webstorm: {
+        readonly name: "webstorm";
+        readonly displayName: "WebStorm";
+    };
+    readonly pycharm: {
+        readonly name: "pycharm";
+        readonly displayName: "PyCharm";
+    };
+    readonly goland: {
+        readonly name: "goland";
+        readonly displayName: "GoLand";
+    };
+    readonly androidstudio: {
+        readonly name: "androidstudio";
+        readonly displayName: "Android Studio";
+    };
+    readonly clion: {
+        readonly name: "clion";
+        readonly displayName: "CLion";
+    };
+    readonly rustrover: {
+        readonly name: "rustrover";
+        readonly displayName: "RustRover";
+    };
+    readonly datagrip: {
+        readonly name: "datagrip";
+        readonly displayName: "DataGrip";
+    };
+    readonly phpstorm: {
+        readonly name: "phpstorm";
+        readonly displayName: "PhpStorm";
+    };
+};
+export interface IdeInfo {
+    name: string;
+    displayName: string;
+}
+export declare function isCloudShell(): boolean;
+export declare function isJetBrains(): boolean;
+export declare function detectIdeFromEnv(): IdeInfo;
+export declare function detectIde(ideProcessInfo: {
+    pid: number;
+    command: string;
+}, ideInfoFromFile?: {
+    name?: string;
+    displayName?: string;
+}): IdeInfo | undefined;

package/dist/src/ide/detect-ide.js

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const IDE_DEFINITIONS = {
+    devin: { name: 'devin', displayName: 'Devin' },
+    replit: { name: 'replit', displayName: 'Replit' },
+    cursor: { name: 'cursor', displayName: 'Cursor' },
+    cloudshell: { name: 'cloudshell', displayName: 'Cloud Shell' },
+    codespaces: { name: 'codespaces', displayName: 'GitHub Codespaces' },
+    firebasestudio: { name: 'firebasestudio', displayName: 'Firebase Studio' },
+    trae: { name: 'trae', displayName: 'Trae' },
+    vscode: { name: 'vscode', displayName: 'VS Code' },
+    vscodefork: { name: 'vscodefork', displayName: 'IDE' },
+    positron: { name: 'positron', displayName: 'Positron' },
+    antigravity: { name: 'antigravity', displayName: 'Antigravity' },
+    sublimetext: { name: 'sublimetext', displayName: 'Sublime Text' },
+    jetbrains: { name: 'jetbrains', displayName: 'JetBrains IDE' },
+    intellijidea: { name: 'intellijidea', displayName: 'IntelliJ IDEA' },
+    webstorm: { name: 'webstorm', displayName: 'WebStorm' },
+    pycharm: { name: 'pycharm', displayName: 'PyCharm' },
+    goland: { name: 'goland', displayName: 'GoLand' },
+    androidstudio: { name: 'androidstudio', displayName: 'Android Studio' },
+    clion: { name: 'clion', displayName: 'CLion' },
+    rustrover: { name: 'rustrover', displayName: 'RustRover' },
+    datagrip: { name: 'datagrip', displayName: 'DataGrip' },
+    phpstorm: { name: 'phpstorm', displayName: 'PhpStorm' },
+};
+export function isCloudShell() {
+    return !!(process.env['EDITOR_IN_CLOUD_SHELL'] || process.env['CLOUD_SHELL']);
+}
+export function isJetBrains() {
+    return !!process.env['TERMINAL_EMULATOR']
+        ?.toLowerCase()
+        .includes('jetbrains');
+}
+export function detectIdeFromEnv() {
+    if (process.env['ANTIGRAVITY_CLI_ALIAS']) {
+        return IDE_DEFINITIONS.antigravity;
+    }
+    if (process.env['__COG_BASHRC_SOURCED']) {
+        return IDE_DEFINITIONS.devin;
+    }
+    if (process.env['REPLIT_USER']) {
+        return IDE_DEFINITIONS.replit;
+    }
+    if (process.env['CURSOR_TRACE_ID']) {
+        return IDE_DEFINITIONS.cursor;
+    }
+    if (process.env['CODESPACES']) {
+        return IDE_DEFINITIONS.codespaces;
+    }
+    if (isCloudShell()) {
+        return IDE_DEFINITIONS.cloudshell;
+    }
+    if (process.env['TERM_PRODUCT'] === 'Trae') {
+        return IDE_DEFINITIONS.trae;
+    }
+    if (process.env['MONOSPACE_ENV']) {
+        return IDE_DEFINITIONS.firebasestudio;
+    }
+    if (process.env['POSITRON'] === '1') {
+        return IDE_DEFINITIONS.positron;
+    }
+    if (process.env['TERM_PROGRAM'] === 'sublime') {
+        return IDE_DEFINITIONS.sublimetext;
+    }
+    if (isJetBrains()) {
+        return IDE_DEFINITIONS.jetbrains;
+    }
+    return IDE_DEFINITIONS.vscode;
+}
+function verifyVSCode(ide, ideProcessInfo) {
+    if (ide.name !== IDE_DEFINITIONS.vscode.name) {
+        return ide;
+    }
+    if (!ideProcessInfo.command ||
+        ideProcessInfo.command.toLowerCase().includes('code')) {
+        return IDE_DEFINITIONS.vscode;
+    }
+    return IDE_DEFINITIONS.vscodefork;
+}
+function verifyJetBrains(ide, ideProcessInfo) {
+    if (ide.name !== IDE_DEFINITIONS.jetbrains.name || !ideProcessInfo.command) {
+        return ide;
+    }
+    const command = ideProcessInfo.command.toLowerCase();
+    const jetbrainsProducts = [
+        ['idea', IDE_DEFINITIONS.intellijidea],
+        ['webstorm', IDE_DEFINITIONS.webstorm],
+        ['pycharm', IDE_DEFINITIONS.pycharm],
+        ['goland', IDE_DEFINITIONS.goland],
+        ['studio', IDE_DEFINITIONS.androidstudio],
+        ['clion', IDE_DEFINITIONS.clion],
+        ['rustrover', IDE_DEFINITIONS.rustrover],
+        ['datagrip', IDE_DEFINITIONS.datagrip],
+        ['phpstorm', IDE_DEFINITIONS.phpstorm],
+    ];
+    for (const [product, ideInfo] of jetbrainsProducts) {
+        if (command.includes(product)) {
+            return ideInfo;
+        }
+    }
+    return ide;
+}
+export function detectIde(ideProcessInfo, ideInfoFromFile) {
+    if (ideInfoFromFile?.name && ideInfoFromFile.displayName) {
+        return {
+            name: ideInfoFromFile.name,
+            displayName: ideInfoFromFile.displayName,
+        };
+    }
+    // Only VS Code, Sublime Text and JetBrains integrations are currently supported.
+    if (process.env['TERM_PROGRAM'] !== 'vscode' &&
+        process.env['TERM_PROGRAM'] !== 'sublime' &&
+        !isJetBrains()) {
+        return undefined;
+    }
+    const ide = detectIdeFromEnv();
+    return isJetBrains()
+        ? verifyJetBrains(ide, ideProcessInfo)
+        : verifyVSCode(ide, ideProcessInfo);
+}
+//# sourceMappingURL=detect-ide.js.map

package/dist/src/ide/detect-ide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ide.js","sourceRoot":"","sources":["../../../src/ide/detect-ide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACjD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACjD,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE;IAC9D,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE;IACpE,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC1E,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;IAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE;IAClD,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE;IACtD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE;IAChE,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE;IACjE,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE;IAC9D,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE;IACpE,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;IACvD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE;IACpD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACjD,aAAa,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACvE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE;IAC1D,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;IACvD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;CAC/C,CAAC;AAOX,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,EAAE,WAAW,EAAE;SACd,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACzC,OAAO,eAAe,CAAC,WAAW,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACxC,OAAO,eAAe,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,UAAU,CAAC;IACpC,CAAC;IACD,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAO,eAAe,CAAC,UAAU,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,eAAe,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,cAAc,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,eAAe,CAAC,QAAQ,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,eAAe,CAAC,WAAW,CAAC;IACrC,CAAC;IACD,IAAI,WAAW,EAAE,EAAE,CAAC;QAClB,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CACnB,GAAY,EACZ,cAGC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IACE,CAAC,cAAc,CAAC,OAAO;QACvB,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EACrD,CAAC;QACD,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,OAAO,eAAe,CAAC,UAAU,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CACtB,GAAY,EACZ,cAGC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3E,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,iBAAiB,GAA6B;QAClD,CAAC,MAAM,EAAE,eAAe,CAAC,YAAY,CAAC;QACtC,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC;QACtC,CAAC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC;QACpC,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC;QAClC,CAAC,QAAQ,EAAE,eAAe,CAAC,aAAa,CAAC;QACzC,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC;QAChC,CAAC,WAAW,EAAE,eAAe,CAAC,SAAS,CAAC;QACxC,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC;QACtC,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC;KACvC,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACnD,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,cAGC,EACD,eAAyD;IAEzD,IAAI,eAAe,EAAE,IAAI,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,WAAW,EAAE,eAAe,CAAC,WAAW;SACzC,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,IACE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ;QACxC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,SAAS;QACzC,CAAC,WAAW,EAAE,EACd,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,OAAO,WAAW,EAAE;QAClB,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC;QACtC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC"}