@mcptoolshop/file-forge 0.1.0

package/build/types.d.ts

@@ -0,0 +1,402 @@
+/**
+ * MCP File Forge - Type Definitions
+ *
+ * Core types used throughout the server.
+ */
+import { z } from 'zod';
+/**
+ * Standard success result from a tool.
+ */
+export interface ToolSuccess {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+/**
+ * Standard error result from a tool.
+ */
+export interface ToolError {
+    [key: string]: unknown;
+    isError: true;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+export type ToolResult = ToolSuccess | ToolError;
+export declare const ErrorCode: {
+    readonly PATH_OUTSIDE_SANDBOX: "PATH_OUTSIDE_SANDBOX";
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+    readonly DEPTH_EXCEEDED: "DEPTH_EXCEEDED";
+    readonly INVALID_ENCODING: "INVALID_ENCODING";
+    readonly WRITE_DISABLED: "WRITE_DISABLED";
+    readonly DIRECTORY_NOT_EMPTY: "DIRECTORY_NOT_EMPTY";
+    readonly ALREADY_EXISTS: "ALREADY_EXISTS";
+    readonly INVALID_PATH: "INVALID_PATH";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Structured error information.
+ */
+export interface FileForgeError {
+    code: ErrorCodeType;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * File or directory statistics.
+ */
+export interface FileStat {
+    path: string;
+    name: string;
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymlink: boolean;
+    created: string;
+    modified: string;
+    accessed: string;
+    permissions?: string;
+}
+/**
+ * Directory entry (lighter than full FileStat).
+ */
+export interface DirectoryEntry {
+    name: string;
+    path: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    size?: number;
+}
+/**
+ * Sandbox configuration.
+ */
+export declare const SandboxConfigSchema: z.ZodObject<{
+    allowed_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    denied_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    follow_symlinks: z.ZodDefault<z.ZodBoolean>;
+    max_file_size: z.ZodDefault<z.ZodNumber>;
+    max_depth: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    allowed_paths: string[];
+    follow_symlinks: boolean;
+    max_file_size: number;
+    max_depth: number;
+    denied_paths?: string[] | undefined;
+}, {
+    allowed_paths?: string[] | undefined;
+    denied_paths?: string[] | undefined;
+    follow_symlinks?: boolean | undefined;
+    max_file_size?: number | undefined;
+    max_depth?: number | undefined;
+}>;
+export type SandboxConfig = z.infer<typeof SandboxConfigSchema>;
+/**
+ * Template configuration.
+ */
+export declare const TemplateConfigSchema: z.ZodObject<{
+    paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+}, {
+    paths?: string[] | undefined;
+}>;
+export type TemplateConfig = z.infer<typeof TemplateConfigSchema>;
+/**
+ * Logging configuration.
+ */
+export declare const LogConfigSchema: z.ZodObject<{
+    level: z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug"]>>;
+    file: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    level: "error" | "warn" | "info" | "debug";
+    file?: string | undefined;
+}, {
+    level?: "error" | "warn" | "info" | "debug" | undefined;
+    file?: string | undefined;
+}>;
+export type LogConfig = z.infer<typeof LogConfigSchema>;
+/**
+ * Full server configuration.
+ */
+export declare const ServerConfigSchema: z.ZodObject<{
+    sandbox: z.ZodDefault<z.ZodObject<{
+        allowed_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        denied_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        follow_symlinks: z.ZodDefault<z.ZodBoolean>;
+        max_file_size: z.ZodDefault<z.ZodNumber>;
+        max_depth: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        allowed_paths: string[];
+        follow_symlinks: boolean;
+        max_file_size: number;
+        max_depth: number;
+        denied_paths?: string[] | undefined;
+    }, {
+        allowed_paths?: string[] | undefined;
+        denied_paths?: string[] | undefined;
+        follow_symlinks?: boolean | undefined;
+        max_file_size?: number | undefined;
+        max_depth?: number | undefined;
+    }>>;
+    templates: z.ZodDefault<z.ZodObject<{
+        paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        paths: string[];
+    }, {
+        paths?: string[] | undefined;
+    }>>;
+    logging: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug"]>>;
+        file: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        level: "error" | "warn" | "info" | "debug";
+        file?: string | undefined;
+    }, {
+        level?: "error" | "warn" | "info" | "debug" | undefined;
+        file?: string | undefined;
+    }>>;
+    read_only: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    sandbox: {
+        allowed_paths: string[];
+        follow_symlinks: boolean;
+        max_file_size: number;
+        max_depth: number;
+        denied_paths?: string[] | undefined;
+    };
+    templates: {
+        paths: string[];
+    };
+    logging: {
+        level: "error" | "warn" | "info" | "debug";
+        file?: string | undefined;
+    };
+    read_only: boolean;
+}, {
+    sandbox?: {
+        allowed_paths?: string[] | undefined;
+        denied_paths?: string[] | undefined;
+        follow_symlinks?: boolean | undefined;
+        max_file_size?: number | undefined;
+        max_depth?: number | undefined;
+    } | undefined;
+    templates?: {
+        paths?: string[] | undefined;
+    } | undefined;
+    logging?: {
+        level?: "error" | "warn" | "info" | "debug" | undefined;
+        file?: string | undefined;
+    } | undefined;
+    read_only?: boolean | undefined;
+}>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare const ReadFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    encoding: z.ZodDefault<z.ZodString>;
+    start_line: z.ZodOptional<z.ZodNumber>;
+    end_line: z.ZodOptional<z.ZodNumber>;
+    max_size_kb: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    encoding: string;
+    max_size_kb: number;
+    start_line?: number | undefined;
+    end_line?: number | undefined;
+}, {
+    path: string;
+    encoding?: string | undefined;
+    start_line?: number | undefined;
+    end_line?: number | undefined;
+    max_size_kb?: number | undefined;
+}>;
+export type ReadFileInput = z.infer<typeof ReadFileInputSchema>;
+export declare const ReadDirectoryInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    max_depth: z.ZodDefault<z.ZodNumber>;
+    include_hidden: z.ZodDefault<z.ZodBoolean>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    max_depth: number;
+    recursive: boolean;
+    include_hidden: boolean;
+    pattern?: string | undefined;
+}, {
+    path: string;
+    max_depth?: number | undefined;
+    recursive?: boolean | undefined;
+    include_hidden?: boolean | undefined;
+    pattern?: string | undefined;
+}>;
+export type ReadDirectoryInput = z.infer<typeof ReadDirectoryInputSchema>;
+export declare const WriteFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    encoding: z.ZodDefault<z.ZodString>;
+    create_dirs: z.ZodDefault<z.ZodBoolean>;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+    backup: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    path: string;
+    encoding: string;
+    create_dirs: boolean;
+    overwrite: boolean;
+    backup: boolean;
+}, {
+    content: string;
+    path: string;
+    encoding?: string | undefined;
+    create_dirs?: boolean | undefined;
+    overwrite?: boolean | undefined;
+    backup?: boolean | undefined;
+}>;
+export type WriteFileInput = z.infer<typeof WriteFileInputSchema>;
+export declare const CreateDirectoryInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+}, {
+    path: string;
+    recursive?: boolean | undefined;
+}>;
+export type CreateDirectoryInput = z.infer<typeof CreateDirectoryInputSchema>;
+export declare const CopyFileInputSchema: z.ZodObject<{
+    source: z.ZodString;
+    destination: z.ZodString;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    recursive: boolean;
+    overwrite: boolean;
+    source: string;
+    destination: string;
+}, {
+    source: string;
+    destination: string;
+    recursive?: boolean | undefined;
+    overwrite?: boolean | undefined;
+}>;
+export type CopyFileInput = z.infer<typeof CopyFileInputSchema>;
+export declare const MoveFileInputSchema: z.ZodObject<{
+    source: z.ZodString;
+    destination: z.ZodString;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    overwrite: boolean;
+    source: string;
+    destination: string;
+}, {
+    source: string;
+    destination: string;
+    overwrite?: boolean | undefined;
+}>;
+export type MoveFileInput = z.infer<typeof MoveFileInputSchema>;
+export declare const DeleteFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+    force: boolean;
+}, {
+    path: string;
+    recursive?: boolean | undefined;
+    force?: boolean | undefined;
+}>;
+export type DeleteFileInput = z.infer<typeof DeleteFileInputSchema>;
+export declare const GlobSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    base_path: z.ZodOptional<z.ZodString>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+    include_dirs: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    max_results: number;
+    include_dirs: boolean;
+    base_path?: string | undefined;
+}, {
+    pattern: string;
+    base_path?: string | undefined;
+    max_results?: number | undefined;
+    include_dirs?: boolean | undefined;
+}>;
+export type GlobSearchInput = z.infer<typeof GlobSearchInputSchema>;
+export declare const GrepSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    case_sensitive: z.ZodDefault<z.ZodBoolean>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+    context_lines: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    max_results: number;
+    case_sensitive: boolean;
+    context_lines: number;
+    path?: string | undefined;
+    glob?: string | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+    max_results?: number | undefined;
+    glob?: string | undefined;
+    case_sensitive?: boolean | undefined;
+    context_lines?: number | undefined;
+}>;
+export type GrepSearchInput = z.infer<typeof GrepSearchInputSchema>;
+export declare const FileStatInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export type FileStatInput = z.infer<typeof FileStatInputSchema>;
+export declare const FileExistsInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<["file", "directory", "any"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "file" | "directory" | "any";
+}, {
+    path: string;
+    type?: "file" | "directory" | "any" | undefined;
+}>;
+export type FileExistsInput = z.infer<typeof FileExistsInputSchema>;
+export declare const ScaffoldProjectInputSchema: z.ZodObject<{
+    template: z.ZodString;
+    destination: z.ZodString;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    overwrite: boolean;
+    destination: string;
+    template: string;
+    variables?: Record<string, string> | undefined;
+}, {
+    destination: string;
+    template: string;
+    overwrite?: boolean | undefined;
+    variables?: Record<string, string> | undefined;
+}>;
+export type ScaffoldProjectInput = z.infer<typeof ScaffoldProjectInputSchema>;
+export declare const ListTemplatesInputSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+}, {
+    category?: string | undefined;
+}>;
+export type ListTemplatesInput = z.infer<typeof ListTemplatesInputSchema>;
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

@@ -0,0 +1,146 @@
+/**
+ * MCP File Forge - Type Definitions
+ *
+ * Core types used throughout the server.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Error Codes
+// ============================================================================
+export const ErrorCode = {
+    PATH_OUTSIDE_SANDBOX: 'PATH_OUTSIDE_SANDBOX',
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+    DEPTH_EXCEEDED: 'DEPTH_EXCEEDED',
+    INVALID_ENCODING: 'INVALID_ENCODING',
+    WRITE_DISABLED: 'WRITE_DISABLED',
+    DIRECTORY_NOT_EMPTY: 'DIRECTORY_NOT_EMPTY',
+    ALREADY_EXISTS: 'ALREADY_EXISTS',
+    INVALID_PATH: 'INVALID_PATH',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR',
+};
+// ============================================================================
+// Configuration Types
+// ============================================================================
+/**
+ * Sandbox configuration.
+ */
+export const SandboxConfigSchema = z.object({
+    allowed_paths: z.array(z.string()).default(['.']),
+    denied_paths: z.array(z.string()).optional(),
+    follow_symlinks: z.boolean().default(false),
+    max_file_size: z.number().default(104857600), // 100MB
+    max_depth: z.number().default(20),
+});
+/**
+ * Template configuration.
+ */
+export const TemplateConfigSchema = z.object({
+    paths: z.array(z.string()).default(['./templates']),
+});
+/**
+ * Logging configuration.
+ */
+export const LogConfigSchema = z.object({
+    level: z.enum(['error', 'warn', 'info', 'debug']).default('info'),
+    file: z.string().optional(),
+});
+/**
+ * Full server configuration.
+ */
+export const ServerConfigSchema = z.object({
+    sandbox: SandboxConfigSchema.default({}),
+    templates: TemplateConfigSchema.default({}),
+    logging: LogConfigSchema.default({}),
+    read_only: z.boolean().default(false),
+});
+// ============================================================================
+// Tool Input Schemas
+// ============================================================================
+// Read file input
+export const ReadFileInputSchema = z.object({
+    path: z.string().describe('Absolute or relative path to the file'),
+    encoding: z.string().default('utf-8').describe('File encoding'),
+    start_line: z.number().optional().describe('Start line (1-indexed)'),
+    end_line: z.number().optional().describe('End line (inclusive)'),
+    max_size_kb: z.number().default(10240).describe('Max size in KB'),
+});
+// Read directory input
+export const ReadDirectoryInputSchema = z.object({
+    path: z.string().describe('Path to directory'),
+    recursive: z.boolean().default(false).describe('Include subdirectories'),
+    max_depth: z.number().default(5).describe('Max recursion depth'),
+    include_hidden: z.boolean().default(false).describe('Include hidden files'),
+    pattern: z.string().optional().describe('Glob pattern filter'),
+});
+// Write file input
+export const WriteFileInputSchema = z.object({
+    path: z.string().describe('Path to write to'),
+    content: z.string().describe('Content to write'),
+    encoding: z.string().default('utf-8').describe('File encoding'),
+    create_dirs: z.boolean().default(true).describe('Create parent directories'),
+    overwrite: z.boolean().default(true).describe('Overwrite if exists'),
+    backup: z.boolean().default(false).describe('Create backup before overwrite'),
+});
+// Create directory input
+export const CreateDirectoryInputSchema = z.object({
+    path: z.string().describe('Path to create'),
+    recursive: z.boolean().default(true).describe('Create parent directories'),
+});
+// Copy file input
+export const CopyFileInputSchema = z.object({
+    source: z.string().describe('Source path'),
+    destination: z.string().describe('Destination path'),
+    overwrite: z.boolean().default(false).describe('Overwrite if exists'),
+    recursive: z.boolean().default(true).describe('Copy directories recursively'),
+});
+// Move file input
+export const MoveFileInputSchema = z.object({
+    source: z.string().describe('Source path'),
+    destination: z.string().describe('Destination path'),
+    overwrite: z.boolean().default(false).describe('Overwrite if exists'),
+});
+// Delete file input
+export const DeleteFileInputSchema = z.object({
+    path: z.string().describe('Path to delete'),
+    recursive: z.boolean().default(false).describe('Delete directories recursively'),
+    force: z.boolean().default(false).describe('Ignore errors'),
+});
+// Glob search input
+export const GlobSearchInputSchema = z.object({
+    pattern: z.string().describe('Glob pattern'),
+    base_path: z.string().optional().describe('Base directory'),
+    max_results: z.number().default(1000).describe('Maximum results'),
+    include_dirs: z.boolean().default(false).describe('Include directories'),
+});
+// Grep search input
+export const GrepSearchInputSchema = z.object({
+    pattern: z.string().describe('Regex pattern'),
+    path: z.string().optional().describe('File or directory to search'),
+    glob: z.string().optional().describe('File pattern filter'),
+    case_sensitive: z.boolean().default(true).describe('Case sensitive'),
+    max_results: z.number().default(100).describe('Maximum results'),
+    context_lines: z.number().default(0).describe('Context lines'),
+});
+// File stat input
+export const FileStatInputSchema = z.object({
+    path: z.string().describe('Path to file or directory'),
+});
+// File exists input
+export const FileExistsInputSchema = z.object({
+    path: z.string().describe('Path to check'),
+    type: z.enum(['file', 'directory', 'any']).default('any').describe('Type to check for'),
+});
+// Scaffold project input
+export const ScaffoldProjectInputSchema = z.object({
+    template: z.string().describe('Template name or path'),
+    destination: z.string().describe('Destination directory'),
+    variables: z.record(z.string()).optional().describe('Template variables'),
+    overwrite: z.boolean().default(false).describe('Overwrite existing'),
+});
+// List templates input
+export const ListTemplatesInputSchema = z.object({
+    category: z.string().optional().describe('Filter by category'),
+});
+//# sourceMappingURL=types.js.map

package/build/types.js.map

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

package/build/utils/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MCP File Forge - Error Utilities
+ *
+ * Structured error handling and response formatting.
+ */
+import type { FileForgeError, ToolResult, ErrorCodeType } from '../types.js';
+/**
+ * Create a structured error object.
+ */
+export declare function createError(code: ErrorCodeType, message: string, details?: Record<string, unknown>): FileForgeError;
+/**
+ * Format a FileForgeError as a tool error result.
+ */
+export declare function formatErrorResult(error: FileForgeError): ToolResult;
+/**
+ * Create an error result directly.
+ */
+export declare function errorResult(code: ErrorCodeType, message: string, details?: Record<string, unknown>): ToolResult;
+/**
+ * Format a success result with JSON data.
+ */
+export declare function successResult(data: unknown): ToolResult;
+/**
+ * Wrap a function with error handling.
+ */
+export declare function withErrorHandling<T extends unknown[]>(fn: (...args: T) => Promise<ToolResult>, context: string): (...args: T) => Promise<ToolResult>;
+/**
+ * Validate that a value is defined.
+ */
+export declare function assertDefined<T>(value: T | undefined | null, errorMessage: string): asserts value is T;
+/**
+ * Safe JSON parse with error handling.
+ */
+export declare function safeJsonParse<T>(json: string): T | null;
+/**
+ * Format bytes to human readable string.
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+/**
+ * Truncate a string to a maximum length.
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/build/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI7E;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,cAAc,CAMhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAYnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CAEZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CASvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAuDrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,KAAK,IAAI,CAAC,CAIpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAU/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,MAAM,CAG/E"}