@soederpop/luca 0.1.2 → 0.1.3

package/dist/node/features/git.d.ts

@@ -0,0 +1,329 @@
+import { z } from 'zod';
+import { State } from '../../state.js';
+import { Feature } from '../feature.js';
+type LsFilesOptions = {
+    cached?: boolean;
+    deleted?: boolean;
+    modified?: boolean;
+    others?: boolean;
+    ignored?: boolean;
+    status?: boolean;
+    includeIgnored?: boolean;
+    exclude?: string | string[];
+    baseDir?: string;
+};
+declare const GitStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    repoRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type GitState = z.infer<typeof GitStateSchema>;
+/**
+ * The Git feature provides utilities for interacting with Git repositories.
+ *
+ * This feature allows you to check repository status, list files, get branch information,
+ * and access Git metadata for projects within a Git repository.
+ *
+ * @example
+ * ```typescript
+ * const git = container.feature('git')
+ *
+ * if (git.isRepo) {
+ *   console.log(`Current branch: ${git.branch}`)
+ *   console.log(`Repository root: ${git.repoRoot}`)
+ *
+ *   const allFiles = await git.lsFiles()
+ *   const modifiedFiles = await git.lsFiles({ modified: true })
+ * }
+ * ```
+ *
+ * @extends Feature
+ */
+export declare class Git extends Feature {
+    static shortcut: "features.git";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        repoRoot: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    state: State<GitState>;
+    private _resolvedGitPath;
+    /** Resolve the git binary path via `which`, caching the result. */
+    get gitPath(): string;
+    /**
+     * Lists files in the Git repository using git ls-files command.
+     *
+     * This method provides a flexible interface to the git ls-files command,
+     * allowing you to filter files by various criteria such as cached, deleted,
+     * modified, untracked, and ignored files.
+     *
+     * @param {LsFilesOptions} [options={}] - Options to control which files are listed
+     * @param {boolean} [options.cached=false] - Show cached/staged files
+     * @param {boolean} [options.deleted=false] - Show deleted files
+     * @param {boolean} [options.modified=false] - Show modified files
+     * @param {boolean} [options.others=false] - Show untracked files
+     * @param {boolean} [options.ignored=false] - Show ignored files
+     * @param {boolean} [options.status=false] - Show file status information
+     * @param {boolean} [options.includeIgnored=false] - Include ignored files when showing others
+     * @param {string | string[]} [options.exclude] - Patterns to exclude from results
+     * @param {string} [options.baseDir=''] - Base directory to list files from
+     * @returns {Promise<string[]>} Promise that resolves to an array of file paths
+     *
+     * @example
+     * ```typescript
+     * // Get all tracked files
+     * const allFiles = await git.lsFiles()
+     *
+     * // Get only modified files
+     * const modified = await git.lsFiles({ modified: true })
+     *
+     * // Get untracked files excluding certain patterns
+     * const untracked = await git.lsFiles({
+     *   others: true,
+     *   exclude: ['*.log', 'node_modules']
+     * })
+     * ```
+     */
+    lsFiles(options?: LsFilesOptions): Promise<string[]>;
+    /**
+     * Gets the current Git branch name.
+     *
+     * @returns {string | null} The current branch name, or null if not in a Git repository
+     *
+     * @example
+     * ```typescript
+     * const currentBranch = git.branch
+     * if (currentBranch) {
+     *   console.log(`Currently on branch: ${currentBranch}`)
+     * }
+     * ```
+     */
+    get branch(): string | null;
+    /**
+     * Gets the current Git commit SHA hash.
+     *
+     * @returns {string | null} The current commit SHA, or null if not in a Git repository
+     *
+     * @example
+     * ```typescript
+     * const commitSha = git.sha
+     * if (commitSha) {
+     *   console.log(`Current commit: ${commitSha}`)
+     * }
+     * ```
+     */
+    get sha(): string | null;
+    /**
+     * Checks if the current directory is within a Git repository.
+     *
+     * @returns {boolean} True if currently in a Git repository, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (git.isRepo) {
+     *   console.log('This is a Git repository!')
+     * } else {
+     *   console.log('Not in a Git repository')
+     * }
+     * ```
+     */
+    get isRepo(): boolean;
+    /**
+     * Checks if the current working directory is the root of the Git repository.
+     *
+     * @returns {boolean} True if currently at the repository root, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (git.isRepoRoot) {
+     *   console.log('At the repository root')
+     * } else {
+     *   console.log('In a subdirectory of the repository')
+     * }
+     * ```
+     */
+    get isRepoRoot(): boolean;
+    /**
+     * Gets the absolute path to the Git repository root directory.
+     *
+     * This method caches the repository root path for performance. It searches upward
+     * from the current directory to find the .git directory.
+     *
+     * @returns {string | null} The absolute path to the repository root, or null if not in a Git repository
+     *
+     * @example
+     * ```typescript
+     * const repoRoot = git.repoRoot
+     * if (repoRoot) {
+     *   console.log(`Repository root: ${repoRoot}`)
+     * }
+     * ```
+     */
+    get repoRoot(): string | null;
+    /**
+     * Gets the latest commits from the repository.
+     *
+     * Returns an array of commit objects containing the title (first line of commit message),
+     * full message body, and author name for each commit.
+     *
+     * @param {number} [numberOfChanges=10] - The number of recent commits to return
+     * @returns {Promise<Array<{ title: string, message: string, author: string }>>} Array of commit objects
+     *
+     * @example
+     * ```typescript
+     * const changes = await git.getLatestChanges(5)
+     * for (const commit of changes) {
+     *   console.log(`${commit.author}: ${commit.title}`)
+     * }
+     * ```
+     */
+    getLatestChanges(numberOfChanges?: number): Promise<Array<{
+        title: string;
+        message: string;
+        author: string;
+    }>>;
+    /**
+     * Gets a lightweight commit log for one or more files.
+     *
+     * Returns the SHA and message for each commit that touched the given files,
+     * without the per-commit overhead of resolving which specific files matched.
+     * For richer per-file matching, see {@link getChangeHistoryForFiles}.
+     *
+     * @param {...string} files - File paths (absolute or relative to container.cwd)
+     * @returns {Array<{ sha: string, message: string }>} Array of commits
+     *
+     * @example
+     * ```typescript
+     * const log = git.fileLog('package.json')
+     * const log = git.fileLog('src/index.ts', 'src/helper.ts')
+     * for (const entry of log) {
+     *   console.log(`${entry.sha.slice(0, 8)} ${entry.message}`)
+     * }
+     * ```
+     */
+    fileLog(...files: string[]): Array<{
+        sha: string;
+        message: string;
+    }>;
+    /**
+     * Gets the diff for a file between two refs.
+     *
+     * By default compares from the current HEAD to the given ref. You can
+     * supply both `compareTo` and `compareFrom` to diff between any two commits,
+     * branches, or tags.
+     *
+     * @param {string} file - File path (absolute or relative to container.cwd)
+     * @param {string} compareTo - The target ref (commit SHA, branch, tag) to compare to
+     * @param {string} [compareFrom] - The base ref to compare from (defaults to current HEAD)
+     * @returns {string} The diff output, or an empty string if there are no changes
+     *
+     * @example
+     * ```typescript
+     * // Diff package.json between HEAD and a specific commit
+     * const d = git.diff('package.json', 'abc1234')
+     *
+     * // Diff between two branches
+     * const d = git.diff('src/index.ts', 'feature-branch', 'main')
+     * ```
+     */
+    diff(file: string, compareTo: string, compareFrom?: string): string;
+    /**
+     * Pretty prints a unified diff string to the terminal using colors.
+     *
+     * Parses the diff output and applies color coding:
+     * - File headers (`diff --git`, `---`, `+++`) are rendered bold
+     * - Hunk headers (`@@ ... @@`) are rendered in cyan
+     * - Added lines (`+`) are rendered in green
+     * - Removed lines (`-`) are rendered in red
+     * - Context lines are rendered dim
+     *
+     * Can be called with a raw diff string, or with the same arguments as
+     * {@link diff} to fetch and display in one step.
+     *
+     * @param diffOrFile - A raw diff string, or a file path to pass to {@link diff}
+     * @param compareTo - When diffOrFile is a file path, the target ref to compare to
+     * @param compareFrom - When diffOrFile is a file path, the base ref to compare from
+     * @returns The colorized diff string (also prints to stdout)
+     *
+     * @example
+     * ```typescript
+     * // Display a pre-fetched diff
+     * const raw = git.diff('src/index.ts', 'main')
+     * git.displayDiff(raw)
+     *
+     * // Fetch and display in one call
+     * git.displayDiff('src/index.ts', 'abc1234')
+     * ```
+     */
+    displayDiff(diffOrFile: string, compareTo?: string, compareFrom?: string): string;
+    /**
+     * Extracts a folder (or entire repo) from a remote GitHub repository without cloning.
+     *
+     * Downloads the repo as a tarball and extracts only the specified subfolder,
+     * similar to how degit works. No .git history is included — just the files.
+     *
+     * Supports shorthand (`user/repo/path`), branch refs (`user/repo/path#branch`),
+     * and full GitHub URLs (`https://github.com/user/repo/tree/branch/path`).
+     *
+     * @param {object} options
+     * @param {string} options.source - Repository source in degit-style shorthand
+     * @param {string} options.destination - Local path to extract files into
+     * @param {string} [options.branch] - Branch, tag, or commit ref (overrides ref in source string)
+     * @returns {Promise<{ files: string[], source: { user: string, repo: string, ref: string, subdir: string } }>}
+     *
+     * @example
+     * ```typescript
+     * // Extract a subfolder
+     * await git.extractFolder({ source: 'soederpop/luca/src/assistants', destination: './my-assistants' })
+     *
+     * // Specific branch
+     * await git.extractFolder({ source: 'sveltejs/template', destination: './my-app', branch: 'main' })
+     *
+     * // Full GitHub URL
+     * await git.extractFolder({ source: 'https://github.com/user/repo/tree/main/examples', destination: './examples' })
+     * ```
+     */
+    extractFolder({ source, destination, branch }: {
+        source: string;
+        destination: string;
+        branch?: string;
+    }): Promise<{
+        files: string[];
+        source: {
+            user: string | undefined;
+            repo: string | undefined;
+            ref: string | undefined;
+            subdir: string;
+        };
+    }>;
+    /** Parses degit-style source strings into components. */
+    private _parseRemoteSource;
+    /**
+     * Gets the commit history for a set of files or glob patterns.
+     *
+     * Accepts absolute paths, relative paths (resolved from container.cwd),
+     * or glob patterns. Returns commits that touched any of the matched files,
+     * with each entry noting which of your queried files were in that commit.
+     *
+     * @param {...string} paths - File paths or glob patterns to get history for
+     * @returns {Array<{ sha: string, message: string, longMessage: string, filesMatched: string[] }>}
+     *
+     * @example
+     * ```typescript
+     * const history = git.getChangeHistoryForFiles('src/container.ts', 'src/helper.ts')
+     * const history = git.getChangeHistoryForFiles('src/node/features/*.ts')
+     * ```
+     */
+    getChangeHistoryForFiles(...paths: string[]): Array<{
+        sha: string;
+        message: string;
+        longMessage: string;
+        filesMatched: string[];
+    }>;
+}
+export default Git;
+//# sourceMappingURL=git.d.ts.map

package/dist/node/features/git.d.ts.map

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

package/dist/node/features/google-auth.d.ts

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import { google } from 'googleapis';
+import type { OAuth2Client } from 'google-auth-library';
+export declare const GoogleAuthStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    authMode: z.ZodDefault<z.ZodEnum<{
+        oauth2: "oauth2";
+        "service-account": "service-account";
+        none: "none";
+    }>>;
+    isAuthenticated: z.ZodDefault<z.ZodBoolean>;
+    email: z.ZodOptional<z.ZodString>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tokenExpiry: z.ZodOptional<z.ZodString>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GoogleAuthState = z.infer<typeof GoogleAuthStateSchema>;
+export declare const GoogleAuthOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        oauth2: "oauth2";
+        "service-account": "service-account";
+    }>>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    serviceAccountKeyPath: z.ZodOptional<z.ZodString>;
+    serviceAccountKey: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    redirectPort: z.ZodOptional<z.ZodNumber>;
+    tokenCacheKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GoogleAuthOptions = z.infer<typeof GoogleAuthOptionsSchema>;
+export declare const GoogleAuthEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    authenticated: z.ZodTuple<[z.ZodObject<{
+        mode: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], null>;
+    tokenRefreshed: z.ZodTuple<[], null>;
+    authorizationRequired: z.ZodTuple<[z.ZodString], null>;
+    error: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+/**
+ * Google authentication feature supporting OAuth2 browser flow and service account auth.
+ *
+ * Handles the complete OAuth2 lifecycle: authorization URL generation, local callback server,
+ * token exchange, refresh token storage (via diskCache), and automatic token refresh.
+ * Also supports non-interactive service account authentication via JSON key files.
+ *
+ * Other Google features (drive, sheets, calendar, docs) depend on this feature
+ * and access it lazily via `container.feature('googleAuth')`.
+ *
+ * @example
+ * ```typescript
+ * // OAuth2 flow — opens browser for consent
+ * const auth = container.feature('googleAuth', {
+ *   clientId: 'your-client-id.apps.googleusercontent.com',
+ *   clientSecret: 'your-secret',
+ *   scopes: ['https://www.googleapis.com/auth/drive.readonly'],
+ * })
+ * await auth.authorize()
+ *
+ * // Service account flow — no browser needed
+ * const auth = container.feature('googleAuth', {
+ *   serviceAccountKeyPath: '/path/to/key.json',
+ *   scopes: ['https://www.googleapis.com/auth/spreadsheets.readonly'],
+ * })
+ * await auth.authenticateServiceAccount()
+ * ```
+ */
+export declare class GoogleAuth extends Feature<GoogleAuthState, GoogleAuthOptions> {
+    static shortcut: "features.googleAuth";
+    static envVars: string[];
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        authMode: z.ZodDefault<z.ZodEnum<{
+            oauth2: "oauth2";
+            "service-account": "service-account";
+            none: "none";
+        }>>;
+        isAuthenticated: z.ZodDefault<z.ZodBoolean>;
+        email: z.ZodOptional<z.ZodString>;
+        scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        tokenExpiry: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            oauth2: "oauth2";
+            "service-account": "service-account";
+        }>>;
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+        serviceAccountKeyPath: z.ZodOptional<z.ZodString>;
+        serviceAccountKey: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        redirectPort: z.ZodOptional<z.ZodNumber>;
+        tokenCacheKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        authenticated: z.ZodTuple<[z.ZodObject<{
+            mode: z.ZodString;
+            email: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], null>;
+        tokenRefreshed: z.ZodTuple<[], null>;
+        authorizationRequired: z.ZodTuple<[z.ZodString], null>;
+        error: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _oauth2Client?;
+    private _redirectUri?;
+    get initialState(): GoogleAuthState;
+    /** OAuth2 client ID from options or GOOGLE_CLIENT_ID env var. */
+    get clientId(): string;
+    /** OAuth2 client secret from options or GOOGLE_CLIENT_SECRET env var. */
+    get clientSecret(): string;
+    /** Resolved authentication mode based on options. */
+    get authMode(): 'oauth2' | 'service-account';
+    /** Whether valid credentials are currently available. */
+    get isAuthenticated(): boolean;
+    /** Default scopes covering Drive, Sheets, Calendar, and Docs read access. */
+    get defaultScopes(): string[];
+    /** Resolved redirect port from options, GOOGLE_OAUTH_REDIRECT_PORT env var, or default 3000. */
+    get redirectPort(): number;
+    /** DiskCache key used for storing the refresh token. */
+    get tokenCacheKey(): string;
+    /**
+     * Get the OAuth2Client instance, creating it lazily.
+     * After authentication, this client has valid credentials set.
+     *
+     * @returns The OAuth2Client instance
+     */
+    getOAuth2Client(): OAuth2Client;
+    /**
+     * Get the authenticated auth client for passing to googleapis service constructors.
+     * Handles token refresh automatically for OAuth2. For service accounts, returns
+     * the JWT auth client.
+     *
+     * @returns An auth client suitable for `google.drive({ version: 'v3', auth })`
+     */
+    getAuthClient(): Promise<OAuth2Client | ReturnType<typeof google.auth.fromJSON>>;
+    /**
+     * Start the OAuth2 authorization flow.
+     *
+     * 1. Spins up a temporary Express callback server on a free port
+     * 2. Generates the Google authorization URL
+     * 3. Opens the browser to the consent page
+     * 4. Waits for the callback with the authorization code
+     * 5. Exchanges the code for access + refresh tokens
+     * 6. Stores the refresh token in diskCache
+     * 7. Shuts down the callback server
+     *
+     * @param scopes - OAuth2 scopes to request (defaults to options.scopes or defaultScopes)
+     */
+    authorize(scopes?: string[]): Promise<this>;
+    /**
+     * Authenticate using a service account JSON key file.
+     * Reads the key from options.serviceAccountKeyPath, options.serviceAccountKey,
+     * or the GOOGLE_SERVICE_ACCOUNT_KEY env var.
+     *
+     * @returns This feature instance for chaining
+     */
+    authenticateServiceAccount(): Promise<this>;
+    /**
+     * Attempt to restore authentication from a cached refresh token.
+     * Called automatically by getAuthClient() if not yet authenticated.
+     *
+     * @returns true if tokens were restored successfully
+     */
+    tryRestoreTokens(): Promise<boolean>;
+    /**
+     * Revoke the current credentials and clear cached tokens.
+     *
+     * @returns This feature instance for chaining
+     */
+    revoke(): Promise<this>;
+    /** Store a refresh token in diskCache. */
+    private storeRefreshToken;
+    /** Load a refresh token from diskCache. */
+    private loadRefreshToken;
+    /** Resolve the service account key from options or env var. */
+    private getServiceAccountKey;
+}
+declare module '../../feature' {
+    interface AvailableFeatures {
+        googleAuth: typeof GoogleAuth;
+    }
+}
+export default GoogleAuth;
+//# sourceMappingURL=google-auth.d.ts.map

package/dist/node/features/google-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-auth.d.ts","sourceRoot":"","sources":["../../../src/node/features/google-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAahC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;iBAiBlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,sBAAsB;;;;;;;;;;iBASjC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,UAAW,SAAQ,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC;IACzE,OAAgB,QAAQ,EAAG,qBAAqB,CAAS;IACzD,OAAgB,OAAO,WAKtB;IACD,OAAgB,WAAW;;;;;;;;;;;;sBAAwB;IACnD,OAAgB,aAAa;;;;;;;;;;;;;;;;sBAA0B;IACvD,OAAgB,YAAY;;;;;;;;;;sBAAyB;IAGrD,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,YAAY,CAAC,CAAQ;IAE7B,IAAa,YAAY,IAAI,eAAe,CAO3C;IAED,iEAAiE;IACjE,IAAI,QAAQ,IAAI,MAAM,CAIrB;IAED,yEAAyE;IACzE,IAAI,YAAY,IAAI,MAAM,CAIzB;IAED,qDAAqD;IACrD,IAAI,QAAQ,IAAI,QAAQ,GAAG,iBAAiB,CAM3C;IAED,yDAAyD;IACzD,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,MAAM,EAAE,CAQ5B;IAED,gGAAgG;IAChG,IAAI,YAAY,IAAI,MAAM,CAIzB;IAED,wDAAwD;IACxD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,eAAe,IAAI,YAAY;IAQ/B;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAsCtF;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkHjD;;;;;;OAMG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjD;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IA4C1C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7B,0CAA0C;YAC5B,iBAAiB;IAK/B,2CAA2C;YAC7B,gBAAgB;IAW9B,+DAA+D;IAC/D,OAAO,CAAC,oBAAoB;CAW7B;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,iBAAiB;QACzB,UAAU,EAAE,OAAO,UAAU,CAAA;KAC9B;CACF;AAED,eAAe,UAAU,CAAA"}