@hypercli/gen 0.1.1

package/dist/actions/communication.js

@@ -0,0 +1,515 @@
+/**
+ * Cross-Action Communication System
+ *
+ * Enables actions to communicate with each other and share state
+ * during execution workflows
+ */
+import { EventEmitter } from "node:events";
+import { ErrorCode, ErrorHandler } from "@hypercli/core";
+import createDebug from "debug";
+const debug = createDebug("hyper:communication");
+export class ActionCommunicationManager extends EventEmitter {
+    store;
+    config;
+    messageCorrelations = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = {
+            maxMessageHistory: config.maxMessageHistory || 1000,
+            maxStateHistory: config.maxStateHistory || 100,
+            enablePersistence: config.enablePersistence || false,
+            stateStorePath: config.stateStorePath,
+            channels: config.channels || [],
+        };
+        this.store = {
+            actionStates: new Map(),
+            sharedData: new Map(),
+            channels: new Map(),
+            eventHistory: [],
+        };
+        this.initializeChannels();
+        debug("Communication manager initialized with %d channels", this.store.channels.size);
+    }
+    /**
+     * Register an action and create its initial state
+     */
+    registerAction(actionId, actionName, initialData = {}) {
+        debug("Registering action: %s (%s)", actionId, actionName);
+        const state = {
+            id: actionId,
+            action: actionName,
+            status: "running",
+            data: { ...initialData },
+            metadata: {
+                startTime: new Date(),
+                filesCreated: [],
+                errors: [],
+            },
+        };
+        this.store.actionStates.set(actionId, state);
+        this.emit("action:registered", { actionId, actionName, state });
+        // Broadcast action start event
+        this.sendMessage({
+            id: this.generateMessageId(),
+            source: actionId,
+            type: "action:started",
+            payload: { actionName, initialData },
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Update action state
+     */
+    updateActionState(actionId, updates, status) {
+        const state = this.store.actionStates.get(actionId);
+        if (!state) {
+            throw ErrorHandler.createError(ErrorCode.ACTION_NOT_FOUND, `Action state not found: ${actionId}`, { action: actionId });
+        }
+        debug("Updating action state: %s", actionId);
+        // Update data
+        Object.assign(state.data, updates);
+        // Update status if provided
+        if (status) {
+            state.status = status;
+            if (status === "completed" || status === "failed") {
+                state.metadata.endTime = new Date();
+                state.metadata.duration =
+                    state.metadata.endTime.getTime() - state.metadata.startTime.getTime();
+            }
+        }
+        this.emit("action:state-updated", { actionId, updates, status, state });
+        // Broadcast state change
+        this.sendMessage({
+            id: this.generateMessageId(),
+            source: actionId,
+            type: "action:state-changed",
+            payload: { updates, status },
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Complete an action
+     */
+    completeAction(actionId, result) {
+        debug("Completing action: %s", actionId);
+        const state = this.store.actionStates.get(actionId);
+        if (!state) {
+            throw ErrorHandler.createError(ErrorCode.ACTION_NOT_FOUND, `Action state not found: ${actionId}`, { action: actionId });
+        }
+        state.status = "completed";
+        state.metadata.endTime = new Date();
+        state.metadata.duration = state.metadata.endTime.getTime() - state.metadata.startTime.getTime();
+        if (result.filesCreated) {
+            state.metadata.filesCreated = result.filesCreated;
+        }
+        this.emit("action:completed", { actionId, result, state });
+        // Broadcast completion
+        this.sendMessage({
+            id: this.generateMessageId(),
+            source: actionId,
+            type: "action:completed",
+            payload: result,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Fail an action
+     */
+    failAction(actionId, error) {
+        debug("Failing action: %s", actionId);
+        const state = this.store.actionStates.get(actionId);
+        if (!state) {
+            throw ErrorHandler.createError(ErrorCode.ACTION_NOT_FOUND, `Action state not found: ${actionId}`, { action: actionId });
+        }
+        const errorMessage = error instanceof Error ? error.message : error;
+        state.status = "failed";
+        state.metadata.endTime = new Date();
+        state.metadata.duration = state.metadata.endTime.getTime() - state.metadata.startTime.getTime();
+        state.metadata.errors = state.metadata.errors || [];
+        state.metadata.errors.push(errorMessage);
+        this.emit("action:failed", { actionId, error: errorMessage, state });
+        // Broadcast failure
+        this.sendMessage({
+            id: this.generateMessageId(),
+            source: actionId,
+            type: "action:failed",
+            payload: { error: errorMessage },
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Send a message between actions
+     */
+    sendMessage(message) {
+        const fullMessage = {
+            id: message.id || this.generateMessageId(),
+            source: message.source,
+            target: message.target,
+            type: message.type,
+            payload: message.payload,
+            timestamp: message.timestamp || new Date(),
+            correlationId: message.correlationId,
+        };
+        debug("Sending message: %s -> %s [%s]", fullMessage.source, fullMessage.target || "broadcast", fullMessage.type);
+        // Add to history
+        this.store.eventHistory.push(fullMessage);
+        this.trimEventHistory();
+        // Route message to appropriate channels
+        this.routeMessage(fullMessage);
+        // Emit to listeners
+        this.emit("message", fullMessage);
+        this.emit(`message:${fullMessage.type}`, fullMessage);
+        // Handle correlation tracking
+        if (fullMessage.correlationId) {
+            this.trackCorrelation(fullMessage);
+        }
+    }
+    /**
+     * Subscribe to messages for a specific action
+     */
+    subscribeToMessages(actionId, messageType, handler) {
+        debug("Action %s subscribing to messages: %s", actionId, messageType);
+        const eventName = `message:${messageType}`;
+        const wrappedHandler = (message) => {
+            // Only deliver to target or broadcast messages
+            if (!message.target || message.target === actionId) {
+                handler(message);
+            }
+        };
+        this.on(eventName, wrappedHandler);
+        // Return unsubscribe function
+        return () => {
+            this.off(eventName, wrappedHandler);
+            debug("Action %s unsubscribed from messages: %s", actionId, messageType);
+        };
+    }
+    /**
+     * Set shared data that can be accessed by other actions
+     */
+    setSharedData(key, value, source) {
+        debug("Setting shared data: %s", key);
+        this.store.sharedData.set(key, value);
+        this.emit("shared-data:set", { key, value, source });
+        // Broadcast shared data change
+        this.sendMessage({
+            id: this.generateMessageId(),
+            source: source || "system",
+            type: "shared-data:changed",
+            payload: { key, value },
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Get shared data
+     */
+    getSharedData(key) {
+        return this.store.sharedData.get(key);
+    }
+    /**
+     * Get all shared data
+     */
+    getAllSharedData() {
+        return Object.fromEntries(this.store.sharedData);
+    }
+    /**
+     * Delete shared data
+     */
+    deleteSharedData(key, source) {
+        debug("Deleting shared data: %s", key);
+        const deleted = this.store.sharedData.delete(key);
+        if (deleted) {
+            this.emit("shared-data:deleted", { key, source });
+            // Broadcast shared data deletion
+            this.sendMessage({
+                id: this.generateMessageId(),
+                source: source || "system",
+                type: "shared-data:deleted",
+                payload: { key },
+                timestamp: new Date(),
+            });
+        }
+        return deleted;
+    }
+    /**
+     * Get action state
+     */
+    getActionState(actionId) {
+        return this.store.actionStates.get(actionId);
+    }
+    /**
+     * Get all action states
+     */
+    getAllActionStates() {
+        return Array.from(this.store.actionStates.values());
+    }
+    /**
+     * Get actions by status
+     */
+    getActionsByStatus(status) {
+        return Array.from(this.store.actionStates.values()).filter((state) => state.status === status);
+    }
+    /**
+     * Wait for an action to complete
+     */
+    waitForAction(actionId, timeout) {
+        return new Promise((resolve, reject) => {
+            const state = this.store.actionStates.get(actionId);
+            if (!state) {
+                reject(new Error(`Action not found: ${actionId}`));
+                return;
+            }
+            // If already completed, resolve immediately
+            if (state.status === "completed" || state.status === "failed") {
+                resolve(state);
+                return;
+            }
+            let timeoutId;
+            const handleStateUpdate = (event) => {
+                if (event.actionId === actionId &&
+                    (event.state.status === "completed" || event.state.status === "failed")) {
+                    if (timeoutId)
+                        clearTimeout(timeoutId);
+                    this.off("action:state-updated", handleStateUpdate);
+                    this.off("action:completed", handleCompleted);
+                    this.off("action:failed", handleFailed);
+                    resolve(event.state);
+                }
+            };
+            const handleCompleted = (event) => {
+                if (event.actionId === actionId) {
+                    if (timeoutId)
+                        clearTimeout(timeoutId);
+                    this.off("action:state-updated", handleStateUpdate);
+                    this.off("action:completed", handleCompleted);
+                    this.off("action:failed", handleFailed);
+                    resolve(event.state);
+                }
+            };
+            const handleFailed = (event) => {
+                if (event.actionId === actionId) {
+                    if (timeoutId)
+                        clearTimeout(timeoutId);
+                    this.off("action:state-updated", handleStateUpdate);
+                    this.off("action:completed", handleCompleted);
+                    this.off("action:failed", handleFailed);
+                    resolve(event.state); // Resolve with failed state
+                }
+            };
+            this.on("action:state-updated", handleStateUpdate);
+            this.on("action:completed", handleCompleted);
+            this.on("action:failed", handleFailed);
+            // Set timeout if provided
+            if (timeout) {
+                timeoutId = setTimeout(() => {
+                    this.off("action:state-updated", handleStateUpdate);
+                    this.off("action:completed", handleCompleted);
+                    this.off("action:failed", handleFailed);
+                    reject(new Error(`Timeout waiting for action: ${actionId}`));
+                }, timeout);
+            }
+        });
+    }
+    /**
+     * Create a communication channel
+     */
+    createChannel(config) {
+        debug("Creating channel: %s (%s)", config.name, config.type);
+        const channel = {
+            id: this.generateChannelId(),
+            name: config.name,
+            type: config.type,
+            subscribers: config.subscribers || [],
+            messageHistory: [],
+            persistent: config.persistent || false,
+        };
+        this.store.channels.set(config.name, channel);
+        this.emit("channel:created", { channel });
+    }
+    /**
+     * Subscribe to a channel
+     */
+    subscribeToChannel(channelName, actionId) {
+        debug("Action %s subscribing to channel: %s", actionId, channelName);
+        const channel = this.store.channels.get(channelName);
+        if (!channel) {
+            throw ErrorHandler.createError(ErrorCode.VALIDATION_ERROR, `Channel not found: ${channelName}`, { channel: channelName });
+        }
+        if (!channel.subscribers.includes(actionId)) {
+            channel.subscribers.push(actionId);
+            this.emit("channel:subscription", {
+                channelName,
+                actionId,
+                type: "subscribe",
+            });
+        }
+    }
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribeFromChannel(channelName, actionId) {
+        debug("Action %s unsubscribing from channel: %s", actionId, channelName);
+        const channel = this.store.channels.get(channelName);
+        if (!channel)
+            return;
+        const index = channel.subscribers.indexOf(actionId);
+        if (index > -1) {
+            channel.subscribers.splice(index, 1);
+            this.emit("channel:subscription", {
+                channelName,
+                actionId,
+                type: "unsubscribe",
+            });
+        }
+    }
+    /**
+     * Get message history
+     */
+    getMessageHistory(filter) {
+        let messages = this.store.eventHistory;
+        if (filter) {
+            messages = messages.filter((msg) => {
+                if (filter.type && msg.type !== filter.type)
+                    return false;
+                if (filter.source && msg.source !== filter.source)
+                    return false;
+                if (filter.target && msg.target !== filter.target)
+                    return false;
+                if (filter.correlationId && msg.correlationId !== filter.correlationId)
+                    return false;
+                if (filter.since && msg.timestamp < filter.since)
+                    return false;
+                return true;
+            });
+        }
+        return messages;
+    }
+    /**
+     * Clear communication state
+     */
+    clear() {
+        debug("Clearing communication state");
+        this.store.actionStates.clear();
+        this.store.sharedData.clear();
+        this.store.eventHistory = [];
+        this.messageCorrelations.clear();
+        // Recreate default channels
+        this.initializeChannels();
+        this.emit("state:cleared");
+    }
+    /**
+     * Get communication statistics
+     */
+    getStats() {
+        const states = Array.from(this.store.actionStates.values());
+        return {
+            activeActions: states.filter((s) => s.status === "running" || s.status === "paused").length,
+            completedActions: states.filter((s) => s.status === "completed").length,
+            failedActions: states.filter((s) => s.status === "failed").length,
+            totalMessages: this.store.eventHistory.length,
+            sharedDataEntries: this.store.sharedData.size,
+            channels: this.store.channels.size,
+        };
+    }
+    /**
+     * Initialize default channels
+     */
+    initializeChannels() {
+        // Create default system channels
+        const defaultChannels = [
+            { name: "system", type: "broadcast", persistent: true },
+            { name: "errors", type: "broadcast", persistent: true },
+            { name: "lifecycle", type: "broadcast", persistent: false },
+            ...this.config.channels,
+        ];
+        for (const channelConfig of defaultChannels) {
+            this.createChannel(channelConfig);
+        }
+    }
+    /**
+     * Route message to appropriate channels and subscribers
+     */
+    routeMessage(message) {
+        // If target is specified, route directly
+        if (message.target) {
+            // Direct message - no additional routing needed
+            return;
+        }
+        // Broadcast to all relevant channels
+        for (const channel of this.store.channels.values()) {
+            if (channel.type === "broadcast") {
+                // Add to channel history if persistent
+                if (channel.persistent) {
+                    channel.messageHistory.push(message);
+                    this.trimChannelHistory(channel);
+                }
+            }
+        }
+    }
+    /**
+     * Track correlation between messages
+     */
+    trackCorrelation(message) {
+        if (!message.correlationId)
+            return;
+        if (!this.messageCorrelations.has(message.correlationId)) {
+            this.messageCorrelations.set(message.correlationId, []);
+        }
+        this.messageCorrelations.get(message.correlationId)?.push(message.id);
+    }
+    /**
+     * Trim event history to stay within limits
+     */
+    trimEventHistory() {
+        if (this.store.eventHistory.length > this.config.maxMessageHistory) {
+            this.store.eventHistory = this.store.eventHistory.slice(-this.config.maxMessageHistory);
+        }
+    }
+    /**
+     * Trim channel message history
+     */
+    trimChannelHistory(channel) {
+        const maxHistory = 100; // Configurable per channel in the future
+        if (channel.messageHistory.length > maxHistory) {
+            channel.messageHistory = channel.messageHistory.slice(-maxHistory);
+        }
+    }
+    /**
+     * Generate unique message ID
+     */
+    generateMessageId() {
+        return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Generate unique channel ID
+     */
+    generateChannelId() {
+        return `ch_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+// Global communication manager instance
+let globalCommunicationManager;
+/**
+ * Get or create the global communication manager
+ */
+export function getCommunicationManager(config) {
+    if (!globalCommunicationManager) {
+        globalCommunicationManager = new ActionCommunicationManager(config);
+    }
+    return globalCommunicationManager;
+}
+/**
+ * Set the global communication manager
+ */
+export function setCommunicationManager(manager) {
+    globalCommunicationManager = manager;
+}
+/**
+ * Clear the global communication manager
+ */
+export function clearCommunicationManager() {
+    if (globalCommunicationManager) {
+        globalCommunicationManager.clear();
+        globalCommunicationManager = undefined;
+    }
+}
+//# sourceMappingURL=communication.js.map

package/dist/actions/communication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication.js","sourceRoot":"","sources":["../../src/actions/communication.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,WAAW,MAAM,OAAO,CAAC;AAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AAyDjD,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IACnD,KAAK,CAAa;IAClB,MAAM,CAAsB;IAC5B,mBAAmB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE1D,YAAY,SAAuC,EAAE;QACpD,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,MAAM,GAAG;YACb,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;YACnD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,GAAG;YAC9C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,KAAK;YACpD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAC/B,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACZ,YAAY,EAAE,IAAI,GAAG,EAAE;YACvB,UAAU,EAAE,IAAI,GAAG,EAAE;YACrB,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,YAAY,EAAE,EAAE;SAChB,CAAC;QAEF,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,KAAK,CAAC,oDAAoD,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,cAAc,CACb,QAAgB,EAChB,UAAkB,EAClB,cAAmC,EAAE;QAErC,KAAK,CAAC,6BAA6B,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE3D,MAAM,KAAK,GAAgB;YAC1B,EAAE,EAAE,QAAQ;YACZ,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,EAAE,GAAG,WAAW,EAAE;YACxB,QAAQ,EAAE;gBACT,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,YAAY,EAAE,EAAE;gBAChB,MAAM,EAAE,EAAE;aACV;SACD,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhE,+BAA+B;QAC/B,IAAI,CAAC,WAAW,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE;YACpC,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAChB,QAAgB,EAChB,OAAqC,EACrC,MAA8B;QAE9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,2BAA2B,QAAQ,EAAE,EACrC,EAAE,MAAM,EAAE,QAAQ,EAAE,CACpB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;QAE7C,cAAc;QACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnC,4BAA4B;QAC5B,IAAI,MAAM,EAAE,CAAC;YACZ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACtB,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnD,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;gBACpC,KAAK,CAAC,QAAQ,CAAC,QAAQ;oBACtB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACxE,CAAC;QACF,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAExE,yBAAyB;QACzB,IAAI,CAAC,WAAW,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;YAC5B,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB,EAAE,MAAqD;QACrF,KAAK,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,2BAA2B,QAAQ,EAAE,EACrC,EAAE,MAAM,EAAE,QAAQ,EAAE,CACpB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAEhG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3D,uBAAuB;QACvB,IAAI,CAAC,WAAW,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAgB,EAAE,KAAqB;QACjD,KAAK,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QAEtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,2BAA2B,QAAQ,EAAE,EACrC,EAAE,MAAM,EAAE,QAAQ,EAAE,CACpB,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACpE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAChG,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;QACpD,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAErE,oBAAoB;QACpB,IAAI,CAAC,WAAW,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;YAChC,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAoD;QAC/D,MAAM,WAAW,GAAkB;YAClC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,iBAAiB,EAAE;YAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE;YAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;SACpC,CAAC;QAEF,KAAK,CACJ,gCAAgC,EAChC,WAAW,CAAC,MAAM,EAClB,WAAW,CAAC,MAAM,IAAI,WAAW,EACjC,WAAW,CAAC,IAAI,CAChB,CAAC;QAEF,iBAAiB;QACjB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,wCAAwC;QACxC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAE/B,oBAAoB;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,WAAW,WAAW,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;QAEtD,8BAA8B;QAC9B,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;YAC/B,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;IACF,CAAC;IAED;;OAEG;IACH,mBAAmB,CAClB,QAAgB,EAChB,WAAmB,EACnB,OAAyC;QAEzC,KAAK,CAAC,uCAAuC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEtE,MAAM,SAAS,GAAG,WAAW,WAAW,EAAE,CAAC;QAC3C,MAAM,cAAc,GAAG,CAAC,OAAsB,EAAE,EAAE;YACjD,+CAA+C;YAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,CAAC,OAAO,CAAC,CAAC;YAClB,CAAC;QACF,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEnC,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACpC,KAAK,CAAC,0CAA0C,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1E,CAAC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,GAAW,EAAE,KAAU,EAAE,MAAe;QACrD,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAErD,+BAA+B;QAC/B,IAAI,CAAC,WAAW,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,MAAM,EAAE,MAAM,IAAI,QAAQ;YAC1B,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,gBAAgB;QACf,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,GAAW,EAAE,MAAe;QAC5C,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAElD,iCAAiC;YACjC,IAAI,CAAC,WAAW,CAAC;gBAChB,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;gBAC5B,MAAM,EAAE,MAAM,IAAI,QAAQ;gBAC1B,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,EAAE,GAAG,EAAE;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE;aACrB,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,kBAAkB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAA6B;QAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB,EAAE,OAAgB;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACnD,OAAO;YACR,CAAC;YAED,4CAA4C;YAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/D,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACR,CAAC;YAED,IAAI,SAAqC,CAAC;YAE1C,MAAM,iBAAiB,GAAG,CAAC,KAG1B,EAAE,EAAE;gBACJ,IACC,KAAK,CAAC,QAAQ,KAAK,QAAQ;oBAC3B,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,EACtE,CAAC;oBACF,IAAI,SAAS;wBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;oBACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;oBACpD,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;oBACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACF,CAAC,CAAC;YAEF,MAAM,eAAe,GAAG,CAAC,KAGxB,EAAE,EAAE;gBACJ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,SAAS;wBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;oBACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;oBACpD,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;oBACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACF,CAAC,CAAC;YAEF,MAAM,YAAY,GAAG,CAAC,KAGrB,EAAE,EAAE;gBACJ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,SAAS;wBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;oBACvC,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;oBACpD,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;oBACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,4BAA4B;gBACnD,CAAC;YACF,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;YACnD,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;YAEvC,0BAA0B;YAC1B,IAAI,OAAO,EAAE,CAAC;gBACb,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC3B,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;oBACpD,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC9D,CAAC,EAAE,OAAO,CAAC,CAAC;YACb,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAkC;QAC/C,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7D,MAAM,OAAO,GAAyB;YACrC,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;YACrC,cAAc,EAAE,EAAE;YAClB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;SACtC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,WAAmB,EAAE,QAAgB;QACvD,KAAK,CAAC,sCAAsC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,sBAAsB,WAAW,EAAE,EACnC,EAAE,OAAO,EAAE,WAAW,EAAE,CACxB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBACjC,WAAW;gBACX,QAAQ;gBACR,IAAI,EAAE,WAAW;aACjB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,WAAmB,EAAE,QAAgB;QAC3D,KAAK,CAAC,0CAA0C,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBACjC,WAAW;gBACX,QAAQ;gBACR,IAAI,EAAE,aAAa;aACnB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,MAMjB;QACA,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;QAEvC,IAAI,MAAM,EAAE,CAAC;YACZ,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,IAAI,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;oBAAE,OAAO,KAAK,CAAC;gBAC1D,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBAAE,OAAO,KAAK,CAAC;gBAChE,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBAAE,OAAO,KAAK,CAAC;gBAChE,IAAI,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;oBAAE,OAAO,KAAK,CAAC;gBACrF,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK;oBAAE,OAAO,KAAK,CAAC;gBAC/D,OAAO,IAAI,CAAC;YACb,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAEtC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAEjC,4BAA4B;QAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,QAAQ;QAQP,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAE5D,OAAO;YACN,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC3F,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;YACvE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YACjE,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM;YAC7C,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI;YAC7C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI;SAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB;QACzB,iCAAiC;QACjC,MAAM,eAAe,GAAiC;YACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;YACvD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;YACvD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE;YAC3D,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;SACvB,CAAC;QAEF,KAAK,MAAM,aAAa,IAAI,eAAe,EAAE,CAAC;YAC7C,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAAsB;QAC1C,yCAAyC;QACzC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,gDAAgD;YAChD,OAAO;QACR,CAAC;QAED,qCAAqC;QACrC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAClC,uCAAuC;gBACvC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;oBACxB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACrC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAsB;QAC9C,IAAI,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO;QAEnC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACK,gBAAgB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACpE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzF,CAAC;IACF,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAA6B;QACvD,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,yCAAyC;QACjE,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAChD,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QACpE,CAAC;IACF,CAAC;IAED;;OAEG;IACK,iBAAiB;QACxB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAED;;OAEG;IACK,iBAAiB;QACxB,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;CACD;AAED,wCAAwC;AACxC,IAAI,0BAAkE,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACtC,MAAqC;IAErC,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACjC,0BAA0B,GAAG,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,0BAA0B,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAmC;IAC1E,0BAA0B,GAAG,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACxC,IAAI,0BAA0B,EAAE,CAAC;QAChC,0BAA0B,CAAC,KAAK,EAAE,CAAC;QACnC,0BAA0B,GAAG,SAAS,CAAC;IACxC,CAAC;AACF,CAAC"}

package/dist/actions/decorator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Action Decorator Implementation
+ *
+ * Provides the @action decorator for defining generator actions
+ */
+import type { ActionFunction, ActionMetadata } from "./types.js";
+/**
+ * Action decorator factory
+ *
+ * @param metadata Action configuration including name, description, and parameters
+ * @returns Decorator function
+ */
+export declare function action(metadata: ActionMetadata): <T extends ActionFunction>(target: T, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => T;
+/**
+ * Extract action metadata from a decorated function
+ */
+export declare function getActionMetadata(fn: ActionFunction): ActionMetadata | undefined;
+/**
+ * Check if a function is decorated with @action
+ */
+export declare function isActionFunction(fn: any): fn is ActionFunction;
+//# sourceMappingURL=decorator.d.ts.map

package/dist/actions/decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../../src/actions/decorator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjE;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,cAAc,IACtC,CAAC,SAAS,cAAc,EAC/B,QAAQ,CAAC,EACT,cAAc,MAAM,GAAG,MAAM,EAC7B,aAAa,kBAAkB,KAC7B,CAAC,CA2BJ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,IAAI,cAAc,CAE9D"}

package/dist/actions/decorator.js

@@ -0,0 +1,110 @@
+/**
+ * Action Decorator Implementation
+ *
+ * Provides the @action decorator for defining generator actions
+ */
+import createDebug from "debug";
+import { ActionRegistry } from "./registry.js";
+const debug = createDebug("hyper:action:decorator");
+// Symbol to store metadata on functions
+const ACTION_METADATA_SYMBOL = Symbol("actionMetadata");
+/**
+ * Action decorator factory
+ *
+ * @param metadata Action configuration including name, description, and parameters
+ * @returns Decorator function
+ */
+export function action(metadata) {
+    return (target, propertyKey, descriptor) => {
+        debug("Decorating action: %s", metadata.name);
+        // Validate metadata
+        validateActionMetadata(metadata);
+        // Store metadata on the function
+        const actionMetadata = {
+            name: metadata.name,
+            description: metadata.description,
+            parameters: metadata.parameters || [],
+            category: metadata.category || "general",
+            tags: metadata.tags || [],
+            examples: metadata.examples || [],
+        };
+        // Attach metadata to function using symbol
+        target[ACTION_METADATA_SYMBOL] = actionMetadata;
+        // Register with action registry
+        const registry = ActionRegistry.getInstance();
+        registry.register(target, actionMetadata);
+        debug("Action registered: %s in category %s", metadata.name, actionMetadata.category);
+        return target;
+    };
+}
+/**
+ * Extract action metadata from a decorated function
+ */
+export function getActionMetadata(fn) {
+    return fn[ACTION_METADATA_SYMBOL];
+}
+/**
+ * Check if a function is decorated with @action
+ */
+export function isActionFunction(fn) {
+    return typeof fn === "function" && ACTION_METADATA_SYMBOL in fn;
+}
+/**
+ * Validate action metadata
+ */
+function validateActionMetadata(metadata) {
+    if (!metadata.name) {
+        throw new Error("Action name is required");
+    }
+    if (!/^[a-z][a-z0-9-]*$/i.test(metadata.name)) {
+        throw new Error("Action name must be alphanumeric with hyphens (kebab-case recommended)");
+    }
+    if (metadata.parameters) {
+        for (const param of metadata.parameters) {
+            validateParameterDefinition(param);
+        }
+    }
+}
+/**
+ * Validate parameter definition
+ */
+function validateParameterDefinition(param) {
+    if (!param.name) {
+        throw new Error("Parameter name is required");
+    }
+    if (!param.type) {
+        throw new Error(`Parameter ${param.name} must have a type`);
+    }
+    const validTypes = [
+        "string",
+        "boolean",
+        "number",
+        "enum",
+        "array",
+        "object",
+        "file",
+        "directory",
+    ];
+    if (!validTypes.includes(param.type)) {
+        throw new Error(`Invalid parameter type '${param.type}' for ${param.name}. Must be one of: ${validTypes.join(", ")}`);
+    }
+    // Validate enum parameters
+    if (param.type === "enum") {
+        if (!param.values || !Array.isArray(param.values) || param.values.length === 0) {
+            throw new Error(`Enum parameter ${param.name} must have a non-empty values array`);
+        }
+    }
+    // Validate number constraints
+    if (param.type === "number") {
+        if (param.min !== undefined && typeof param.min !== "number") {
+            throw new Error(`Parameter ${param.name} min constraint must be a number`);
+        }
+        if (param.max !== undefined && typeof param.max !== "number") {
+            throw new Error(`Parameter ${param.name} max constraint must be a number`);
+        }
+        if (param.min !== undefined && param.max !== undefined && param.min > param.max) {
+            throw new Error(`Parameter ${param.name} min (${param.min}) cannot be greater than max (${param.max})`);
+        }
+    }
+}
+//# sourceMappingURL=decorator.js.map