@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/services/narrative/types/narrative.types.d.ts

@@ -1,372 +0,0 @@
-/**
- * Narrative Types - DesignNarrative分析の型定義
- *
- * 世界観・雰囲気（WorldView）とレイアウト構成（LayoutStructure）の
- * 構造化データ型を定義。
- *
- * @module services/narrative/types/narrative.types
- */
-import type { CSSVariableExtractionResult } from "../../visual/css-variable-extractor.service";
-import type { TypographyExtractionResult } from "../../visual/typography-extractor.service";
-import type { MotionDetectionResult } from "../../page/motion-detector.service";
-import type { DetectedSection } from "@reftrixmcp/webdesign-core";
-import type { VisualFeatures } from "../../../tools/page/schemas";
-/**
- * ムードカテゴリ（DesignNarrative.mood_category）
- *
- * Webデザインの全体的な雰囲気を分類
- */
-export type MoodCategory = "professional" | "playful" | "premium" | "tech" | "organic" | "minimal" | "bold" | "elegant" | "friendly" | "artistic" | "trustworthy" | "energetic";
-/**
- * 色彩印象
- */
-export interface ColorImpression {
-    /** 全体的な印象（"warm and inviting", "cool and professional"等） */
-    overall: string;
-    /** 支配的な感情（"trust", "excitement", "calm"等） */
-    dominantEmotion: string;
-    /** 配色調和タイプ */
-    harmony: "complementary" | "analogous" | "monochromatic" | "triadic" | "split-complementary" | "mixed";
-}
-/**
- * タイポグラフィの性格
- */
-export interface TypographyPersonality {
-    /** スタイル（"modern", "classic", "playful", "technical"等） */
-    style: string;
-    /** 読みやすさ */
-    readability: "high" | "medium" | "low";
-    /** 階層の明確さ */
-    hierarchy: "clear" | "subtle" | "flat";
-}
-/**
- * モーションの感情
- */
-export interface MotionEmotion {
-    /** 全体的な印象（"smooth and elegant", "dynamic and playful"等） */
-    overall: string;
-    /** ペース */
-    pace: "slow" | "moderate" | "fast";
-    /** 強度（0-1） */
-    intensity: number;
-    /** prefers-reduced-motion対応 */
-    accessibility: boolean;
-}
-/**
- * 全体的なトーン
- */
-export interface OverallTone {
-    /** プライマリートーン（"professional", "casual", "luxury"等） */
-    primary: string;
-    /** フォーマル度（0-1、0=カジュアル、1=フォーマル） */
-    formality: number;
-    /** エネルギー度（0-1、0=静的、1=動的） */
-    energy: number;
-}
-/**
- * 世界観・雰囲気の分析結果
- */
-export interface WorldViewResult {
-    /** ムードカテゴリ */
-    moodCategory: MoodCategory;
-    /** ムードの説明（自然言語） */
-    moodDescription: string;
-    /** 色彩印象 */
-    colorImpression: ColorImpression;
-    /** タイポグラフィの性格 */
-    typographyPersonality: TypographyPersonality;
-    /** モーションの感情（オプション、モーションがある場合） */
-    motionEmotion?: MotionEmotion;
-    /** 全体的なトーン */
-    overallTone: OverallTone;
-}
-/**
- * グリッドシステム
- */
-export interface GridSystem {
-    /** グリッドタイプ */
-    type: "css-grid" | "flexbox" | "float" | "mixed" | "none";
-    /** カラム数（'fluid'はフルードグリッド） */
-    columns: number | "fluid";
-    /** ガター幅 */
-    gutterWidth?: string;
-    /** コンテナ幅 */
-    containerWidth?: string;
-    /** ブレークポイント */
-    breakpoints?: {
-        mobile?: string;
-        tablet?: string;
-        desktop?: string;
-        wide?: string;
-    };
-}
-/**
- * 視覚的階層
- */
-export interface VisualHierarchy {
-    /** 主要要素（最も目立つ要素） */
-    primaryElements: string[];
-    /** 二次要素 */
-    secondaryElements: string[];
-    /** 三次要素 */
-    tertiaryElements: string[];
-    /** セクション配置パターン */
-    sectionFlow: "linear" | "modular" | "asymmetric";
-    /** 視覚的重み分布 */
-    weightDistribution: {
-        /** 上部（hero area）の重み（0-1） */
-        top: number;
-        /** 中部（content area）の重み（0-1） */
-        middle: number;
-        /** 下部（footer area）の重み（0-1） */
-        bottom: number;
-    };
-}
-/**
- * スペーシングリズム
- */
-export interface SpacingRhythm {
-    /** 基準単位（'8px', '1rem'等） */
-    baseUnit: string;
-    /** スケール倍率 */
-    scale: number[];
-    /** スケール名（検出された場合） */
-    scaleName?: "fibonacci" | "linear" | "geometric" | "custom";
-    /** セクション間スペーシング */
-    sectionGaps: {
-        min: string;
-        max: string;
-        average: string;
-    };
-}
-/**
- * セクション間関係性
- */
-export interface SectionRelationship {
-    /** ソースセクションID */
-    sourceId: string;
-    /** ターゲットセクションID */
-    targetId: string;
-    /** 関係タイプ */
-    relationshipType: "follows" | "contains" | "parallels" | "contrasts";
-    /** 関係の強さ（0-1） */
-    strength: number;
-}
-/**
- * グラフィック要素
- */
-export interface GraphicElements {
-    /** 画像配置パターン */
-    imageLayout: {
-        /** パターン */
-        pattern: "full-bleed" | "contained" | "scattered" | "grid" | "none";
-        /** アスペクト比 */
-        aspectRatios: string[];
-        /** 配置位置 */
-        positions: ("hero" | "inline" | "background" | "decorative")[];
-    };
-    /** 装飾要素 */
-    decorations: {
-        hasGradients: boolean;
-        hasShadows: boolean;
-        hasBorders: boolean;
-        hasIllustrations: boolean;
-    };
-    /** 視覚的バランス */
-    visualBalance: {
-        /** 対称性 */
-        symmetry: "symmetric" | "asymmetric" | "dynamic";
-        /** 密度 */
-        density: "sparse" | "balanced" | "dense";
-        /** ホワイトスペース比率（0-1） */
-        whitespace: number;
-    };
-}
-/**
- * レイアウト構成の分析結果
- */
-export interface LayoutStructureResult {
-    /** グリッドシステム */
-    gridSystem: GridSystem;
-    /** 視覚的階層 */
-    visualHierarchy: VisualHierarchy;
-    /** スペーシングリズム */
-    spacingRhythm: SpacingRhythm;
-    /** セクション間関係性 */
-    sectionRelationships: SectionRelationship[];
-    /** グラフィック要素 */
-    graphicElements: GraphicElements;
-}
-/**
- * 信頼度スコア
- */
-export interface ConfidenceScore {
-    /** 総合信頼度（0-1） */
-    overall: number;
-    /** 世界観分析信頼度（0-1） */
-    worldView: number;
-    /** レイアウト分析信頼度（0-1） */
-    layoutStructure: number;
-    /** 詳細内訳 */
-    breakdown: {
-        /** Vision LLM分析信頼度 */
-        visionAnalysis: number;
-        /** CSS静的分析信頼度 */
-        cssStaticAnalysis: number;
-        /** HTML構造分析信頼度 */
-        htmlStructureAnalysis: number;
-        /** モーション分析信頼度 */
-        motionAnalysis: number;
-    };
-}
-/**
- * 既存分析結果（page.analyzeから渡す場合）
- */
-export interface ExistingAnalysisResults {
-    cssVariables?: CSSVariableExtractionResult;
-    typography?: TypographyExtractionResult;
-    motionPatterns?: MotionDetectionResult;
-    sections?: DetectedSection[];
-    visualFeatures?: VisualFeatures;
-}
-/**
- * 分析オプション
- */
-export interface NarrativeAnalysisOptions {
-    /** Vision分析を強制（フォールバックなし） */
-    forceVision?: boolean;
-    /** Vision分析タイムアウト（ms） */
-    visionTimeoutMs?: number;
-    /** Embedding生成を含むか（default: true） */
-    generateEmbedding?: boolean;
-}
-/**
- * 分析入力
- */
-export interface NarrativeAnalysisInput {
-    /** WebPage ID（既存WebPageレコードがある場合） */
-    webPageId?: string;
-    /** Base64スクリーンショット */
-    screenshot?: string;
-    /** サニタイズ済みHTML */
-    html: string;
-    /** 外部CSS（取得済みの場合） */
-    externalCss?: string;
-    /** 既存分析結果 */
-    existingAnalysis?: ExistingAnalysisResults;
-    /** 分析オプション */
-    options?: NarrativeAnalysisOptions;
-}
-/**
- * 分析メタデータ
- */
-export interface NarrativeAnalysisMetadata {
-    /** Embedding生成に使用したテキスト表現 */
-    textRepresentation: string;
-    /** 768次元Embedding（生成した場合） */
-    embedding?: number[];
-    /** 信頼度スコア */
-    confidence: ConfidenceScore;
-    /** 分析所要時間（ms） */
-    analysisTimeMs: number;
-    /** Vision分析が使用されたか */
-    visionUsed: boolean;
-    /** フォールバック理由（Vision未使用時） */
-    fallbackReason?: string;
-}
-/**
- * 分析結果
- */
-export interface NarrativeAnalysisResult {
-    /** 世界観・雰囲気 */
-    worldView: WorldViewResult;
-    /** レイアウト構成 */
-    layoutStructure: LayoutStructureResult;
-    /** メタデータ */
-    metadata: NarrativeAnalysisMetadata;
-}
-/**
- * 保存済みNarrative
- */
-export interface SavedNarrative {
-    /** DesignNarrative ID */
-    id: string;
-    /** WebPage ID */
-    webPageId: string;
-    /** Embedding がDBに保存されたか */
-    embeddingSaved: boolean;
-    /** 作成日時 */
-    createdAt: Date;
-    /** 更新日時 */
-    updatedAt: Date;
-}
-/**
- * 検索オプション
- */
-export interface NarrativeSearchOptions {
-    /** 検索クエリ */
-    query: string;
-    /** 取得件数（default: 10） */
-    limit?: number;
-    /** Vector検索の重み（default: 0.6） */
-    vectorWeight?: number;
-    /** Full-text検索の重み（default: 0.4） */
-    fulltextWeight?: number;
-    /** フィルター */
-    filters?: {
-        /** ムードカテゴリでフィルター */
-        moodCategory?: MoodCategory[];
-        /** 最小信頼度でフィルター */
-        minConfidence?: number;
-    };
-}
-/**
- * 検索結果
- */
-export interface NarrativeSearchResult {
-    /** DesignNarrative ID */
-    id: string;
-    /** WebPage ID */
-    webPageId: string;
-    /** RRF結合スコア */
-    score: number;
-    /** Vector検索スコア */
-    vectorScore: number;
-    /** Full-text検索スコア */
-    fulltextScore: number;
-    /** ムードカテゴリ */
-    moodCategory: MoodCategory;
-    /** ムードの説明 */
-    moodDescription: string;
-    /** 信頼度 */
-    confidence: number;
-}
-/**
- * NarrativeAnalysisService インターフェース
- */
-export interface INarrativeAnalysisService {
-    /**
-     * Webページを分析してNarrativeを生成
-     */
-    analyze(input: NarrativeAnalysisInput): Promise<NarrativeAnalysisResult>;
-    /**
-     * 分析結果をDBに保存
-     */
-    save(webPageId: string, result: NarrativeAnalysisResult): Promise<SavedNarrative>;
-    /**
-     * 分析と保存を一括実行
-     */
-    analyzeAndSave(input: NarrativeAnalysisInput): Promise<SavedNarrative>;
-    /**
-     * Narrative検索（ベクトル検索のみ）
-     */
-    search(options: NarrativeSearchOptions): Promise<NarrativeSearchResult[]>;
-    /**
-     * Narrative Hybrid検索（ベクトル + 全文検索 → RRF マージ）
-     *
-     * 全文検索が失敗した場合はベクトル検索のみにフォールバック。
-     * メソッドが存在しない場合は search() にフォールバック。
-     */
-    searchHybrid?: (options: NarrativeSearchOptions) => Promise<NarrativeSearchResult[]>;
-}
-//# sourceMappingURL=narrative.types.d.ts.map

package/dist/services/narrative/types/narrative.types.d.ts.map

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

package/dist/services/narrative/types/narrative.types.js

@@ -1,5 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=narrative.types.js.map

package/dist/services/narrative/types/narrative.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"narrative.types.js","sourceRoot":"","sources":["../../../../src/services/narrative/types/narrative.types.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC"}

package/dist/services/orphaned-job-utils.d.ts

@@ -1,62 +0,0 @@
-/**
- * Orphaned job の分類
- *
- * - db_saved_but_stuck: DB保存済みだがBullMQがactive（progress >= 90%）
- * - processing_interrupted: 処理中に中断（progress > 0 && < 90%）
- * - never_started: 処理が開始されていない（progress = 0）
- */
-export type OrphanedJobCategory = "db_saved_but_stuck" | "processing_interrupted" | "never_started";
-/**
- * ジョブの進捗がDB保存済みレベルに達しているか判定する
- *
- * progress >= DB_SAVED_PROGRESS_THRESHOLD (90%) ならば、
- * Layout/Motion/QualityのDB保存は完了している可能性が高い。
- *
- * @param progress - ジョブの進捗（0-100）
- * @returns DB保存済みレベルに達しているか
- */
-export declare function isDbSavedProgress(progress: number): boolean;
-/**
- * progress と processedOn からジョブカテゴリを判定する
- *
- * 全てのカテゴリ分類はこの関数に集約される。
- * categorizeOrphanedJob や handleStalledJob から使用される。
- *
- * @param progress - ジョブの進捗（0-100）
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined/null は未開始
- * @returns カテゴリ
- */
-export declare function categorizeByProgress(progress: number, processedOn: number | undefined | null): OrphanedJobCategory;
-/**
- * 経過時間ベースで orphaned active job を判定する（QueueAdapter用）
- *
- * queue-cleanup.service.ts で使用。QueueAdapterのJobInfoから取得できる
- * 最小限の情報（processedOn, progress）で判定する。
- *
- * 以下の条件のいずれかを満たす場合、orphaned と判定する:
- * - processedOn が undefined/null
- * - processedOn から thresholdMs 以上経過 かつ progress < 100
- *
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined/null の場合は orphaned
- * @param progress - ジョブの進捗（0-100）
- * @param thresholdMs - orphaned 判定の閾値（ms）
- * @returns orphaned かどうか
- */
-export declare function isOrphanedByElapsedTime(processedOn: number | undefined | null, progress: number, thresholdMs: number): boolean;
-/**
- * ロック期限ベースで orphaned active job を判定する（BullMQ直接操作用）
- *
- * worker-stall-recovery.service.ts で使用。BullMQのJob情報から取得できる
- * 詳細情報（state, processedOn, lockDurationMs）で判定する。
- *
- * 以下の条件をすべて満たす場合にorphanedとみなす:
- * 1. 状態がactive
- * 2. processedOnが未設定、または lockDuration + STALL_MARGIN_MS を超過
- *
- * @param state - BullMQ Job state
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined の場合は orphaned
- * @param lockDurationMs - ワーカーのlockDuration設定（ms）
- * @returns orphaned かどうか
- */
-export declare function isOrphanedByLockExpiry(state: string, processedOn: number | undefined | null, lockDurationMs: number): boolean;
-//# sourceMappingURL=orphaned-job-utils.d.ts.map

package/dist/services/orphaned-job-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orphaned-job-utils.d.ts","sourceRoot":"","sources":["../../src/services/orphaned-job-utils.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,wBAAwB,GAAG,eAAe,CAAC;AAMpG;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACrC,mBAAmB,CAWrB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACtC,cAAc,EAAE,MAAM,GACrB,OAAO,CAgBT"}

package/dist/services/orphaned-job-utils.js

@@ -1,130 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDbSavedProgress = isDbSavedProgress;
-exports.categorizeByProgress = categorizeByProgress;
-exports.isOrphanedByElapsedTime = isOrphanedByElapsedTime;
-exports.isOrphanedByLockExpiry = isOrphanedByLockExpiry;
-/**
- * Orphaned Job Utilities - 共通判定ヘルパー
- *
- * orphaned job 判定ロジックの共通部分を集約する。
- *
- * 2つの異なるコンテキストで orphaned job 判定が行われる:
- * 1. QueueAdapter 経由（queue-cleanup.service.ts）:
- *    - 簡易な時間ベース判定（processedOn + elapsed + progress）
- *    - thresholdMs パラメータで閾値を外部から指定
- *
- * 2. BullMQ 直接操作（worker-stall-recovery.service.ts）:
- *    - 詳細な state + lockDuration + STALL_MARGIN_MS 判定
- *    - active状態のジョブのみ対象
- *
- * 共通化される要素:
- * - DB_SAVED_PROGRESS_THRESHOLD (worker-constants.ts)
- * - STALL_MARGIN_MS (worker-constants.ts)
- * - isDbSavedProgress: progress判定ヘルパー
- * - isOrphanedByElapsedTime: 時間ベース判定（queue-cleanup用）
- * - isOrphanedByLockExpiry: ロック期限ベース判定（stall-recovery用）
- *
- * @module services/orphaned-job-utils
- */
-const worker_constants_1 = require("./worker-constants");
-// ============================================================================
-// Progress Helpers
-// ============================================================================
-/**
- * ジョブの進捗がDB保存済みレベルに達しているか判定する
- *
- * progress >= DB_SAVED_PROGRESS_THRESHOLD (90%) ならば、
- * Layout/Motion/QualityのDB保存は完了している可能性が高い。
- *
- * @param progress - ジョブの進捗（0-100）
- * @returns DB保存済みレベルに達しているか
- */
-function isDbSavedProgress(progress) {
-    return progress >= worker_constants_1.DB_SAVED_PROGRESS_THRESHOLD;
-}
-// ============================================================================
-// Category Classification
-// ============================================================================
-/**
- * progress と processedOn からジョブカテゴリを判定する
- *
- * 全てのカテゴリ分類はこの関数に集約される。
- * categorizeOrphanedJob や handleStalledJob から使用される。
- *
- * @param progress - ジョブの進捗（0-100）
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined/null は未開始
- * @returns カテゴリ
- */
-function categorizeByProgress(progress, processedOn) {
-    if (progress >= worker_constants_1.DB_SAVED_PROGRESS_THRESHOLD) {
-        return "db_saved_but_stuck";
-    }
-    if (progress > 0) {
-        return "processing_interrupted";
-    }
-    if (processedOn === undefined || processedOn === null) {
-        return "never_started";
-    }
-    return "never_started";
-}
-// ============================================================================
-// Orphaned Job Detection: Elapsed Time Based (for QueueAdapter)
-// ============================================================================
-/**
- * 経過時間ベースで orphaned active job を判定する（QueueAdapter用）
- *
- * queue-cleanup.service.ts で使用。QueueAdapterのJobInfoから取得できる
- * 最小限の情報（processedOn, progress）で判定する。
- *
- * 以下の条件のいずれかを満たす場合、orphaned と判定する:
- * - processedOn が undefined/null
- * - processedOn から thresholdMs 以上経過 かつ progress < 100
- *
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined/null の場合は orphaned
- * @param progress - ジョブの進捗（0-100）
- * @param thresholdMs - orphaned 判定の閾値（ms）
- * @returns orphaned かどうか
- */
-function isOrphanedByElapsedTime(processedOn, progress, thresholdMs) {
-    if (processedOn == null) {
-        return true;
-    }
-    const elapsed = Date.now() - processedOn;
-    return elapsed >= thresholdMs && progress < 100;
-}
-// ============================================================================
-// Orphaned Job Detection: Lock Expiry Based (for BullMQ direct)
-// ============================================================================
-/**
- * ロック期限ベースで orphaned active job を判定する（BullMQ直接操作用）
- *
- * worker-stall-recovery.service.ts で使用。BullMQのJob情報から取得できる
- * 詳細情報（state, processedOn, lockDurationMs）で判定する。
- *
- * 以下の条件をすべて満たす場合にorphanedとみなす:
- * 1. 状態がactive
- * 2. processedOnが未設定、または lockDuration + STALL_MARGIN_MS を超過
- *
- * @param state - BullMQ Job state
- * @param processedOn - 処理開始タイムスタンプ（ms）。undefined の場合は orphaned
- * @param lockDurationMs - ワーカーのlockDuration設定（ms）
- * @returns orphaned かどうか
- */
-function isOrphanedByLockExpiry(state, processedOn, lockDurationMs) {
-    // active状態でないジョブは対象外
-    if (state !== "active") {
-        return false;
-    }
-    // processedOnが未設定 = lockを取得したがprocessing関数が開始されていない
-    if (processedOn === undefined || processedOn === null) {
-        return true;
-    }
-    // lockDuration + マージンを超過しているか判定
-    const elapsed = Date.now() - processedOn;
-    const threshold = lockDurationMs + worker_constants_1.STALL_MARGIN_MS;
-    return elapsed > threshold;
-}
-//# sourceMappingURL=orphaned-job-utils.js.map

package/dist/services/orphaned-job-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orphaned-job-utils.js","sourceRoot":"","sources":["../../src/services/orphaned-job-utils.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;AAsDzC,8CAEC;AAgBD,oDAcC;AAqBD,0DAUC;AAqBD,wDAoBC;AA5JD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,yDAAkF;AAelF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,IAAI,8CAA2B,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,WAAsC;IAEtC,IAAI,QAAQ,IAAI,8CAA2B,EAAE,CAAC;QAC5C,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,gEAAgE;AAChE,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,SAAgB,uBAAuB,CACrC,WAAsC,EACtC,QAAgB,EAChB,WAAmB;IAEnB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;IACzC,OAAO,OAAO,IAAI,WAAW,IAAI,QAAQ,GAAG,GAAG,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,gEAAgE;AAChE,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,SAAgB,sBAAsB,CACpC,KAAa,EACb,WAAsC,EACtC,cAAsB;IAEtB,qBAAqB;IACrB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oDAAoD;IACpD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;IACzC,MAAM,SAAS,GAAG,cAAc,GAAG,kCAAe,CAAC;IAEnD,OAAO,OAAO,GAAG,SAAS,CAAC;AAC7B,CAAC"}