episoda 0.2.0

package/dist/hooks/pre-commit

@@ -0,0 +1,139 @@
+#!/bin/bash
+#
+# EP490: Prevent commits directly to main branch
+# EP647: Extended to block ALL non-module branches (except hotfix/*)
+# This hook enforces the module workflow for all development work
+#
+
+BRANCH=$(git branch --show-current)
+
+# Allow module branches (module/EP123-description)
+# EP647: But warn if it's a cloud module being committed locally
+if [[ "$BRANCH" == module/* ]]; then
+  # Extract module UID from branch name (e.g., EP647 from module/EP647-description)
+  MODULE_UID=$(echo "$BRANCH" | grep -oE 'EP[0-9]+')
+
+  if [ -n "$MODULE_UID" ]; then
+    # Check if this is a cloud module
+    # Read config from ~/.episoda/config.json
+    CONFIG_FILE="$HOME/.episoda/config.json"
+
+    if [ -f "$CONFIG_FILE" ]; then
+      # Extract access_token and api_url using node (more reliable than jq which may not be installed)
+      CLOUD_CHECK=$(node -e "
+        const fs = require('fs');
+        const https = require('https');
+        const http = require('http');
+
+        try {
+          const config = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+          const token = config.access_token;
+          const apiUrl = config.api_url || 'https://episoda.dev';
+
+          if (!token) {
+            console.log('SKIP:No token');
+            process.exit(0);
+          }
+
+          const url = new URL('/api/modules/$MODULE_UID', apiUrl);
+          const client = url.protocol === 'https:' ? https : http;
+
+          const req = client.request(url, {
+            method: 'GET',
+            headers: {
+              'Authorization': 'Bearer ' + token,
+              'Content-Type': 'application/json'
+            },
+            timeout: 3000
+          }, (res) => {
+            let data = '';
+            res.on('data', chunk => data += chunk);
+            res.on('end', () => {
+              try {
+                const json = JSON.parse(data);
+                if (json.success && json.moduleRecord && json.moduleRecord.dev_mode === 'cloud') {
+                  console.log('CLOUD:' + json.moduleRecord.title);
+                } else {
+                  console.log('LOCAL');
+                }
+              } catch (e) {
+                console.log('SKIP:Parse error');
+              }
+            });
+          });
+
+          req.on('error', () => console.log('SKIP:Network error'));
+          req.on('timeout', () => { req.destroy(); console.log('SKIP:Timeout'); });
+          req.end();
+        } catch (e) {
+          console.log('SKIP:Config error');
+        }
+      " 2>/dev/null)
+
+      if [[ "$CLOUD_CHECK" == CLOUD:* ]]; then
+        MODULE_TITLE="${CLOUD_CHECK#CLOUD:}"
+        echo ""
+        echo "⚠️  Warning: '$MODULE_UID' is a CLOUD module"
+        echo ""
+        echo "Module: $MODULE_TITLE"
+        echo ""
+        echo "This module is configured for cloud development (dev_mode: cloud)."
+        echo "Local commits may cause sync issues with the cloud environment."
+        echo ""
+        echo "Recommended workflow:"
+        echo "  1. Connect to cloud VM: episoda dev ssh $MODULE_UID"
+        echo "  2. Make changes and commit in the cloud environment"
+        echo ""
+        echo "To bypass this warning:"
+        echo "  git commit --no-verify"
+        echo ""
+        exit 1
+      fi
+    fi
+  fi
+
+  # Module branch is allowed (local module or cloud check skipped/failed)
+  exit 0
+fi
+
+# Allow hotfix branches (hotfix/description) for emergency fixes
+if [[ "$BRANCH" == hotfix/* ]]; then
+  exit 0
+fi
+
+# Block main branch with specific message
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
+  echo ""
+  echo "❌ Cannot commit directly to main branch!"
+  echo ""
+  echo "Please create a module first:"
+  echo "  1. Go to https://episoda.dev/workflow"
+  echo "  2. Create a new module (or select existing)"
+  echo "  3. Move it to 'Doing' state to create a branch"
+  echo "  4. Then switch to the module branch:"
+  echo "     git stash && git checkout module/EP-XXX-... && git stash pop"
+  echo ""
+  echo "To bypass this check (not recommended):"
+  echo "  git commit --no-verify"
+  echo ""
+  exit 1
+fi
+
+# Block all other branches
+echo ""
+echo "❌ Cannot commit on branch '$BRANCH'"
+echo ""
+echo "All work must be done on module branches (module/EP-XXX-...)."
+echo "This ensures proper tracking and code review workflow."
+echo ""
+echo "Options:"
+echo "  1. Create a module at https://episoda.dev/workflow"
+echo "     Move it to 'Doing' to create a branch, then checkout"
+echo ""
+echo "  2. For emergency hotfixes, use a hotfix/* branch:"
+echo "     git checkout -b hotfix/description"
+echo ""
+echo "To bypass this check (not recommended):"
+echo "  git commit --no-verify"
+echo ""
+exit 1

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Episoda CLI
+ *
+ * Local development workflow orchestration for episoda.dev
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Episoda CLI
+ *
+ * Local development workflow orchestration for episoda.dev
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const core_1 = require("./core");
+const dev_1 = require("./commands/dev");
+const auth_1 = require("./commands/auth");
+const status_1 = require("./commands/status");
+const stop_1 = require("./commands/stop");
+const output_1 = require("./output");
+commander_1.program
+    .name('episoda')
+    .description('Episoda local development workflow orchestration')
+    .version(core_1.VERSION);
+// Auth command (K722)
+commander_1.program
+    .command('auth')
+    .description('Authenticate to Episoda via OAuth and configure CLI')
+    .option('--api-url <url>', 'API URL (default: https://episoda.dev)')
+    .action(async (options) => {
+    try {
+        await (0, auth_1.authCommand)(options);
+    }
+    catch (error) {
+        output_1.status.error(`Authentication failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+// Dev command
+commander_1.program
+    .command('dev')
+    .description('Start dev server with Episoda orchestration')
+    .option('--auto-restart', 'Auto-restart dev server if it crashes')
+    .option('--connection-only', 'Connection-only mode (don\'t start dev server)')
+    .allowUnknownOption()
+    .action(async (options, cmd) => {
+    try {
+        // Extract command after 'dev' as the dev server command
+        // e.g., 'episoda dev -- npm run dev' -> ["npm", "run", "dev"]
+        const args = process.argv.slice(process.argv.indexOf('dev') + 1);
+        // Remove '--' separator if present
+        const separatorIndex = args.indexOf('--');
+        const command = separatorIndex >= 0 ? args.slice(separatorIndex + 1) : [];
+        // Filter out our own options
+        const filteredCommand = command.filter(arg => arg !== '--auto-restart' && arg !== '--connection-only');
+        await (0, dev_1.devCommand)({
+            command: options.connectionOnly ? [] : (filteredCommand.length > 0 ? filteredCommand : undefined),
+            autoRestart: options.autoRestart
+        });
+    }
+    catch (error) {
+        output_1.status.error(`Dev command failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+// Status command
+commander_1.program
+    .command('status')
+    .description('Show connection status')
+    .action(async () => {
+    try {
+        await (0, status_1.statusCommand)();
+    }
+    catch (error) {
+        output_1.status.error(`Status check failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+// Stop command (K722)
+commander_1.program
+    .command('stop')
+    .description('Stop the Episoda daemon')
+    .option('--force', 'Force kill daemon without graceful shutdown')
+    .action(async (options) => {
+    try {
+        await (0, stop_1.stopCommand)(options);
+    }
+    catch (error) {
+        output_1.status.error(`Stop failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+// Disconnect command (alias for stop)
+commander_1.program
+    .command('disconnect')
+    .description('Disconnect from episoda.dev (alias for stop)')
+    .action(async () => {
+    try {
+        await (0, stop_1.stopCommand)();
+    }
+    catch (error) {
+        output_1.status.error(`Disconnect failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+commander_1.program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/ipc/ipc-client.d.ts

@@ -0,0 +1,95 @@
+/**
+ * IPC Client - Used by CLI commands
+ *
+ * Sends commands to daemon via Unix domain socket.
+ * Handles request/response communication.
+ *
+ * Socket location: ~/.episoda/daemon.sock
+ */
+export interface IPCRequest {
+    id: string;
+    command: string;
+    params?: any;
+}
+export interface IPCResponse {
+    id: string;
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Send command to daemon
+ *
+ * Connects to daemon socket, sends command, waits for response.
+ *
+ * @param command Command name
+ * @param params Command parameters
+ * @param timeout Timeout in milliseconds (default: 15000)
+ * @returns Response data
+ * @throws Error if daemon not running or command fails
+ */
+export declare function sendCommand(command: string, params?: any, timeout?: number): Promise<any>;
+/**
+ * Check if daemon is reachable via IPC
+ *
+ * @returns true if daemon is running and responding
+ */
+export declare function isDaemonReachable(): Promise<boolean>;
+/**
+ * Add project to daemon
+ *
+ * EP734: Now blocking - waits for WebSocket connection to complete
+ *
+ * @param projectId Supabase project ID
+ * @param projectPath Absolute path to project
+ * @returns Connection result with success/error info
+ */
+export declare function addProject(projectId: string, projectPath: string): Promise<{
+    success: boolean;
+    connected: boolean;
+    error?: string;
+}>;
+/**
+ * Remove project from daemon
+ *
+ * @param projectPath Absolute path to project
+ */
+export declare function removeProject(projectPath: string): Promise<void>;
+/**
+ * Get daemon status
+ *
+ * EP738: Added hostname, platform, arch for status command (HTTP server removed)
+ *
+ * @returns Status information including connected projects and device info
+ */
+export declare function getStatus(): Promise<{
+    running: boolean;
+    machineId: string;
+    deviceId?: string;
+    hostname: string;
+    platform: string;
+    arch: string;
+    projects: Array<{
+        id: string;
+        path: string;
+        name: string;
+        connected: boolean;
+    }>;
+}>;
+/**
+ * Request daemon to connect to a project's WebSocket
+ *
+ * @param projectPath Absolute path to project
+ */
+export declare function connectProject(projectPath: string): Promise<void>;
+/**
+ * Request daemon to disconnect from a project's WebSocket
+ *
+ * @param projectPath Absolute path to project
+ */
+export declare function disconnectProject(projectPath: string): Promise<void>;
+/**
+ * Request daemon shutdown
+ */
+export declare function shutdownDaemon(): Promise<void>;
+//# sourceMappingURL=ipc-client.d.ts.map

package/dist/ipc/ipc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-client.d.ts","sourceRoot":"","sources":["../../src/ipc/ipc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,GAAG,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,GAAE,MAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,CA2Ed;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAChF,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAC,CAGD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,OAAO,CAAA;KACnB,CAAC,CAAA;CACH,CAAC,CAED;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD"}

package/dist/ipc/ipc-client.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * IPC Client - Used by CLI commands
+ *
+ * Sends commands to daemon via Unix domain socket.
+ * Handles request/response communication.
+ *
+ * Socket location: ~/.episoda/daemon.sock
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendCommand = sendCommand;
+exports.isDaemonReachable = isDaemonReachable;
+exports.addProject = addProject;
+exports.removeProject = removeProject;
+exports.getStatus = getStatus;
+exports.connectProject = connectProject;
+exports.disconnectProject = disconnectProject;
+exports.shutdownDaemon = shutdownDaemon;
+const net = __importStar(require("net"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const core_1 = require("../core");
+const getSocketPath = () => path.join((0, core_1.getConfigDir)(), 'daemon.sock');
+const DEFAULT_TIMEOUT = 15000; // 15 seconds (EP606: increased for device registration)
+/**
+ * Send command to daemon
+ *
+ * Connects to daemon socket, sends command, waits for response.
+ *
+ * @param command Command name
+ * @param params Command parameters
+ * @param timeout Timeout in milliseconds (default: 15000)
+ * @returns Response data
+ * @throws Error if daemon not running or command fails
+ */
+async function sendCommand(command, params, timeout = DEFAULT_TIMEOUT) {
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection(getSocketPath());
+        const requestId = crypto.randomUUID();
+        let buffer = '';
+        let timeoutHandle;
+        // Set timeout
+        timeoutHandle = setTimeout(() => {
+            socket.destroy();
+            reject(new Error(`Command timed out after ${timeout}ms`));
+        }, timeout);
+        socket.on('connect', () => {
+            // Send request
+            const request = {
+                id: requestId,
+                command,
+                params,
+            };
+            socket.write(JSON.stringify(request) + '\n');
+        });
+        socket.on('data', (chunk) => {
+            buffer += chunk.toString();
+            // Check for complete response (delimited by newline)
+            const newlineIndex = buffer.indexOf('\n');
+            if (newlineIndex === -1)
+                return;
+            // Extract response
+            const message = buffer.slice(0, newlineIndex);
+            try {
+                const response = JSON.parse(message);
+                // Verify response ID matches
+                if (response.id !== requestId) {
+                    reject(new Error('Response ID mismatch'));
+                    return;
+                }
+                clearTimeout(timeoutHandle);
+                socket.end();
+                if (response.success) {
+                    resolve(response.data);
+                }
+                else {
+                    reject(new Error(response.error || 'Command failed'));
+                }
+            }
+            catch (error) {
+                clearTimeout(timeoutHandle);
+                socket.end();
+                reject(new Error('Invalid response from daemon'));
+            }
+        });
+        socket.on('error', (error) => {
+            clearTimeout(timeoutHandle);
+            // Check for common errors
+            if (error.code === 'ENOENT' || error.code === 'ECONNREFUSED') {
+                reject(new Error('Daemon is not running. Start it with: episoda dev'));
+            }
+            else {
+                reject(error);
+            }
+        });
+        socket.on('timeout', () => {
+            clearTimeout(timeoutHandle);
+            socket.destroy();
+            reject(new Error('Connection timeout'));
+        });
+    });
+}
+/**
+ * Check if daemon is reachable via IPC
+ *
+ * @returns true if daemon is running and responding
+ */
+async function isDaemonReachable() {
+    try {
+        await sendCommand('ping', {}, 1000);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Add project to daemon
+ *
+ * EP734: Now blocking - waits for WebSocket connection to complete
+ *
+ * @param projectId Supabase project ID
+ * @param projectPath Absolute path to project
+ * @returns Connection result with success/error info
+ */
+async function addProject(projectId, projectPath) {
+    // EP734: Increased timeout to 30s to allow for WebSocket connection
+    return await sendCommand('add-project', { projectId, projectPath }, 30000);
+}
+/**
+ * Remove project from daemon
+ *
+ * @param projectPath Absolute path to project
+ */
+async function removeProject(projectPath) {
+    await sendCommand('remove-project', { projectPath });
+}
+/**
+ * Get daemon status
+ *
+ * EP738: Added hostname, platform, arch for status command (HTTP server removed)
+ *
+ * @returns Status information including connected projects and device info
+ */
+async function getStatus() {
+    return await sendCommand('status');
+}
+/**
+ * Request daemon to connect to a project's WebSocket
+ *
+ * @param projectPath Absolute path to project
+ */
+async function connectProject(projectPath) {
+    await sendCommand('connect-project', { projectPath });
+}
+/**
+ * Request daemon to disconnect from a project's WebSocket
+ *
+ * @param projectPath Absolute path to project
+ */
+async function disconnectProject(projectPath) {
+    await sendCommand('disconnect-project', { projectPath });
+}
+/**
+ * Request daemon shutdown
+ */
+async function shutdownDaemon() {
+    await sendCommand('shutdown', {}, 2000);
+}
+// EP734: Removed getConnectionStatus - no longer needed with blocking add-project
+//# sourceMappingURL=ipc-client.js.map

package/dist/ipc/ipc-client.js.map

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

package/dist/ipc/ipc-server.d.ts

@@ -0,0 +1,55 @@
+/**
+ * IPC Server - Runs in daemon process
+ *
+ * Listens for commands from CLI via Unix domain socket.
+ * Handles command routing and response sending.
+ *
+ * Socket location: ~/.episoda/daemon.sock
+ */
+export interface IPCRequest {
+    id: string;
+    command: string;
+    params?: any;
+}
+export interface IPCResponse {
+    id: string;
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+export type CommandHandler = (params: any) => Promise<any>;
+/**
+ * IPC Server
+ *
+ * Listens on Unix socket for CLI commands.
+ */
+export declare class IPCServer {
+    private server;
+    private handlers;
+    /**
+     * Register a command handler
+     *
+     * @param command Command name
+     * @param handler Async function to handle command
+     */
+    on(command: string, handler: CommandHandler): void;
+    /**
+     * Start the IPC server
+     *
+     * Creates Unix socket and listens for connections.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the IPC server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle incoming client connection
+     */
+    private handleConnection;
+    /**
+     * Handle IPC request
+     */
+    private handleRequest;
+}
+//# sourceMappingURL=ipc-server.d.ts.map

package/dist/ipc/ipc-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-server.d.ts","sourceRoot":"","sources":["../../src/ipc/ipc-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,GAAG,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;AAE1D;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAIlD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;YACW,aAAa;CA0B5B"}