@reftrixmcp/mcp-server 0.1.7

package/dist/lib/project-context.js

@@ -0,0 +1,109 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultProjectId = exports.resolveProjectId = exports.isValidUUIDv7 = void 0;
+/**
+ * Project Context Management
+ *
+ * Provides utilities for resolving project_id with automatic fallback
+ * to DEFAULT_PROJECT_ID environment variable.
+ *
+ * Priority Order:
+ * 1. Explicit input (tool input.project_id)
+ * 2. Environment variable (DEFAULT_PROJECT_ID)
+ * 3. Undefined (original behavior)
+ *
+ * @module lib/project-context
+ * @see docs/specs/project-id-auto-injection-spec.md
+ */
+/**
+ * UUIDv7 validation regex pattern
+ *
+ * Format: xxxxxxxx-xxxx-7xxx-[89ab]xxx-xxxxxxxxxxxx
+ * - Version 7 indicated by '7' at position 13
+ * - Variant bits [89ab] at position 17
+ */
+const UUIDV7_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Validates if a string is a valid UUIDv7 format
+ *
+ * @param id - String to validate
+ * @returns true if valid UUIDv7 format, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidUUIDv7('019acd22-c570-706c-8906-6c855874bc4d') // true
+ * isValidUUIDv7('not-a-uuid') // false
+ * isValidUUIDv7(null) // false
+ * ```
+ */
+const isValidUUIDv7 = (id) => {
+    if (!id || typeof id !== "string") {
+        return false;
+    }
+    return UUIDV7_PATTERN.test(id);
+};
+exports.isValidUUIDv7 = isValidUUIDv7;
+/**
+ * Resolves project_id with automatic fallback to DEFAULT_PROJECT_ID
+ *
+ * Priority:
+ * 1. If inputProjectId is provided and valid, use it
+ * 2. If DEFAULT_PROJECT_ID env var is set and valid, use it
+ * 3. Otherwise, return undefined
+ *
+ * @param inputProjectId - Explicit project_id from tool input
+ * @returns Resolved project_id or undefined
+ *
+ * @example
+ * ```typescript
+ * // With explicit input
+ * resolveProjectId('019acd22-c570-706c-8906-6c855874bc4d')
+ * // Returns: '019acd22-c570-706c-8906-6c855874bc4d'
+ *
+ * // Without input, uses DEFAULT_PROJECT_ID from env
+ * process.env.DEFAULT_PROJECT_ID = '019acd22-c570-706c-8906-6c855874bc4d'
+ * resolveProjectId(undefined)
+ * // Returns: '019acd22-c570-706c-8906-6c855874bc4d'
+ *
+ * // Neither input nor env set
+ * delete process.env.DEFAULT_PROJECT_ID
+ * resolveProjectId(undefined)
+ * // Returns: undefined
+ * ```
+ */
+const resolveProjectId = (inputProjectId) => {
+    // Priority 1: Use explicit input if valid
+    if (inputProjectId && (0, exports.isValidUUIDv7)(inputProjectId)) {
+        return inputProjectId;
+    }
+    // Handle empty string as undefined
+    if (inputProjectId === "") {
+        // Fall through to env var check
+    }
+    else if (inputProjectId) {
+        // Input provided but invalid UUID format - still return it for backwards compatibility
+        // The API layer will validate and reject if needed
+        return inputProjectId;
+    }
+    // Priority 2: Use environment variable if valid
+    const envProjectId = process.env.DEFAULT_PROJECT_ID;
+    if (envProjectId && (0, exports.isValidUUIDv7)(envProjectId)) {
+        return envProjectId;
+    }
+    // Priority 3: Return undefined (original behavior)
+    return undefined;
+};
+exports.resolveProjectId = resolveProjectId;
+/**
+ * Gets the DEFAULT_PROJECT_ID from environment
+ * Useful for debugging and logging
+ *
+ * @returns DEFAULT_PROJECT_ID value or undefined
+ */
+const getDefaultProjectId = () => {
+    return process.env.DEFAULT_PROJECT_ID;
+};
+exports.getDefaultProjectId = getDefaultProjectId;
+//# sourceMappingURL=project-context.js.map

package/dist/lib/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/lib/project-context.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,wEAAwE,CAAC;AAEhG;;;;;;;;;;;;GAYG;AACI,MAAM,aAAa,GAAG,CAAC,EAA6B,EAAW,EAAE;IACtE,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC;AALW,QAAA,aAAa,iBAKxB;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACI,MAAM,gBAAgB,GAAG,CAAC,cAAuB,EAAsB,EAAE;IAC9E,0CAA0C;IAC1C,IAAI,cAAc,IAAI,IAAA,qBAAa,EAAC,cAAc,CAAC,EAAE,CAAC;QACpD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,mCAAmC;IACnC,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QAC1B,gCAAgC;IAClC,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,uFAAuF;QACvF,mDAAmD;QACnD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gDAAgD;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACpD,IAAI,YAAY,IAAI,IAAA,qBAAa,EAAC,YAAY,CAAC,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,mDAAmD;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAvBW,QAAA,gBAAgB,oBAuB3B;AAEF;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,GAAuB,EAAE;IAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B"}

package/dist/middleware/args-type-coercion.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 型変換マップ
+ * キー: ドット区切りのフィールドパス（例: "limit", "options.timeout"）
+ * 値: 変換先の型（"number" | "boolean"）
+ */
+export type CoercionMap = Map<string, "number" | "boolean">;
+/**
+ * JSON Schema型定義のインターフェース
+ */
+interface JsonSchemaProperty {
+    type?: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    items?: JsonSchemaProperty;
+    default?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * JSON Schemaからフィールドの型変換マップを構築する
+ *
+ * スキーマのプロパティを再帰的に走査し、number/integer/boolean型のフィールドを
+ * ドット区切りパスとして記録する。
+ *
+ * @param schema - JSON Schemaオブジェクト
+ * @param prefix - フィールドパスのプレフィックス（再帰用）
+ * @returns 型変換マップ
+ */
+export declare function buildCoercionMap(schema: JsonSchemaProperty, prefix?: string): CoercionMap;
+/**
+ * JSON Schemaの型定義に基づいてMCPツール引数の型変換を行う
+ *
+ * MCP クライアントが数値・ブーリアンパラメータを文字列として送信した場合に、
+ * スキーマの型定義に基づいて自動的に変換する。
+ *
+ * 変換ルール:
+ * - type: "number" / "integer": 数値文字列 → number（非数値文字列はそのまま）
+ * - type: "boolean": "true"/"false" → boolean（他の文字列はそのまま）
+ *
+ * 変換できない値はそのまま渡し、後段のZodバリデーションでエラーとする。
+ * 元のargsオブジェクトは変更しない（新しいオブジェクトを返す）。
+ *
+ * @param args - MCPツール引数
+ * @param schema - ツールのJSON Schema（inputSchema）
+ * @returns 型変換後の新しい引数オブジェクト
+ */
+export declare function coerceArgs(args: Record<string, unknown>, schema: JsonSchemaProperty): Record<string, unknown>;
+/**
+ * ツール名に対応する型変換マップをキャッシュ付きで取得する
+ *
+ * @param toolName - MCPツール名
+ * @param schema - ツールのJSON Schema
+ * @returns 型変換マップ
+ */
+export declare function getCoercionMap(toolName: string, schema: JsonSchemaProperty): CoercionMap;
+/**
+ * キャッシュをクリアする（テスト用）
+ */
+export declare function clearCoercionMapCache(): void;
+export {};
+//# sourceMappingURL=args-type-coercion.d.ts.map

package/dist/middleware/args-type-coercion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args-type-coercion.d.ts","sourceRoot":"","sources":["../../src/middleware/args-type-coercion.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;AAE5D;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAW,GAAG,WAAW,CAwB7F;AAyFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAQD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,WAAW,CASxF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/middleware/args-type-coercion.js

@@ -0,0 +1,187 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCoercionMap = buildCoercionMap;
+exports.coerceArgs = coerceArgs;
+exports.getCoercionMap = getCoercionMap;
+exports.clearCoercionMapCache = clearCoercionMapCache;
+/**
+ * MCP引数型変換ミドルウェア
+ *
+ * MCP プロトコル経由でツールに渡されるパラメータは、一部のクライアントが
+ * 数値やブーリアンを文字列としてシリアライズする場合がある。
+ * このミドルウェアはJSON Schemaの型定義に基づいて、自動的に型変換を行う。
+ *
+ * 例:
+ * - limit: "20" (string) → limit: 20 (number)
+ * - include_html: "true" (string) → include_html: true (boolean)
+ *
+ * @module middleware/args-type-coercion
+ */
+const logger_1 = require("../utils/logger");
+/**
+ * JSON Schemaからフィールドの型変換マップを構築する
+ *
+ * スキーマのプロパティを再帰的に走査し、number/integer/boolean型のフィールドを
+ * ドット区切りパスとして記録する。
+ *
+ * @param schema - JSON Schemaオブジェクト
+ * @param prefix - フィールドパスのプレフィックス（再帰用）
+ * @returns 型変換マップ
+ */
+function buildCoercionMap(schema, prefix = "") {
+    const map = new Map();
+    if (schema.type !== "object" || !schema.properties) {
+        return map;
+    }
+    for (const [key, prop] of Object.entries(schema.properties)) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        if (prop.type === "number" || prop.type === "integer") {
+            map.set(fullPath, "number");
+        }
+        else if (prop.type === "boolean") {
+            map.set(fullPath, "boolean");
+        }
+        else if (prop.type === "object" && prop.properties) {
+            // 再帰的にネストされたオブジェクトを処理
+            const nestedMap = buildCoercionMap(prop, fullPath);
+            for (const [nestedKey, nestedType] of nestedMap) {
+                map.set(nestedKey, nestedType);
+            }
+        }
+    }
+    return map;
+}
+/**
+ * 文字列を数値に安全に変換する
+ *
+ * @param value - 変換対象の値
+ * @returns 数値に変換できた場合はnumber、できない場合は元の値
+ */
+function tryCoerceToNumber(value) {
+    if (typeof value === "number") {
+        return value;
+    }
+    if (typeof value !== "string" || value === "") {
+        return value;
+    }
+    const num = Number(value);
+    if (Number.isNaN(num)) {
+        return value;
+    }
+    return num;
+}
+/**
+ * 文字列をブーリアンに安全に変換する
+ *
+ * "true" → true, "false" → false のみ変換
+ * それ以外の文字列は元の値を返す
+ *
+ * @param value - 変換対象の値
+ * @returns ブーリアンに変換できた場合はboolean、できない場合は元の値
+ */
+function tryCoerceToBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value !== "string") {
+        return value;
+    }
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    return value;
+}
+/**
+ * 型変換マップに基づいてオブジェクトのフィールドを再帰的に変換する
+ *
+ * @param obj - 変換対象のオブジェクト
+ * @param coercionMap - 型変換マップ
+ * @param prefix - フィールドパスのプレフィックス（再帰用）
+ * @returns 変換後の新しいオブジェクト（元のオブジェクトは変更しない）
+ */
+function applyCoercion(obj, coercionMap, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        const targetType = coercionMap.get(fullPath);
+        if (targetType === "number") {
+            const coerced = tryCoerceToNumber(value);
+            if (coerced !== value) {
+                logger_1.logger.debug(`[ArgsCoercion] Coerced ${fullPath}: "${value}" → ${coerced} (number)`);
+            }
+            result[key] = coerced;
+        }
+        else if (targetType === "boolean") {
+            const coerced = tryCoerceToBoolean(value);
+            if (coerced !== value) {
+                logger_1.logger.debug(`[ArgsCoercion] Coerced ${fullPath}: "${value}" → ${coerced} (boolean)`);
+            }
+            result[key] = coerced;
+        }
+        else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            // ネストされたオブジェクトを再帰的に処理
+            result[key] = applyCoercion(value, coercionMap, fullPath);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * JSON Schemaの型定義に基づいてMCPツール引数の型変換を行う
+ *
+ * MCP クライアントが数値・ブーリアンパラメータを文字列として送信した場合に、
+ * スキーマの型定義に基づいて自動的に変換する。
+ *
+ * 変換ルール:
+ * - type: "number" / "integer": 数値文字列 → number（非数値文字列はそのまま）
+ * - type: "boolean": "true"/"false" → boolean（他の文字列はそのまま）
+ *
+ * 変換できない値はそのまま渡し、後段のZodバリデーションでエラーとする。
+ * 元のargsオブジェクトは変更しない（新しいオブジェクトを返す）。
+ *
+ * @param args - MCPツール引数
+ * @param schema - ツールのJSON Schema（inputSchema）
+ * @returns 型変換後の新しい引数オブジェクト
+ */
+function coerceArgs(args, schema) {
+    const coercionMap = buildCoercionMap(schema);
+    if (coercionMap.size === 0) {
+        return args;
+    }
+    return applyCoercion(args, coercionMap);
+}
+/**
+ * ツール名とJSON Schemaのキャッシュマップ
+ * サーバー起動後に一度だけ構築し、以降はキャッシュから取得する
+ */
+const coercionMapCache = new Map();
+/**
+ * ツール名に対応する型変換マップをキャッシュ付きで取得する
+ *
+ * @param toolName - MCPツール名
+ * @param schema - ツールのJSON Schema
+ * @returns 型変換マップ
+ */
+function getCoercionMap(toolName, schema) {
+    const cached = coercionMapCache.get(toolName);
+    if (cached) {
+        return cached;
+    }
+    const map = buildCoercionMap(schema);
+    coercionMapCache.set(toolName, map);
+    return map;
+}
+/**
+ * キャッシュをクリアする（テスト用）
+ */
+function clearCoercionMapCache() {
+    coercionMapCache.clear();
+}
+//# sourceMappingURL=args-type-coercion.js.map

package/dist/middleware/args-type-coercion.js.map

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

package/dist/middleware/auth.d.ts

@@ -0,0 +1,122 @@
+/**
+ * ユーザーロール
+ */
+export type Role = "VIEWER" | "USER" | "ADMIN";
+/**
+ * 認証コンテキスト
+ * ツール実行時に渡される認証情報
+ */
+export interface AuthContext {
+    /** ユーザーID */
+    userId: string;
+    /** ユーザーのロール */
+    role: Role;
+    /** 付与されたパーミッション */
+    permissions: string[];
+    /** 認証方式 */
+    authMethod: "api_key" | "jwt" | "none";
+    /** 認証日時 */
+    authenticatedAt: Date;
+}
+/**
+ * 認証ミドルウェアのオプション
+ */
+export interface AuthMiddlewareOptions {
+    /** 認証を有効化するか（デフォルト: false = 後方互換性維持） */
+    enabled?: boolean;
+    /** 認証なしでアクセス可能なツール */
+    publicTools?: string[];
+}
+/**
+ * 認証エラーコード
+ */
+export type AuthErrorCode = "UNAUTHORIZED" | "FORBIDDEN" | "INVALID_API_KEY" | "EXPIRED_TOKEN";
+/**
+ * 認証結果
+ */
+export interface AuthResult {
+    /** 認証成功 */
+    success: boolean;
+    /** 失敗理由 */
+    error?: {
+        code: AuthErrorCode;
+        message: string;
+    };
+    /** 認証コンテキスト（成功時） */
+    context?: AuthContext;
+}
+/**
+ * 認証ミドルウェアのインスタンス
+ */
+export interface AuthMiddlewareInstance {
+    /** 認証チェック関数 */
+    checkAuth: (toolName: string, apiKey: string | undefined) => Promise<AuthResult>;
+    /** オプション設定 */
+    options: Required<AuthMiddlewareOptions>;
+}
+/**
+ * パーミッション定義（WebDesign専用）
+ * 全パーミッションの一覧
+ */
+export declare const PERMISSIONS: {
+    readonly SYSTEM_READ: "system:read";
+    readonly SYSTEM_HEALTH: "system:health";
+    readonly SYSTEM_ADMIN: "system:admin";
+    readonly LAYOUT_READ: "layout:read";
+    readonly LAYOUT_WRITE: "layout:write";
+    readonly LAYOUT_TRANSFORM: "layout:transform";
+    readonly MOTION_READ: "motion:read";
+    readonly MOTION_TRANSFORM: "motion:transform";
+    readonly QUALITY_READ: "quality:read";
+    readonly QUALITY_WRITE: "quality:write";
+    readonly PROJECT_READ: "project:read";
+    readonly DESIGN_REVIEW: "design:review";
+    readonly DESIGN_WRITE: "design:write";
+    readonly STYLE_READ: "style:read";
+    readonly NARRATIVE_READ: "narrative:read";
+    readonly BACKGROUND_READ: "background:read";
+    readonly RESPONSIVE_READ: "responsive:read";
+    readonly PREFERENCE_READ: "preference:read";
+    readonly PREFERENCE_WRITE: "preference:write";
+};
+export type Permission = (typeof PERMISSIONS)[keyof typeof PERMISSIONS];
+/**
+ * ロールごとのパーミッション（WebDesign専用）
+ */
+export declare const ROLES: Record<Role, string[]>;
+/**
+ * ツールごとの必要パーミッション（WebDesign専用）
+ */
+export declare const TOOL_PERMISSIONS: Record<string, string[]>;
+/**
+ * デフォルトの公開ツール（認証不要）
+ * 注意: allToolDefinitions に登録されているツールのみを含めること
+ */
+export declare const PUBLIC_TOOLS: string[];
+/**
+ * APIキーを検証してAuthContextを返す
+ *
+ * @param apiKey - 検証するAPIキー
+ * @returns 認証成功時はAuthContext、失敗時はnull
+ */
+export declare function validateApiKey(apiKey: string | undefined): Promise<AuthContext | null>;
+/**
+ * 認証コンテキストがツールに対する権限を持つかチェック
+ *
+ * deny-by-default ポリシー:
+ * - TOOL_PERMISSIONS に定義されていないツールは拒否
+ * - これにより未登録ツールへの不正アクセスを防止
+ *
+ * @param context - 認証コンテキスト
+ * @param toolName - ツール名
+ * @returns 権限がある場合はtrue
+ */
+export declare function checkPermission(context: AuthContext, toolName: string): boolean;
+/**
+ * 認証ミドルウェアを作成
+ *
+ * @param options - オプション設定
+ * @returns 認証ミドルウェアインスタンス
+ */
+export declare function createAuthMiddleware(options?: AuthMiddlewareOptions): AuthMiddlewareInstance;
+//# sourceMappingURL=auth.d.ts.map

package/dist/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/middleware/auth.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,eAAe;IACf,IAAI,EAAE,IAAI,CAAC;IAEX,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,WAAW;IACX,UAAU,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IAEvC,WAAW;IACX,eAAe,EAAE,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,oBAAoB;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjF,cAAc;IACd,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CAC1C;AAMD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;CA+Bd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAqDxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAoDrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,UAAoB,CAAC;AA6D9C;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiG5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA+B/E;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,sBAAsB,CAkF5F"}