@enactprotocol/secrets 2.0.0 → 2.0.2

package/dist/env/manager.js

@@ -0,0 +1,204 @@
+/**
+ * Unified environment variable manager
+ *
+ * Provides high-level functions for managing environment variables
+ * with priority resolution: local → global → default
+ */
+import { getGlobalEnvPath, getLocalEnvPath, globalEnvExists, loadGlobalEnv, loadLocalEnv, localEnvExists, } from "./reader";
+import { deleteGlobalEnvVar, deleteLocalEnvVar, setGlobalEnvVar, setLocalEnvVar } from "./writer";
+/**
+ * Set an environment variable
+ *
+ * @param key - Variable key
+ * @param value - Variable value
+ * @param scope - Where to set: 'local' or 'global' (default: 'global')
+ * @param cwd - Current working directory for local scope
+ */
+export function setEnv(key, value, scope = "global", cwd) {
+    if (scope === "local") {
+        setLocalEnvVar(key, value, cwd);
+    }
+    else {
+        setGlobalEnvVar(key, value);
+    }
+}
+/**
+ * Get an environment variable with priority resolution
+ *
+ * Priority: local → global → default
+ *
+ * @param key - Variable key
+ * @param defaultValue - Default value if not found
+ * @param cwd - Current working directory for local scope
+ * @returns Resolution result with value and source
+ */
+export function getEnv(key, defaultValue, cwd) {
+    // Check local first
+    const localVars = loadLocalEnv(cwd);
+    const localValue = localVars[key];
+    if (localValue !== undefined) {
+        return {
+            key,
+            value: localValue,
+            source: "local",
+            filePath: getLocalEnvPath(cwd),
+        };
+    }
+    // Check global
+    const globalVars = loadGlobalEnv();
+    const globalValue = globalVars[key];
+    if (globalValue !== undefined) {
+        return {
+            key,
+            value: globalValue,
+            source: "global",
+            filePath: getGlobalEnvPath(),
+        };
+    }
+    // Use default
+    if (defaultValue !== undefined) {
+        return {
+            key,
+            value: defaultValue,
+            source: "default",
+        };
+    }
+    return null;
+}
+/**
+ * Get just the value of an environment variable
+ *
+ * @param key - Variable key
+ * @param defaultValue - Default value if not found
+ * @param cwd - Current working directory for local scope
+ * @returns The value, or default/undefined if not found
+ */
+export function getEnvValue(key, defaultValue, cwd) {
+    const result = getEnv(key, defaultValue, cwd);
+    return result?.value;
+}
+/**
+ * Delete an environment variable
+ *
+ * @param key - Variable key
+ * @param scope - Where to delete from: 'local' or 'global' (default: 'global')
+ * @param cwd - Current working directory for local scope
+ * @returns true if variable existed and was deleted
+ */
+export function deleteEnv(key, scope = "global", cwd) {
+    if (scope === "local") {
+        return deleteLocalEnvVar(key, cwd);
+    }
+    return deleteGlobalEnvVar(key);
+}
+/**
+ * List all environment variables from a scope
+ *
+ * @param scope - Which scope to list: 'local', 'global', or 'all'
+ * @param cwd - Current working directory for local scope
+ * @returns Array of environment variables with sources
+ */
+export function listEnv(scope = "all", cwd) {
+    const results = [];
+    if (scope === "global" || scope === "all") {
+        const globalVars = loadGlobalEnv();
+        for (const [key, value] of Object.entries(globalVars)) {
+            results.push({ key, value, source: "global" });
+        }
+    }
+    if (scope === "local" || scope === "all") {
+        const localVars = loadLocalEnv(cwd);
+        for (const [key, value] of Object.entries(localVars)) {
+            // If 'all' scope, we might already have the key from global
+            // In that case, replace with local (higher priority)
+            if (scope === "all") {
+                const existingIndex = results.findIndex((v) => v.key === key);
+                if (existingIndex !== -1) {
+                    results[existingIndex] = { key, value, source: "local" };
+                }
+                else {
+                    results.push({ key, value, source: "local" });
+                }
+            }
+            else {
+                results.push({ key, value, source: "local" });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Get all environment variables with priority resolution
+ * Returns the effective value for each key (local overrides global)
+ *
+ * @param defaults - Default values for keys
+ * @param cwd - Current working directory for local scope
+ * @returns Map of key to resolution result
+ */
+export function resolveAllEnv(defaults = {}, cwd) {
+    const results = new Map();
+    // Start with defaults
+    for (const [key, value] of Object.entries(defaults)) {
+        results.set(key, { key, value, source: "default" });
+    }
+    // Add global (overrides defaults)
+    const globalVars = loadGlobalEnv();
+    for (const [key, value] of Object.entries(globalVars)) {
+        results.set(key, {
+            key,
+            value,
+            source: "global",
+            filePath: getGlobalEnvPath(),
+        });
+    }
+    // Add local (overrides global and defaults)
+    const localVars = loadLocalEnv(cwd);
+    for (const [key, value] of Object.entries(localVars)) {
+        results.set(key, {
+            key,
+            value,
+            source: "local",
+            filePath: getLocalEnvPath(cwd),
+        });
+    }
+    return results;
+}
+/**
+ * Resolve environment variables for a tool manifest
+ * Checks that all required vars are present
+ *
+ * @param envDeclarations - Env declarations from manifest
+ * @param cwd - Current working directory
+ * @returns Object with resolved vars and any missing required vars
+ */
+export function resolveToolEnv(envDeclarations, cwd) {
+    const resolved = new Map();
+    const missing = [];
+    for (const [key, declaration] of Object.entries(envDeclarations)) {
+        // Skip secrets - they're handled by the keyring
+        if (declaration.secret) {
+            continue;
+        }
+        const result = getEnv(key, declaration.default, cwd);
+        if (result) {
+            resolved.set(key, result);
+        }
+        else {
+            missing.push(key);
+        }
+    }
+    return { resolved, missing };
+}
+/**
+ * Check if local .env exists
+ */
+export function hasLocalEnv(cwd) {
+    return localEnvExists(cwd);
+}
+/**
+ * Check if global .env exists
+ */
+export function hasGlobalEnv() {
+    return globalEnvExists();
+}
+//# sourceMappingURL=manager.js.map

package/dist/env/manager.js.map

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

package/dist/env/parser.d.ts

@@ -0,0 +1,58 @@
+/**
+ * .env file parser
+ *
+ * Parses KEY=VALUE format with support for:
+ * - Comments (lines starting with #)
+ * - Empty lines
+ * - Quoted values (single and double quotes)
+ * - Inline comments
+ * - Values with = signs
+ */
+import type { ParsedEnvFile } from "../types";
+/**
+ * Parse .env file content
+ *
+ * @param content - The file content to parse
+ * @returns Parsed env file with vars and preserved lines
+ */
+export declare function parseEnvFile(content: string): ParsedEnvFile;
+/**
+ * Parse .env file content to simple key-value object
+ *
+ * @param content - The file content to parse
+ * @returns Object with key-value pairs
+ */
+export declare function parseEnvContent(content: string): Record<string, string>;
+/**
+ * Serialize an env file back to string format
+ * Preserves comments and formatting
+ *
+ * @param parsed - The parsed env file
+ * @returns String content for .env file
+ */
+export declare function serializeEnvFile(parsed: ParsedEnvFile): string;
+/**
+ * Create a new env file content from a vars object
+ *
+ * @param vars - Key-value pairs to serialize
+ * @returns String content for .env file
+ */
+export declare function createEnvContent(vars: Record<string, string>): string;
+/**
+ * Update a single variable in parsed env file
+ *
+ * @param parsed - The parsed env file
+ * @param key - The variable key
+ * @param value - The new value
+ * @returns Updated parsed env file
+ */
+export declare function updateEnvVar(parsed: ParsedEnvFile, key: string, value: string): ParsedEnvFile;
+/**
+ * Remove a variable from parsed env file
+ *
+ * @param parsed - The parsed env file
+ * @param key - The variable key to remove
+ * @returns Updated parsed env file
+ */
+export declare function removeEnvVar(parsed: ParsedEnvFile, key: string): ParsedEnvFile;
+//# sourceMappingURL=parser.d.ts.map

package/dist/env/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/env/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,UAAU,CAAC;AAqF3D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAkB3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAc9D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAarE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAoC7F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAU9E"}

package/dist/env/parser.js

@@ -0,0 +1,211 @@
+/**
+ * .env file parser
+ *
+ * Parses KEY=VALUE format with support for:
+ * - Comments (lines starting with #)
+ * - Empty lines
+ * - Quoted values (single and double quotes)
+ * - Inline comments
+ * - Values with = signs
+ */
+/**
+ * Parse a single line from an .env file
+ */
+function parseLine(line) {
+    const trimmed = line.trim();
+    // Empty line
+    if (trimmed === "") {
+        return { type: "empty", raw: line };
+    }
+    // Comment line
+    if (trimmed.startsWith("#")) {
+        return { type: "comment", raw: line };
+    }
+    // Variable line - find the first =
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) {
+        // No = sign, treat as comment (invalid line)
+        return { type: "comment", raw: line };
+    }
+    const key = trimmed.slice(0, eqIndex).trim();
+    let value = trimmed.slice(eqIndex + 1);
+    // Handle inline comments (but not inside quotes)
+    value = parseValue(value);
+    return {
+        type: "variable",
+        raw: line,
+        key,
+        value,
+    };
+}
+/**
+ * Parse a value, handling quotes and inline comments
+ */
+function parseValue(rawValue) {
+    let value = rawValue.trim();
+    // Handle quoted values
+    if (value.length > 1) {
+        const firstChar = value[0];
+        if (firstChar === '"' || firstChar === "'") {
+            const quote = firstChar;
+            // Find the end quote, accounting for escaped quotes
+            let endQuote = -1;
+            for (let i = 1; i < value.length; i++) {
+                if (value[i] === quote && value[i - 1] !== "\\") {
+                    endQuote = i;
+                    break;
+                }
+            }
+            if (endQuote !== -1) {
+                // Extract value between quotes
+                value = value.slice(1, endQuote);
+                // Handle escape sequences in double-quoted strings
+                if (quote === '"') {
+                    value = value
+                        .replace(/\\n/g, "\n")
+                        .replace(/\\r/g, "\r")
+                        .replace(/\\t/g, "\t")
+                        .replace(/\\"/g, '"')
+                        .replace(/\\\\/g, "\\");
+                }
+                return value;
+            }
+        }
+    }
+    // Handle inline comments for unquoted values
+    const commentIndex = value.indexOf(" #");
+    if (commentIndex !== -1) {
+        value = value.slice(0, commentIndex).trim();
+    }
+    return value;
+}
+/**
+ * Parse .env file content
+ *
+ * @param content - The file content to parse
+ * @returns Parsed env file with vars and preserved lines
+ */
+export function parseEnvFile(content) {
+    const lines = content.split("\n");
+    const parsedLines = [];
+    const vars = {};
+    for (const line of lines) {
+        const parsed = parseLine(line);
+        parsedLines.push(parsed);
+        if (parsed.type === "variable" && parsed.key && parsed.value !== undefined) {
+            vars[parsed.key] = parsed.value;
+        }
+    }
+    return {
+        vars,
+        lines: parsedLines,
+    };
+}
+/**
+ * Parse .env file content to simple key-value object
+ *
+ * @param content - The file content to parse
+ * @returns Object with key-value pairs
+ */
+export function parseEnvContent(content) {
+    return parseEnvFile(content).vars;
+}
+/**
+ * Serialize an env file back to string format
+ * Preserves comments and formatting
+ *
+ * @param parsed - The parsed env file
+ * @returns String content for .env file
+ */
+export function serializeEnvFile(parsed) {
+    return parsed.lines
+        .map((line) => {
+        if (line.type === "variable" && line.key) {
+            const value = parsed.vars[line.key] ?? line.value ?? "";
+            // Quote values with spaces or special characters
+            if (value.includes(" ") || value.includes("=") || value.includes("#")) {
+                return `${line.key}="${value.replace(/"/g, '\\"')}"`;
+            }
+            return `${line.key}=${value}`;
+        }
+        return line.raw;
+    })
+        .join("\n");
+}
+/**
+ * Create a new env file content from a vars object
+ *
+ * @param vars - Key-value pairs to serialize
+ * @returns String content for .env file
+ */
+export function createEnvContent(vars) {
+    const lines = [];
+    for (const [key, value] of Object.entries(vars)) {
+        // Quote values with spaces or special characters
+        if (value.includes(" ") || value.includes("=") || value.includes("#")) {
+            lines.push(`${key}="${value.replace(/"/g, '\\"')}"`);
+        }
+        else {
+            lines.push(`${key}=${value}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Update a single variable in parsed env file
+ *
+ * @param parsed - The parsed env file
+ * @param key - The variable key
+ * @param value - The new value
+ * @returns Updated parsed env file
+ */
+export function updateEnvVar(parsed, key, value) {
+    // Update the vars
+    const newVars = { ...parsed.vars, [key]: value };
+    // Check if key exists in lines
+    const existingIndex = parsed.lines.findIndex((line) => line.type === "variable" && line.key === key);
+    let newLines;
+    if (existingIndex !== -1) {
+        // Update existing line
+        newLines = [...parsed.lines];
+        newLines[existingIndex] = {
+            type: "variable",
+            raw: `${key}=${value}`,
+            key,
+            value,
+        };
+    }
+    else {
+        // Add new line at end
+        newLines = [
+            ...parsed.lines,
+            {
+                type: "variable",
+                raw: `${key}=${value}`,
+                key,
+                value,
+            },
+        ];
+    }
+    return {
+        vars: newVars,
+        lines: newLines,
+    };
+}
+/**
+ * Remove a variable from parsed env file
+ *
+ * @param parsed - The parsed env file
+ * @param key - The variable key to remove
+ * @returns Updated parsed env file
+ */
+export function removeEnvVar(parsed, key) {
+    const newVars = { ...parsed.vars };
+    delete newVars[key];
+    const newLines = parsed.lines.filter((line) => !(line.type === "variable" && line.key === key));
+    return {
+        vars: newVars,
+        lines: newLines,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/env/parser.js.map

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

package/dist/env/reader.d.ts

@@ -0,0 +1,61 @@
+/**
+ * .env file reader
+ *
+ * Reads .env files from global (~/.enact/.env) and local (.enact/.env) locations
+ */
+import type { ParsedEnvFile } from "../types";
+/**
+ * Get the path to the global .env file
+ */
+export declare function getGlobalEnvPath(): string;
+/**
+ * Get the path to the local (project) .env file
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export declare function getLocalEnvPath(cwd?: string): string;
+/**
+ * Read and parse an .env file
+ *
+ * @param path - Path to the .env file
+ * @returns Parsed env file, or empty if file doesn't exist
+ */
+export declare function readEnvFile(path: string): ParsedEnvFile;
+/**
+ * Read .env file to simple key-value object
+ *
+ * @param path - Path to the .env file
+ * @returns Object with key-value pairs, empty object if file doesn't exist
+ */
+export declare function readEnvVars(path: string): Record<string, string>;
+/**
+ * Load global environment variables from ~/.enact/.env
+ */
+export declare function loadGlobalEnv(): Record<string, string>;
+/**
+ * Load local (project) environment variables from .enact/.env
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export declare function loadLocalEnv(cwd?: string): Record<string, string>;
+/**
+ * Load global environment as parsed file (for updates)
+ */
+export declare function loadGlobalEnvFile(): ParsedEnvFile;
+/**
+ * Load local environment as parsed file (for updates)
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export declare function loadLocalEnvFile(cwd?: string): ParsedEnvFile;
+/**
+ * Check if global .env file exists
+ */
+export declare function globalEnvExists(): boolean;
+/**
+ * Check if local .env file exists
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export declare function localEnvExists(cwd?: string): boolean;
+//# sourceMappingURL=reader.d.ts.map

package/dist/env/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/env/reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/env/reader.js

@@ -0,0 +1,92 @@
+/**
+ * .env file reader
+ *
+ * Reads .env files from global (~/.enact/.env) and local (.enact/.env) locations
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseEnvContent, parseEnvFile } from "./parser";
+/**
+ * Get the path to the global .env file
+ */
+export function getGlobalEnvPath() {
+    return join(homedir(), ".enact", ".env");
+}
+/**
+ * Get the path to the local (project) .env file
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export function getLocalEnvPath(cwd) {
+    return join(cwd ?? process.cwd(), ".enact", ".env");
+}
+/**
+ * Read and parse an .env file
+ *
+ * @param path - Path to the .env file
+ * @returns Parsed env file, or empty if file doesn't exist
+ */
+export function readEnvFile(path) {
+    if (!existsSync(path)) {
+        return { vars: {}, lines: [] };
+    }
+    const content = readFileSync(path, "utf-8");
+    return parseEnvFile(content);
+}
+/**
+ * Read .env file to simple key-value object
+ *
+ * @param path - Path to the .env file
+ * @returns Object with key-value pairs, empty object if file doesn't exist
+ */
+export function readEnvVars(path) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    const content = readFileSync(path, "utf-8");
+    return parseEnvContent(content);
+}
+/**
+ * Load global environment variables from ~/.enact/.env
+ */
+export function loadGlobalEnv() {
+    return readEnvVars(getGlobalEnvPath());
+}
+/**
+ * Load local (project) environment variables from .enact/.env
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export function loadLocalEnv(cwd) {
+    return readEnvVars(getLocalEnvPath(cwd));
+}
+/**
+ * Load global environment as parsed file (for updates)
+ */
+export function loadGlobalEnvFile() {
+    return readEnvFile(getGlobalEnvPath());
+}
+/**
+ * Load local environment as parsed file (for updates)
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export function loadLocalEnvFile(cwd) {
+    return readEnvFile(getLocalEnvPath(cwd));
+}
+/**
+ * Check if global .env file exists
+ */
+export function globalEnvExists() {
+    return existsSync(getGlobalEnvPath());
+}
+/**
+ * Check if local .env file exists
+ *
+ * @param cwd - Current working directory (defaults to process.cwd())
+ */
+export function localEnvExists(cwd) {
+    return existsSync(getLocalEnvPath(cwd));
+}
+//# sourceMappingURL=reader.js.map

package/dist/env/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/env/reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC"}