mcp-wordpress 2.4.2 → 2.5.0

package/dist/tools/posts/PostToolDefinitions.js

@@ -0,0 +1,236 @@
+/**
+ * WordPress Posts Tool Definitions
+ *
+ * Defines all MCP tool schemas for WordPress post management.
+ * This module separates tool definitions from their implementations
+ * for better maintainability and testing.
+ */
+/**
+ * Tool definition for listing WordPress posts
+ */
+export const listPostsTool = {
+    name: "wp_list_posts",
+    description: "Lists posts from a WordPress site with comprehensive filtering options. Supports search, status filtering, and category/tag filtering with enhanced metadata display.\n\n" +
+        "**Usage Examples:**\n" +
+        "• Basic listing: `wp_list_posts`\n" +
+        '• Search posts: `wp_list_posts --search="AI trends"`\n' +
+        '• Filter by status: `wp_list_posts --status="draft"`\n' +
+        "• Category filtering: `wp_list_posts --categories=[1,2,3]`\n" +
+        "• Paginated results: `wp_list_posts --per_page=20 --page=2`\n" +
+        '• Combined filters: `wp_list_posts --search="WordPress" --status="publish" --per_page=10`',
+    inputSchema: {
+        type: "object",
+        properties: {
+            per_page: {
+                type: "number",
+                description: "Number of items to return per page (max 100).",
+            },
+            search: {
+                type: "string",
+                description: "Limit results to those matching a search term.",
+            },
+            status: {
+                type: "string",
+                description: "Filter by post status.",
+                enum: ["publish", "future", "draft", "pending", "private"],
+            },
+            categories: {
+                type: "array",
+                items: { type: "number" },
+                description: "Limit results to posts in specific category IDs.",
+            },
+            tags: {
+                type: "array",
+                items: { type: "number" },
+                description: "Limit results to posts with specific tag IDs.",
+            },
+        },
+    },
+};
+/**
+ * Tool definition for retrieving a single WordPress post
+ */
+export const getPostTool = {
+    name: "wp_get_post",
+    description: "Retrieves detailed information about a single post including metadata, content statistics, and management links.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "number",
+                description: "The unique identifier for the post.",
+            },
+        },
+        required: ["id"],
+    },
+};
+/**
+ * Tool definition for creating a new WordPress post
+ */
+export const createPostTool = {
+    name: "wp_create_post",
+    description: "Creates a new WordPress post with comprehensive validation and detailed success feedback including management links.\n\n" +
+        "**Usage Examples:**\n" +
+        '• Simple post: `wp_create_post --title="My New Post" --content="<p>Hello World!</p>"`\n' +
+        '• Draft post: `wp_create_post --title="Draft Post" --status="draft"`\n' +
+        '• Categorized post: `wp_create_post --title="Tech News" --categories=[1,5] --tags=[10,20]`\n' +
+        '• Post with featured image: `wp_create_post --title="My Post" --content="<p>Content</p>" --featured_media=42`\n' +
+        '• Remove featured image: `wp_create_post --title="My Post" --featured_media=0`\n' +
+        '• Scheduled post: `wp_create_post --title="Future Post" --status="future" --date="2024-12-25T10:00:00"`\n' +
+        '• Complete post: `wp_create_post --title="Complete Post" --content="<p>Content</p>" --excerpt="Summary" --status="publish"`',
+    inputSchema: {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "The title for the post.",
+            },
+            content: {
+                type: "string",
+                description: "The content for the post, in HTML format.",
+            },
+            status: {
+                type: "string",
+                description: "The publishing status for the post.",
+                enum: ["publish", "draft", "pending", "private"],
+            },
+            excerpt: {
+                type: "string",
+                description: "The excerpt for the post.",
+            },
+            categories: {
+                type: "array",
+                items: { type: "number" },
+                description: "An array of category IDs to assign to the post.",
+            },
+            tags: {
+                type: "array",
+                items: { type: "number" },
+                description: "An array of tag IDs to assign to the post.",
+            },
+            featured_media: {
+                type: "number",
+                description: "The ID of the featured media (image). Use 0 to remove featured media.",
+            },
+            date: {
+                type: "string",
+                description: "The date the post was published, in the site's timezone (ISO 8601 format).",
+            },
+        },
+        required: ["title"],
+    },
+};
+/**
+ * Tool definition for updating an existing WordPress post
+ */
+export const updatePostTool = {
+    name: "wp_update_post",
+    description: "Updates an existing WordPress post with comprehensive validation and change tracking. All parameters except ID are optional - only provided fields will be updated.\n\n" +
+        "**Usage Examples:**\n" +
+        '• Update title: `wp_update_post --id=123 --title="New Title"`\n' +
+        '• Update content: `wp_update_post --id=123 --content="<p>Updated content</p>"`\n' +
+        '• Change status: `wp_update_post --id=123 --status="publish"`\n' +
+        "• Update categories: `wp_update_post --id=123 --categories=[1,5,10]`\n" +
+        "• Set featured image: `wp_update_post --id=123 --featured_media=42`\n" +
+        "• Remove featured image: `wp_update_post --id=123 --featured_media=0`\n" +
+        '• Multiple updates: `wp_update_post --id=123 --title="New Title" --status="publish" --categories=[1,2]`',
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "number",
+                description: "The ID of the post to update.",
+            },
+            title: {
+                type: "string",
+                description: "The new title for the post.",
+            },
+            content: {
+                type: "string",
+                description: "The new content for the post, in HTML format.",
+            },
+            status: {
+                type: "string",
+                description: "The new publishing status for the post.",
+                enum: ["publish", "draft", "pending", "private"],
+            },
+            excerpt: {
+                type: "string",
+                description: "The new excerpt for the post.",
+            },
+            categories: {
+                type: "array",
+                items: { type: "number" },
+                description: "An array of category IDs to assign to the post.",
+            },
+            tags: {
+                type: "array",
+                items: { type: "number" },
+                description: "An array of tag IDs to assign to the post.",
+            },
+            featured_media: {
+                type: "number",
+                description: "The ID of the featured media (image). Use 0 to remove featured media.",
+            },
+            date: {
+                type: "string",
+                description: "The date the post was published, in the site's timezone (ISO 8601 format).",
+            },
+        },
+        required: ["id"],
+    },
+};
+/**
+ * Tool definition for deleting a WordPress post
+ */
+export const deletePostTool = {
+    name: "wp_delete_post",
+    description: "Deletes a WordPress post with options for trash or permanent deletion. Includes safety confirmations and detailed feedback on the deletion action.\n\n" +
+        "**Usage Examples:**\n" +
+        "• Trash a post: `wp_delete_post --id=123` (moves to trash)\n" +
+        "• Permanent deletion: `wp_delete_post --id=123 --force=true`\n" +
+        "• Bulk operations: Use multiple calls with different IDs",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "number",
+                description: "The ID of the post to delete.",
+            },
+            force: {
+                type: "boolean",
+                description: "Whether to bypass trash and force deletion (default: false, moves to trash).",
+            },
+        },
+        required: ["id"],
+    },
+};
+/**
+ * Tool definition for retrieving post revisions
+ */
+export const getPostRevisionsTool = {
+    name: "wp_get_post_revisions",
+    description: "Retrieves the revision history for a specific post, including details about changes, dates, and authors for content management and auditing purposes.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "number",
+                description: "The ID of the post to get revisions for.",
+            },
+        },
+        required: ["id"],
+    },
+};
+/**
+ * Collection of all post tool definitions
+ */
+export const postToolDefinitions = [
+    listPostsTool,
+    getPostTool,
+    createPostTool,
+    updatePostTool,
+    deletePostTool,
+    getPostRevisionsTool,
+];
+//# sourceMappingURL=PostToolDefinitions.js.map

package/dist/tools/posts/PostToolDefinitions.js.map

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

package/dist/tools/posts/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * WordPress Posts Tools - Refactored Module
+ *
+ * This module provides comprehensive WordPress post management functionality
+ * through a clean, modular architecture. It combines tool definitions with
+ * their corresponding handlers for complete post management capabilities.
+ *
+ * Features:
+ * - List posts with advanced filtering and search
+ * - Get individual posts with detailed metadata
+ * - Create new posts with validation and feedback
+ * - Update existing posts with change tracking
+ * - Delete posts with trash/permanent options
+ * - Retrieve post revision history
+ *
+ * @example
+ * ```typescript
+ * import { PostTools } from './tools/posts';
+ *
+ * const postTools = new PostTools();
+ * const tools = postTools.getTools();
+ *
+ * // Use with MCP server
+ * server.setRequestHandler(ListToolsRequestSchema, () => ({
+ *   tools: [...tools, ...otherTools]
+ * }));
+ * ```
+ */
+import { WordPressClient } from "../../client/api.js";
+import { CreatePostRequest, PostQueryParams, UpdatePostRequest, WordPressPost } from "../../types/wordpress.js";
+/**
+ * Main PostTools class that provides WordPress post management functionality.
+ *
+ * This class serves as the interface between the MCP framework and WordPress
+ * post operations. It combines tool definitions with their corresponding handlers
+ * to provide a complete post management solution.
+ *
+ * The class is designed with a modular architecture:
+ * - Tool definitions are separate from implementations
+ * - Handlers are extracted into focused functions
+ * - Business logic is isolated from framework concerns
+ *
+ * @since 2.0.0 (Refactored from monolithic implementation)
+ */
+export declare class PostTools {
+    /**
+     * Retrieves all post management tool definitions for MCP registration.
+     *
+     * Returns an array of tool definitions that include:
+     * - wp_list_posts: Advanced post listing with filtering
+     * - wp_get_post: Detailed individual post retrieval
+     * - wp_create_post: New post creation with validation
+     * - wp_update_post: Post updating with change tracking
+     * - wp_delete_post: Post deletion with trash/permanent options
+     * - wp_get_post_revisions: Post revision history
+     *
+     * Each tool includes comprehensive parameter validation, detailed documentation,
+     * and usage examples for optimal developer experience.
+     *
+     * @returns Tool definitions ready for MCP server registration
+     */
+    getTools(): unknown[];
+    /**
+     * Maps tool names to their corresponding handler methods.
+     *
+     * This method provides the binding between tool definitions and their
+     * implementations, ensuring proper context and error handling.
+     *
+     * @param toolName - The name of the tool to get a handler for
+     * @returns The bound handler method for the specified tool
+     * @private
+     */
+    private getHandlerForTool;
+    /**
+     * Lists WordPress posts with advanced filtering capabilities.
+     *
+     * @param client - WordPress client instance
+     * @param params - Query parameters for filtering posts
+     * @returns Formatted list of posts or error message
+     */
+    handleListPosts(client: WordPressClient, params: PostQueryParams): Promise<WordPressPost[] | string>;
+    /**
+     * Retrieves a single WordPress post with detailed information.
+     *
+     * @param client - WordPress client instance
+     * @param params - Parameters including post ID
+     * @returns Detailed post information or error message
+     */
+    handleGetPost(client: WordPressClient, params: {
+        id: number;
+    }): Promise<WordPressPost | string>;
+    /**
+     * Creates a new WordPress post with validation and feedback.
+     *
+     * @param client - WordPress client instance
+     * @param params - Post creation parameters
+     * @returns Created post information or error message
+     */
+    handleCreatePost(client: WordPressClient, params: CreatePostRequest): Promise<WordPressPost | string>;
+    /**
+     * Updates an existing WordPress post with change tracking.
+     *
+     * @param client - WordPress client instance
+     * @param params - Post update parameters including ID
+     * @returns Updated post information or error message
+     */
+    handleUpdatePost(client: WordPressClient, params: UpdatePostRequest & {
+        id: number;
+    }): Promise<WordPressPost | string>;
+    /**
+     * Deletes a WordPress post with options for trash or permanent deletion.
+     *
+     * @param client - WordPress client instance
+     * @param params - Deletion parameters including ID and force option
+     * @returns Deletion result or error message
+     */
+    handleDeletePost(client: WordPressClient, params: {
+        id: number;
+        force?: boolean;
+    }): Promise<{
+        deleted: boolean;
+        previous?: WordPressPost;
+    } | string>;
+    /**
+     * Retrieves revision history for a WordPress post.
+     *
+     * @param client - WordPress client instance
+     * @param params - Parameters including post ID
+     * @returns Post revisions or error message
+     */
+    handleGetPostRevisions(client: WordPressClient, params: {
+        id: number;
+    }): Promise<WordPressPost[] | string>;
+}
+export { postToolDefinitions } from "./PostToolDefinitions.js";
+export * from "./PostHandlers.js";
+export default PostTools;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/posts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/posts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAWhH;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;;OAeG;IACI,QAAQ,IAAI,OAAO,EAAE;IAO5B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;;;;OAMG;IACU,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC;IAIjH;;;;;;OAMG;IACU,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC;IAI5G;;;;;;OAMG;IACU,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC;IAIlH;;;;;;OAMG;IACU,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,iBAAiB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC;IAIlC;;;;;;OAMG;IACU,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,MAAM,CAAC;IAInE;;;;;;OAMG;IACU,sBAAsB,CACjC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC;CAGrC;AAGD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,mBAAmB,CAAC;AAGlC,eAAe,SAAS,CAAC"}

package/dist/tools/posts/index.js

@@ -0,0 +1,163 @@
+/**
+ * WordPress Posts Tools - Refactored Module
+ *
+ * This module provides comprehensive WordPress post management functionality
+ * through a clean, modular architecture. It combines tool definitions with
+ * their corresponding handlers for complete post management capabilities.
+ *
+ * Features:
+ * - List posts with advanced filtering and search
+ * - Get individual posts with detailed metadata
+ * - Create new posts with validation and feedback
+ * - Update existing posts with change tracking
+ * - Delete posts with trash/permanent options
+ * - Retrieve post revision history
+ *
+ * @example
+ * ```typescript
+ * import { PostTools } from './tools/posts';
+ *
+ * const postTools = new PostTools();
+ * const tools = postTools.getTools();
+ *
+ * // Use with MCP server
+ * server.setRequestHandler(ListToolsRequestSchema, () => ({
+ *   tools: [...tools, ...otherTools]
+ * }));
+ * ```
+ */
+import { postToolDefinitions } from "./PostToolDefinitions.js";
+import { handleListPosts, handleGetPost, handleCreatePost, handleUpdatePost, handleDeletePost, handleGetPostRevisions, } from "./PostHandlers.js";
+/**
+ * Main PostTools class that provides WordPress post management functionality.
+ *
+ * This class serves as the interface between the MCP framework and WordPress
+ * post operations. It combines tool definitions with their corresponding handlers
+ * to provide a complete post management solution.
+ *
+ * The class is designed with a modular architecture:
+ * - Tool definitions are separate from implementations
+ * - Handlers are extracted into focused functions
+ * - Business logic is isolated from framework concerns
+ *
+ * @since 2.0.0 (Refactored from monolithic implementation)
+ */
+export class PostTools {
+    /**
+     * Retrieves all post management tool definitions for MCP registration.
+     *
+     * Returns an array of tool definitions that include:
+     * - wp_list_posts: Advanced post listing with filtering
+     * - wp_get_post: Detailed individual post retrieval
+     * - wp_create_post: New post creation with validation
+     * - wp_update_post: Post updating with change tracking
+     * - wp_delete_post: Post deletion with trash/permanent options
+     * - wp_get_post_revisions: Post revision history
+     *
+     * Each tool includes comprehensive parameter validation, detailed documentation,
+     * and usage examples for optimal developer experience.
+     *
+     * @returns Tool definitions ready for MCP server registration
+     */
+    getTools() {
+        return postToolDefinitions.map((toolDef) => ({
+            ...toolDef,
+            handler: this.getHandlerForTool(toolDef.name),
+        }));
+    }
+    /**
+     * Maps tool names to their corresponding handler methods.
+     *
+     * This method provides the binding between tool definitions and their
+     * implementations, ensuring proper context and error handling.
+     *
+     * @param toolName - The name of the tool to get a handler for
+     * @returns The bound handler method for the specified tool
+     * @private
+     */
+    getHandlerForTool(toolName) {
+        switch (toolName) {
+            case "wp_list_posts":
+                return this.handleListPosts.bind(this);
+            case "wp_get_post":
+                return this.handleGetPost.bind(this);
+            case "wp_create_post":
+                return this.handleCreatePost.bind(this);
+            case "wp_update_post":
+                return this.handleUpdatePost.bind(this);
+            case "wp_delete_post":
+                return this.handleDeletePost.bind(this);
+            case "wp_get_post_revisions":
+                return this.handleGetPostRevisions.bind(this);
+            default:
+                throw new Error(`Unknown tool: ${toolName}`);
+        }
+    }
+    // Handler Methods - Delegated to Extracted Functions
+    /**
+     * Lists WordPress posts with advanced filtering capabilities.
+     *
+     * @param client - WordPress client instance
+     * @param params - Query parameters for filtering posts
+     * @returns Formatted list of posts or error message
+     */
+    async handleListPosts(client, params) {
+        return handleListPosts(client, params);
+    }
+    /**
+     * Retrieves a single WordPress post with detailed information.
+     *
+     * @param client - WordPress client instance
+     * @param params - Parameters including post ID
+     * @returns Detailed post information or error message
+     */
+    async handleGetPost(client, params) {
+        return handleGetPost(client, params);
+    }
+    /**
+     * Creates a new WordPress post with validation and feedback.
+     *
+     * @param client - WordPress client instance
+     * @param params - Post creation parameters
+     * @returns Created post information or error message
+     */
+    async handleCreatePost(client, params) {
+        return handleCreatePost(client, params);
+    }
+    /**
+     * Updates an existing WordPress post with change tracking.
+     *
+     * @param client - WordPress client instance
+     * @param params - Post update parameters including ID
+     * @returns Updated post information or error message
+     */
+    async handleUpdatePost(client, params) {
+        return handleUpdatePost(client, params);
+    }
+    /**
+     * Deletes a WordPress post with options for trash or permanent deletion.
+     *
+     * @param client - WordPress client instance
+     * @param params - Deletion parameters including ID and force option
+     * @returns Deletion result or error message
+     */
+    async handleDeletePost(client, params) {
+        return handleDeletePost(client, params);
+    }
+    /**
+     * Retrieves revision history for a WordPress post.
+     *
+     * @param client - WordPress client instance
+     * @param params - Parameters including post ID
+     * @returns Post revisions or error message
+     */
+    async handleGetPostRevisions(client, params) {
+        return handleGetPostRevisions(client, params);
+    }
+}
+// Export everything for easy imports
+export { postToolDefinitions } from "./PostToolDefinitions.js";
+export * from "./PostHandlers.js";
+// Default export for backwards compatibility
+export default PostTools;
+//# sourceMappingURL=index.js.map

package/dist/tools/posts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/posts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,SAAS;IACpB;;;;;;;;;;;;;;;OAeG;IACI,QAAQ;QACb,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,OAAO;YACV,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC;SAC9C,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACK,iBAAiB,CAAC,QAAgB;QACxC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,KAAK,uBAAuB;gBAC1B,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,qDAAqD;IAErD;;;;;;OAMG;IACI,KAAK,CAAC,eAAe,CAAC,MAAuB,EAAE,MAAuB;QAC3E,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,aAAa,CAAC,MAAuB,EAAE,MAAsB;QACxE,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAuB,EAAE,MAAyB;QAC9E,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAC3B,MAAuB,EACvB,MAA0C;QAE1C,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAC3B,MAAuB,EACvB,MAAuC;QAEvC,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,sBAAsB,CACjC,MAAuB,EACvB,MAAsB;QAEtB,OAAO,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;CACF;AAED,qCAAqC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,mBAAmB,CAAC;AAElC,6CAA6C;AAC7C,eAAe,SAAS,CAAC"}