@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/step6-design.d.ts

@@ -0,0 +1,986 @@
+import { z } from "zod";
+import { type SiteDesignRadiusId } from "./site-design-presets.js";
+/**
+ * 审美说明上限 300 字。用户自由文本，服务端一律原样透传：不做替换、不截断
+ * 关键词、不做正则规整 —— 这类处理在本仓有过把正文改坏的实际教训。
+ */
+export declare const AESTHETIC_NOTE_MAX_LENGTH = 300;
+export declare const Step6ColorSeedsSchema: z.ZodObject<{
+    primary: z.ZodString;
+    accent: z.ZodString;
+    foreground: z.ZodString;
+}, z.core.$strict>;
+/**
+ * 设计推荐返回的一张主题卡。命名为 `Ai` 是历史沿袭（封闭目录时代），现在的
+ * 内容全部由模型按站点生成（或 deterministic fallback 造出）：id 由 API 侧
+ * 按内容派生，卡片自带完整视觉维度（radius/font/motion/density）。
+ */
+export declare const Step6AiThemeCandidateSchema: z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodEnum<{
+        ocean: "ocean";
+        forest: "forest";
+        crimson: "crimson";
+        violet: "violet";
+        clay: "clay";
+        graphite: "graphite";
+    }>, z.ZodEnum<{
+        "ai-forest": "ai-forest";
+        "ai-navy": "ai-navy";
+        "ai-steel": "ai-steel";
+    }>, z.ZodString]>;
+    rank: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    color_seeds: z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodString;
+    }, z.core.$strict>;
+    surface_mode: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+    radius: z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>;
+    font_pairing_id: z.ZodEnum<{
+        "archivo-inter": "archivo-inter";
+        "playfair-source-sans": "playfair-source-sans";
+        "space-grotesk-manrope": "space-grotesk-manrope";
+        "fraunces-libre-franklin": "fraunces-libre-franklin";
+        "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+        "noto-sans-sc": "noto-sans-sc";
+    }>;
+    motion_preset_id: z.ZodEnum<{
+        subtle: "subtle";
+        moderate: "moderate";
+        expressive: "expressive";
+    }>;
+    density: z.ZodEnum<{
+        compact: "compact";
+        comfortable: "comfortable";
+        airy: "airy";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type Step6AiThemeCandidate = z.infer<typeof Step6AiThemeCandidateSchema>;
+/**
+ * 模型面的一张生成主题卡：与 wire 候选相比没有 id/rank（id 由 API 侧按内容
+ * 派生，rank 由数组顺序决定）。颜色与文案是模型 authoring 的；字体/圆角/
+ * 密度/动效仍是封闭 enum 白名单——与 Clarify 视觉决策同口径。
+ */
+export declare const Step6GeneratedThemeCardSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    reason: z.ZodString;
+    color_seeds: z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodString;
+    }, z.core.$strict>;
+    surface_mode: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+    radius: z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>;
+    font_pairing_id: z.ZodEnum<{
+        "archivo-inter": "archivo-inter";
+        "playfair-source-sans": "playfair-source-sans";
+        "space-grotesk-manrope": "space-grotesk-manrope";
+        "fraunces-libre-franklin": "fraunces-libre-franklin";
+        "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+        "noto-sans-sc": "noto-sans-sc";
+    }>;
+    motion_preset_id: z.ZodEnum<{
+        subtle: "subtle";
+        moderate: "moderate";
+        expressive: "expressive";
+    }>;
+    density: z.ZodEnum<{
+        compact: "compact";
+        comfortable: "comfortable";
+        airy: "airy";
+    }>;
+}, z.core.$strict>;
+export type Step6GeneratedThemeCard = z.infer<typeof Step6GeneratedThemeCardSchema>;
+export declare const Step6DesignSelectionSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    recommendation_id: z.ZodString;
+    theme_preset_id: z.ZodUnion<readonly [z.ZodEnum<{
+        ocean: "ocean";
+        forest: "forest";
+        crimson: "crimson";
+        violet: "violet";
+        clay: "clay";
+        graphite: "graphite";
+    }>, z.ZodEnum<{
+        "ai-forest": "ai-forest";
+        "ai-navy": "ai-navy";
+        "ai-steel": "ai-steel";
+    }>, z.ZodString]>;
+    color_seeds: z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodString;
+    }, z.core.$strict>;
+    surface_mode: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+    font_pairing_id: z.ZodEnum<{
+        "archivo-inter": "archivo-inter";
+        "playfair-source-sans": "playfair-source-sans";
+        "space-grotesk-manrope": "space-grotesk-manrope";
+        "fraunces-libre-franklin": "fraunces-libre-franklin";
+        "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+        "noto-sans-sc": "noto-sans-sc";
+    }>;
+    motion_preset_id: z.ZodEnum<{
+        subtle: "subtle";
+        moderate: "moderate";
+        expressive: "expressive";
+    }>;
+    density: z.ZodEnum<{
+        compact: "compact";
+        comfortable: "comfortable";
+        airy: "airy";
+    }>;
+    radius: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>>;
+    aesthetic_note: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodString;
+}, z.core.$strict>;
+export type Step6DesignSelection = z.infer<typeof Step6DesignSelectionSchema>;
+export declare const Step6DesignRecommendationSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+    catalog_version: z.ZodString;
+    source: z.ZodObject<{
+        mode: z.ZodEnum<{
+            ai: "ai";
+            fallback: "fallback";
+        }>;
+        fallback_reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    inputs: z.ZodObject<{
+        industry: z.ZodOptional<z.ZodString>;
+        site_language: z.ZodString;
+        owner_locale: z.ZodOptional<z.ZodEnum<{
+            id: "id";
+            "zh-CN": "zh-CN";
+            "zh-HK": "zh-HK";
+            "zh-TW": "zh-TW";
+            "en-US": "en-US";
+            "en-GB": "en-GB";
+            "ja-JP": "ja-JP";
+            "ko-KR": "ko-KR";
+            "es-ES": "es-ES";
+            "fr-FR": "fr-FR";
+            "de-DE": "de-DE";
+            "pt-PT": "pt-PT";
+            "ru-RU": "ru-RU";
+            "ar-SA": "ar-SA";
+            "id-ID": "id-ID";
+            "vi-VN": "vi-VN";
+            "th-TH": "th-TH";
+            "it-IT": "it-IT";
+            "nl-NL": "nl-NL";
+            "tr-TR": "tr-TR";
+            "pl-PL": "pl-PL";
+            "uk-UA": "uk-UA";
+            "cs-CZ": "cs-CZ";
+            "sk-SK": "sk-SK";
+            "hu-HU": "hu-HU";
+            "ro-RO": "ro-RO";
+            "el-GR": "el-GR";
+            "sv-SE": "sv-SE";
+            "da-DK": "da-DK";
+            "fi-FI": "fi-FI";
+            "hr-HR": "hr-HR";
+            "lt-LT": "lt-LT";
+            "lv-LV": "lv-LV";
+            "et-EE": "et-EE";
+            "ga-IE": "ga-IE";
+            "mt-MT": "mt-MT";
+            "ka-GE": "ka-GE";
+            "fa-IR": "fa-IR";
+            "bn-BD": "bn-BD";
+            "ta-IN": "ta-IN";
+            "si-LK": "si-LK";
+            "ms-MY": "ms-MY";
+            "fil-PH": "fil-PH";
+            "my-MM": "my-MM";
+            "km-KH": "km-KH";
+            "lo-LA": "lo-LA";
+            "mn-MN": "mn-MN";
+            "kk-KZ": "kk-KZ";
+            en: "en";
+            ja: "ja";
+            es: "es";
+            fr: "fr";
+            de: "de";
+            ko: "ko";
+            pt: "pt";
+            "pt-BR": "pt-BR";
+            it: "it";
+            ru: "ru";
+            ar: "ar";
+            hi: "hi";
+            vi: "vi";
+            th: "th";
+            tr: "tr";
+            nl: "nl";
+            pl: "pl";
+            uk: "uk";
+            sv: "sv";
+            da: "da";
+            fi: "fi";
+            no: "no";
+            cs: "cs";
+            el: "el";
+            hu: "hu";
+            ro: "ro";
+            he: "he";
+            ms: "ms";
+            fil: "fil";
+            bn: "bn";
+            ta: "ta";
+            ca: "ca";
+            sk: "sk";
+            hr: "hr";
+            bg: "bg";
+            lt: "lt";
+            lv: "lv";
+            et: "et";
+            fa: "fa";
+            sw: "sw";
+            sr: "sr";
+            is: "is";
+        }>>;
+        strategy_version: z.ZodNumber;
+        input_digest: z.ZodString;
+    }, z.core.$strict>;
+    theme: z.ZodObject<{
+        recommended_id: z.ZodUnion<readonly [z.ZodEnum<{
+            ocean: "ocean";
+            forest: "forest";
+            crimson: "crimson";
+            violet: "violet";
+            clay: "clay";
+            graphite: "graphite";
+        }>, z.ZodEnum<{
+            "ai-forest": "ai-forest";
+            "ai-navy": "ai-navy";
+            "ai-steel": "ai-steel";
+        }>, z.ZodString]>;
+        candidate_ids: z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            ocean: "ocean";
+            forest: "forest";
+            crimson: "crimson";
+            violet: "violet";
+            clay: "clay";
+            graphite: "graphite";
+        }>, z.ZodEnum<{
+            "ai-forest": "ai-forest";
+            "ai-navy": "ai-navy";
+            "ai-steel": "ai-steel";
+        }>, z.ZodString]>>;
+        candidates: z.ZodArray<z.ZodObject<{
+            id: z.ZodUnion<readonly [z.ZodEnum<{
+                ocean: "ocean";
+                forest: "forest";
+                crimson: "crimson";
+                violet: "violet";
+                clay: "clay";
+                graphite: "graphite";
+            }>, z.ZodEnum<{
+                "ai-forest": "ai-forest";
+                "ai-navy": "ai-navy";
+                "ai-steel": "ai-steel";
+            }>, z.ZodString]>;
+            rank: z.ZodNumber;
+            name: z.ZodString;
+            description: z.ZodString;
+            color_seeds: z.ZodObject<{
+                primary: z.ZodString;
+                accent: z.ZodString;
+                foreground: z.ZodString;
+            }, z.core.$strict>;
+            surface_mode: z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>;
+            radius: z.ZodEnum<{
+                none: "none";
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+                xl: "xl";
+            }>;
+            font_pairing_id: z.ZodEnum<{
+                "archivo-inter": "archivo-inter";
+                "playfair-source-sans": "playfair-source-sans";
+                "space-grotesk-manrope": "space-grotesk-manrope";
+                "fraunces-libre-franklin": "fraunces-libre-franklin";
+                "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+                "noto-sans-sc": "noto-sans-sc";
+            }>;
+            motion_preset_id: z.ZodEnum<{
+                subtle: "subtle";
+                moderate: "moderate";
+                expressive: "expressive";
+            }>;
+            density: z.ZodEnum<{
+                compact: "compact";
+                comfortable: "comfortable";
+                airy: "airy";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    font: z.ZodObject<{
+        recommended_id: z.ZodEnum<{
+            "archivo-inter": "archivo-inter";
+            "playfair-source-sans": "playfair-source-sans";
+            "space-grotesk-manrope": "space-grotesk-manrope";
+            "fraunces-libre-franklin": "fraunces-libre-franklin";
+            "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+            "noto-sans-sc": "noto-sans-sc";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strict>;
+    motion: z.ZodObject<{
+        recommended_id: z.ZodEnum<{
+            subtle: "subtle";
+            moderate: "moderate";
+            expressive: "expressive";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strict>;
+    density: z.ZodObject<{
+        recommended_id: z.ZodEnum<{
+            compact: "compact";
+            comfortable: "comfortable";
+            airy: "airy";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strict>;
+    conversion: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodEnum<{
+            external: "external";
+            phone: "phone";
+            form: "form";
+            download: "download";
+            route: "route";
+        }>;
+        ctaLabel: z.ZodString;
+        ctaTarget: z.ZodOptional<z.ZodString>;
+        requiresOwnerDetail: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    generated_at: z.ZodString;
+}, z.core.$strict>;
+export type Step6DesignRecommendation = z.infer<typeof Step6DesignRecommendationSchema>;
+export declare const Step6DesignRecommendationsRequestSchema: z.ZodObject<{
+    force_refresh: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type Step6DesignRecommendationsRequest = z.infer<typeof Step6DesignRecommendationsRequestSchema>;
+export declare const Step6DesignRecommendationsResponseSchema: z.ZodObject<{
+    request_id: z.ZodString;
+    site_id: z.ZodUUID;
+    cached: z.ZodBoolean;
+    recommendation: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+        catalog_version: z.ZodString;
+        source: z.ZodObject<{
+            mode: z.ZodEnum<{
+                ai: "ai";
+                fallback: "fallback";
+            }>;
+            fallback_reason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        inputs: z.ZodObject<{
+            industry: z.ZodOptional<z.ZodString>;
+            site_language: z.ZodString;
+            owner_locale: z.ZodOptional<z.ZodEnum<{
+                id: "id";
+                "zh-CN": "zh-CN";
+                "zh-HK": "zh-HK";
+                "zh-TW": "zh-TW";
+                "en-US": "en-US";
+                "en-GB": "en-GB";
+                "ja-JP": "ja-JP";
+                "ko-KR": "ko-KR";
+                "es-ES": "es-ES";
+                "fr-FR": "fr-FR";
+                "de-DE": "de-DE";
+                "pt-PT": "pt-PT";
+                "ru-RU": "ru-RU";
+                "ar-SA": "ar-SA";
+                "id-ID": "id-ID";
+                "vi-VN": "vi-VN";
+                "th-TH": "th-TH";
+                "it-IT": "it-IT";
+                "nl-NL": "nl-NL";
+                "tr-TR": "tr-TR";
+                "pl-PL": "pl-PL";
+                "uk-UA": "uk-UA";
+                "cs-CZ": "cs-CZ";
+                "sk-SK": "sk-SK";
+                "hu-HU": "hu-HU";
+                "ro-RO": "ro-RO";
+                "el-GR": "el-GR";
+                "sv-SE": "sv-SE";
+                "da-DK": "da-DK";
+                "fi-FI": "fi-FI";
+                "hr-HR": "hr-HR";
+                "lt-LT": "lt-LT";
+                "lv-LV": "lv-LV";
+                "et-EE": "et-EE";
+                "ga-IE": "ga-IE";
+                "mt-MT": "mt-MT";
+                "ka-GE": "ka-GE";
+                "fa-IR": "fa-IR";
+                "bn-BD": "bn-BD";
+                "ta-IN": "ta-IN";
+                "si-LK": "si-LK";
+                "ms-MY": "ms-MY";
+                "fil-PH": "fil-PH";
+                "my-MM": "my-MM";
+                "km-KH": "km-KH";
+                "lo-LA": "lo-LA";
+                "mn-MN": "mn-MN";
+                "kk-KZ": "kk-KZ";
+                en: "en";
+                ja: "ja";
+                es: "es";
+                fr: "fr";
+                de: "de";
+                ko: "ko";
+                pt: "pt";
+                "pt-BR": "pt-BR";
+                it: "it";
+                ru: "ru";
+                ar: "ar";
+                hi: "hi";
+                vi: "vi";
+                th: "th";
+                tr: "tr";
+                nl: "nl";
+                pl: "pl";
+                uk: "uk";
+                sv: "sv";
+                da: "da";
+                fi: "fi";
+                no: "no";
+                cs: "cs";
+                el: "el";
+                hu: "hu";
+                ro: "ro";
+                he: "he";
+                ms: "ms";
+                fil: "fil";
+                bn: "bn";
+                ta: "ta";
+                ca: "ca";
+                sk: "sk";
+                hr: "hr";
+                bg: "bg";
+                lt: "lt";
+                lv: "lv";
+                et: "et";
+                fa: "fa";
+                sw: "sw";
+                sr: "sr";
+                is: "is";
+            }>>;
+            strategy_version: z.ZodNumber;
+            input_digest: z.ZodString;
+        }, z.core.$strict>;
+        theme: z.ZodObject<{
+            recommended_id: z.ZodUnion<readonly [z.ZodEnum<{
+                ocean: "ocean";
+                forest: "forest";
+                crimson: "crimson";
+                violet: "violet";
+                clay: "clay";
+                graphite: "graphite";
+            }>, z.ZodEnum<{
+                "ai-forest": "ai-forest";
+                "ai-navy": "ai-navy";
+                "ai-steel": "ai-steel";
+            }>, z.ZodString]>;
+            candidate_ids: z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+                ocean: "ocean";
+                forest: "forest";
+                crimson: "crimson";
+                violet: "violet";
+                clay: "clay";
+                graphite: "graphite";
+            }>, z.ZodEnum<{
+                "ai-forest": "ai-forest";
+                "ai-navy": "ai-navy";
+                "ai-steel": "ai-steel";
+            }>, z.ZodString]>>;
+            candidates: z.ZodArray<z.ZodObject<{
+                id: z.ZodUnion<readonly [z.ZodEnum<{
+                    ocean: "ocean";
+                    forest: "forest";
+                    crimson: "crimson";
+                    violet: "violet";
+                    clay: "clay";
+                    graphite: "graphite";
+                }>, z.ZodEnum<{
+                    "ai-forest": "ai-forest";
+                    "ai-navy": "ai-navy";
+                    "ai-steel": "ai-steel";
+                }>, z.ZodString]>;
+                rank: z.ZodNumber;
+                name: z.ZodString;
+                description: z.ZodString;
+                color_seeds: z.ZodObject<{
+                    primary: z.ZodString;
+                    accent: z.ZodString;
+                    foreground: z.ZodString;
+                }, z.core.$strict>;
+                surface_mode: z.ZodEnum<{
+                    light: "light";
+                    dark: "dark";
+                }>;
+                radius: z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    xl: "xl";
+                }>;
+                font_pairing_id: z.ZodEnum<{
+                    "archivo-inter": "archivo-inter";
+                    "playfair-source-sans": "playfair-source-sans";
+                    "space-grotesk-manrope": "space-grotesk-manrope";
+                    "fraunces-libre-franklin": "fraunces-libre-franklin";
+                    "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+                    "noto-sans-sc": "noto-sans-sc";
+                }>;
+                motion_preset_id: z.ZodEnum<{
+                    subtle: "subtle";
+                    moderate: "moderate";
+                    expressive: "expressive";
+                }>;
+                density: z.ZodEnum<{
+                    compact: "compact";
+                    comfortable: "comfortable";
+                    airy: "airy";
+                }>;
+                reason: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        font: z.ZodObject<{
+            recommended_id: z.ZodEnum<{
+                "archivo-inter": "archivo-inter";
+                "playfair-source-sans": "playfair-source-sans";
+                "space-grotesk-manrope": "space-grotesk-manrope";
+                "fraunces-libre-franklin": "fraunces-libre-franklin";
+                "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+                "noto-sans-sc": "noto-sans-sc";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strict>;
+        motion: z.ZodObject<{
+            recommended_id: z.ZodEnum<{
+                subtle: "subtle";
+                moderate: "moderate";
+                expressive: "expressive";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strict>;
+        density: z.ZodObject<{
+            recommended_id: z.ZodEnum<{
+                compact: "compact";
+                comfortable: "comfortable";
+                airy: "airy";
+            }>;
+            reason: z.ZodString;
+        }, z.core.$strict>;
+        conversion: z.ZodOptional<z.ZodObject<{
+            protocol: z.ZodEnum<{
+                external: "external";
+                phone: "phone";
+                form: "form";
+                download: "download";
+                route: "route";
+            }>;
+            ctaLabel: z.ZodString;
+            ctaTarget: z.ZodOptional<z.ZodString>;
+            requiresOwnerDetail: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        generated_at: z.ZodString;
+    }, z.core.$strict>;
+    selection: z.ZodObject<{
+        version: z.ZodNumber;
+        recommendation_id: z.ZodString;
+        theme_preset_id: z.ZodUnion<readonly [z.ZodEnum<{
+            ocean: "ocean";
+            forest: "forest";
+            crimson: "crimson";
+            violet: "violet";
+            clay: "clay";
+            graphite: "graphite";
+        }>, z.ZodEnum<{
+            "ai-forest": "ai-forest";
+            "ai-navy": "ai-navy";
+            "ai-steel": "ai-steel";
+        }>, z.ZodString]>;
+        color_seeds: z.ZodObject<{
+            primary: z.ZodString;
+            accent: z.ZodString;
+            foreground: z.ZodString;
+        }, z.core.$strict>;
+        surface_mode: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        font_pairing_id: z.ZodEnum<{
+            "archivo-inter": "archivo-inter";
+            "playfair-source-sans": "playfair-source-sans";
+            "space-grotesk-manrope": "space-grotesk-manrope";
+            "fraunces-libre-franklin": "fraunces-libre-franklin";
+            "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+            "noto-sans-sc": "noto-sans-sc";
+        }>;
+        motion_preset_id: z.ZodEnum<{
+            subtle: "subtle";
+            moderate: "moderate";
+            expressive: "expressive";
+        }>;
+        density: z.ZodEnum<{
+            compact: "compact";
+            comfortable: "comfortable";
+            airy: "airy";
+        }>;
+        radius: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>>;
+        aesthetic_note: z.ZodOptional<z.ZodString>;
+        updated_at: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type Step6DesignRecommendationsResponse = z.infer<typeof Step6DesignRecommendationsResponseSchema>;
+export declare const UpdateStep6DesignSelectionRequestSchema: z.ZodObject<{
+    recommendation_id: z.ZodString;
+    expected_version: z.ZodNumber;
+    theme_preset_id: z.ZodUnion<readonly [z.ZodEnum<{
+        ocean: "ocean";
+        forest: "forest";
+        crimson: "crimson";
+        violet: "violet";
+        clay: "clay";
+        graphite: "graphite";
+    }>, z.ZodEnum<{
+        "ai-forest": "ai-forest";
+        "ai-navy": "ai-navy";
+        "ai-steel": "ai-steel";
+    }>, z.ZodString]>;
+    color_seeds: z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodString;
+    }, z.core.$strict>;
+    surface_mode: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+    font_pairing_id: z.ZodEnum<{
+        "archivo-inter": "archivo-inter";
+        "playfair-source-sans": "playfair-source-sans";
+        "space-grotesk-manrope": "space-grotesk-manrope";
+        "fraunces-libre-franklin": "fraunces-libre-franklin";
+        "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+        "noto-sans-sc": "noto-sans-sc";
+    }>;
+    motion_preset_id: z.ZodEnum<{
+        subtle: "subtle";
+        moderate: "moderate";
+        expressive: "expressive";
+    }>;
+    density: z.ZodEnum<{
+        compact: "compact";
+        comfortable: "comfortable";
+        airy: "airy";
+    }>;
+    radius: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>>;
+    aesthetic_note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type UpdateStep6DesignSelectionRequest = z.infer<typeof UpdateStep6DesignSelectionRequestSchema>;
+export declare const UpdateStep6DesignSelectionResponseSchema: z.ZodObject<{
+    selection: z.ZodObject<{
+        version: z.ZodNumber;
+        recommendation_id: z.ZodString;
+        theme_preset_id: z.ZodUnion<readonly [z.ZodEnum<{
+            ocean: "ocean";
+            forest: "forest";
+            crimson: "crimson";
+            violet: "violet";
+            clay: "clay";
+            graphite: "graphite";
+        }>, z.ZodEnum<{
+            "ai-forest": "ai-forest";
+            "ai-navy": "ai-navy";
+            "ai-steel": "ai-steel";
+        }>, z.ZodString]>;
+        color_seeds: z.ZodObject<{
+            primary: z.ZodString;
+            accent: z.ZodString;
+            foreground: z.ZodString;
+        }, z.core.$strict>;
+        surface_mode: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        font_pairing_id: z.ZodEnum<{
+            "archivo-inter": "archivo-inter";
+            "playfair-source-sans": "playfair-source-sans";
+            "space-grotesk-manrope": "space-grotesk-manrope";
+            "fraunces-libre-franklin": "fraunces-libre-franklin";
+            "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+            "noto-sans-sc": "noto-sans-sc";
+        }>;
+        motion_preset_id: z.ZodEnum<{
+            subtle: "subtle";
+            moderate: "moderate";
+            expressive: "expressive";
+        }>;
+        density: z.ZodEnum<{
+            compact: "compact";
+            comfortable: "comfortable";
+            airy: "airy";
+        }>;
+        radius: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>>;
+        aesthetic_note: z.ZodOptional<z.ZodString>;
+        updated_at: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type UpdateStep6DesignSelectionResponse = z.infer<typeof UpdateStep6DesignSelectionResponseSchema>;
+/** Trusted VCP API → agent input; this is never browser-provided. */
+export declare const Step6DesignRecommendationGenerationInputSchema: z.ZodObject<{
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    site_language: z.ZodString;
+    owner_locale: z.ZodEnum<{
+        id: "id";
+        "zh-CN": "zh-CN";
+        "zh-HK": "zh-HK";
+        "zh-TW": "zh-TW";
+        "en-US": "en-US";
+        "en-GB": "en-GB";
+        "ja-JP": "ja-JP";
+        "ko-KR": "ko-KR";
+        "es-ES": "es-ES";
+        "fr-FR": "fr-FR";
+        "de-DE": "de-DE";
+        "pt-PT": "pt-PT";
+        "ru-RU": "ru-RU";
+        "ar-SA": "ar-SA";
+        "id-ID": "id-ID";
+        "vi-VN": "vi-VN";
+        "th-TH": "th-TH";
+        "it-IT": "it-IT";
+        "nl-NL": "nl-NL";
+        "tr-TR": "tr-TR";
+        "pl-PL": "pl-PL";
+        "uk-UA": "uk-UA";
+        "cs-CZ": "cs-CZ";
+        "sk-SK": "sk-SK";
+        "hu-HU": "hu-HU";
+        "ro-RO": "ro-RO";
+        "el-GR": "el-GR";
+        "sv-SE": "sv-SE";
+        "da-DK": "da-DK";
+        "fi-FI": "fi-FI";
+        "hr-HR": "hr-HR";
+        "lt-LT": "lt-LT";
+        "lv-LV": "lv-LV";
+        "et-EE": "et-EE";
+        "ga-IE": "ga-IE";
+        "mt-MT": "mt-MT";
+        "ka-GE": "ka-GE";
+        "fa-IR": "fa-IR";
+        "bn-BD": "bn-BD";
+        "ta-IN": "ta-IN";
+        "si-LK": "si-LK";
+        "ms-MY": "ms-MY";
+        "fil-PH": "fil-PH";
+        "my-MM": "my-MM";
+        "km-KH": "km-KH";
+        "lo-LA": "lo-LA";
+        "mn-MN": "mn-MN";
+        "kk-KZ": "kk-KZ";
+        en: "en";
+        ja: "ja";
+        es: "es";
+        fr: "fr";
+        de: "de";
+        ko: "ko";
+        pt: "pt";
+        "pt-BR": "pt-BR";
+        it: "it";
+        ru: "ru";
+        ar: "ar";
+        hi: "hi";
+        vi: "vi";
+        th: "th";
+        tr: "tr";
+        nl: "nl";
+        pl: "pl";
+        uk: "uk";
+        sv: "sv";
+        da: "da";
+        fi: "fi";
+        no: "no";
+        cs: "cs";
+        el: "el";
+        hu: "hu";
+        ro: "ro";
+        he: "he";
+        ms: "ms";
+        fil: "fil";
+        bn: "bn";
+        ta: "ta";
+        ca: "ca";
+        sk: "sk";
+        hr: "hr";
+        bg: "bg";
+        lt: "lt";
+        lv: "lv";
+        et: "et";
+        fa: "fa";
+        sw: "sw";
+        sr: "sr";
+        is: "is";
+    }>;
+    industry: z.ZodOptional<z.ZodString>;
+    strategy_version_id: z.ZodString;
+    strategy_version: z.ZodNumber;
+    strategy_checksum: z.ZodString;
+    strategy_summary: z.ZodArray<z.ZodString>;
+    reference_image_source_id: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strict>;
+export type Step6DesignRecommendationGenerationInput = z.infer<typeof Step6DesignRecommendationGenerationInputSchema>;
+/**
+ * 模型输出：3 张现场生成的主题卡（顺序即排名，第一张为推荐）+ 可选转化目标。
+ * 目录（颜色值、卡 id）由服务端持有/派生，模型不产。
+ */
+export declare const Step6DesignRecommendationModelOutputSchema: z.ZodObject<{
+    theme_candidates: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        reason: z.ZodString;
+        color_seeds: z.ZodObject<{
+            primary: z.ZodString;
+            accent: z.ZodString;
+            foreground: z.ZodString;
+        }, z.core.$strict>;
+        surface_mode: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        radius: z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>;
+        font_pairing_id: z.ZodEnum<{
+            "archivo-inter": "archivo-inter";
+            "playfair-source-sans": "playfair-source-sans";
+            "space-grotesk-manrope": "space-grotesk-manrope";
+            "fraunces-libre-franklin": "fraunces-libre-franklin";
+            "noto-serif-sc-noto-sans-sc": "noto-serif-sc-noto-sans-sc";
+            "noto-sans-sc": "noto-sans-sc";
+        }>;
+        motion_preset_id: z.ZodEnum<{
+            subtle: "subtle";
+            moderate: "moderate";
+            expressive: "expressive";
+        }>;
+        density: z.ZodEnum<{
+            compact: "compact";
+            comfortable: "comfortable";
+            airy: "airy";
+        }>;
+    }, z.core.$strict>>;
+    conversion: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodEnum<{
+            external: "external";
+            phone: "phone";
+            form: "form";
+            download: "download";
+            route: "route";
+        }>;
+        ctaLabel: z.ZodString;
+        ctaTarget: z.ZodOptional<z.ZodString>;
+        requiresOwnerDetail: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type Step6DesignRecommendationModelOutput = z.infer<typeof Step6DesignRecommendationModelOutputSchema>;
+/**
+ * deterministic fallback 卡内容：模型生成连续失败时由 API 侧使用，保证
+ * 「卡必达」。锚点取自人工调过的 STEP6_AI_THEME_PRESETS，字体/动效/密度取
+ * 各白名单的通用默认；id 与 AI 卡同路径按内容派生。
+ */
+export declare function buildStep6FallbackThemeCards(): Step6GeneratedThemeCard[];
+/**
+ * 用户选择的圆角档位。存量选择没有该字段时按主题带出的默认值回退，
+ * 主题也认不出时才落到物化端同款默认，保证老站行为不变。
+ */
+export declare function resolveStep6RadiusId(selection: Step6DesignSelection): SiteDesignRadiusId;
+/** Deterministic handoff from persisted selection to Sitemap/DesignPlan. */
+export declare function toStep6GenerationVisualHints(selection: Step6DesignSelection): {
+    readonly colorSeeds: {
+        primary: string;
+        accent: string;
+        foreground: string;
+    };
+    readonly surfaceMode: "light" | "dark";
+    readonly fonts: {
+        readonly heading: string;
+        readonly body: string;
+    };
+    readonly density: "compact" | "comfortable" | "airy";
+    readonly motionLevel: "subtle" | "moderate" | "expressive";
+    readonly motionPreset: "subtle" | "moderate" | "expressive";
+    readonly radius: "none" | "sm" | "md" | "lg" | "xl";
+};
+export declare function defaultStep6Selection(recommendation: Step6DesignRecommendation, now: Date): Step6DesignSelection;