@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/media-library.d.ts

@@ -0,0 +1,164 @@
+import { z } from "zod";
+export declare const MEDIA_LIBRARY_MAX_BYTES: number;
+export declare const MEDIA_LIBRARY_IMAGE_MAX_BYTES: number;
+export declare const MEDIA_LIBRARY_IMAGE_EXTENSIONS: readonly ["jpg", "jpeg", "png", "gif", "webp", "bmp"];
+export declare const MEDIA_LIBRARY_VIDEO_EXTENSIONS: readonly ["mp4", "avi", "mov", "webm", "mkv"];
+export declare const MEDIA_LIBRARY_AUDIO_EXTENSIONS: readonly ["mp3", "wav", "aac", "flac", "ogg", "wma", "m4a"];
+export declare const MEDIA_LIBRARY_DOCUMENT_EXTENSIONS: readonly ["pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "txt", "md", "csv"];
+export declare const MEDIA_LIBRARY_FILE_EXTENSIONS: readonly ["pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "txt", "md", "csv", "zip", "rar", "json", "xmind", "psd", "ai", "fig", "sketch"];
+export declare const MEDIA_LIBRARY_EXTENSIONS: readonly ["jpg", "jpeg", "png", "gif", "webp", "bmp", "mp4", "avi", "mov", "webm", "mkv", "mp3", "wav", "aac", "flac", "ogg", "wma", "m4a", "pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "txt", "md", "csv", "zip", "rar", "json", "xmind", "psd", "ai", "fig", "sketch"];
+export declare const MEDIA_LIBRARY_IMAGE_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/bmp"];
+export declare const MEDIA_LIBRARY_VIDEO_MIME_TYPES: readonly ["video/mp4", "video/x-msvideo", "video/quicktime", "video/webm", "video/x-matroska"];
+export declare const MEDIA_LIBRARY_AUDIO_MIME_TYPES: readonly ["audio/mpeg", "audio/wav", "audio/x-wav", "audio/vnd.wave", "audio/aac", "audio/flac", "audio/x-flac", "audio/ogg", "audio/x-ms-wma", "audio/mp4", "audio/x-m4a"];
+export declare const MEDIA_LIBRARY_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "image/bmp", "video/mp4", "video/x-msvideo", "video/quicktime", "video/webm", "video/x-matroska", "audio/mpeg", "audio/wav", "audio/x-wav", "audio/vnd.wave", "audio/aac", "audio/flac", "audio/x-flac", "audio/ogg", "audio/x-ms-wma", "audio/mp4", "audio/x-m4a"];
+export declare const MediaLibraryFileTypeSchema: z.ZodEnum<{
+    file: "file";
+    image: "image";
+    video: "video";
+    audio: "audio";
+}>;
+export type MediaLibraryFileType = z.infer<typeof MediaLibraryFileTypeSchema>;
+export declare const MediaLibrarySourceSchema: z.ZodEnum<{
+    external: "external";
+    ai_generated: "ai_generated";
+    unsplash: "unsplash";
+}>;
+export type MediaLibrarySource = z.infer<typeof MediaLibrarySourceSchema>;
+export declare const MediaLibraryAssetSchema: z.ZodObject<{
+    resource_id: z.ZodString;
+    name: z.ZodString;
+    url: z.ZodString;
+    thumbnail_url: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
+    mime_type: z.ZodString;
+    size: z.ZodNumber;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
+    source: z.ZodEnum<{
+        external: "external";
+        ai_generated: "ai_generated";
+        unsplash: "unsplash";
+    }>;
+    created_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type MediaLibraryAsset = z.infer<typeof MediaLibraryAssetSchema>;
+export declare const ListMediaLibraryAssetsQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    page_size: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    keyword: z.ZodOptional<z.ZodString>;
+    file_type: z.ZodDefault<z.ZodEnum<{
+        file: "file";
+        image: "image";
+        video: "video";
+        audio: "audio";
+    }>>;
+}, z.core.$strip>;
+export type ListMediaLibraryAssetsQuery = z.infer<typeof ListMediaLibraryAssetsQuerySchema>;
+export declare const ListMediaLibraryAssetsResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            resource_id: z.ZodString;
+            name: z.ZodString;
+            url: z.ZodString;
+            thumbnail_url: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
+            mime_type: z.ZodString;
+            size: z.ZodNumber;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
+            source: z.ZodEnum<{
+                external: "external";
+                ai_generated: "ai_generated";
+                unsplash: "unsplash";
+            }>;
+            created_at: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        page: z.ZodNumber;
+        page_size: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ListMediaLibraryAssetsResponse = z.infer<typeof ListMediaLibraryAssetsResponseSchema>;
+export declare const UploadMediaLibraryAssetResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        resource_id: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodString;
+        thumbnail_url: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
+        mime_type: z.ZodString;
+        size: z.ZodNumber;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+        source: z.ZodEnum<{
+            external: "external";
+            ai_generated: "ai_generated";
+            unsplash: "unsplash";
+        }>;
+        created_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UploadMediaLibraryAssetResponse = z.infer<typeof UploadMediaLibraryAssetResponseSchema>;
+export declare const UnsplashMediaAssetSchema: z.ZodObject<{
+    provider_id: z.ZodString;
+    url: z.ZodString;
+    thumbnail_url: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    alt: z.ZodString;
+    photographer_name: z.ZodString;
+    photographer_url: z.ZodString;
+    photo_url: z.ZodString;
+    download_location: z.ZodString;
+    dominant_color: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type UnsplashMediaAsset = z.infer<typeof UnsplashMediaAssetSchema>;
+export declare const SearchUnsplashMediaQuerySchema: z.ZodObject<{
+    query: z.ZodString;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    page_size: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        landscape: "landscape";
+        portrait: "portrait";
+        squarish: "squarish";
+    }>>;
+}, z.core.$strip>;
+export type SearchUnsplashMediaQuery = z.infer<typeof SearchUnsplashMediaQuerySchema>;
+export declare const SearchUnsplashMediaResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            provider_id: z.ZodString;
+            url: z.ZodString;
+            thumbnail_url: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            alt: z.ZodString;
+            photographer_name: z.ZodString;
+            photographer_url: z.ZodString;
+            photo_url: z.ZodString;
+            download_location: z.ZodString;
+            dominant_color: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        page: z.ZodNumber;
+        page_size: z.ZodNumber;
+        total: z.ZodNumber;
+        total_pages: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SearchUnsplashMediaResponse = z.infer<typeof SearchUnsplashMediaResponseSchema>;
+export declare const UnsplashDownloadLocationSchema: z.ZodString;
+export declare const UseUnsplashMediaRequestSchema: z.ZodObject<{
+    download_location: z.ZodString;
+}, z.core.$strip>;
+export type UseUnsplashMediaRequest = z.infer<typeof UseUnsplashMediaRequestSchema>;
+export declare const UseUnsplashMediaResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        reported: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UseUnsplashMediaResponse = z.infer<typeof UseUnsplashMediaResponseSchema>;

package/dist/migration-products.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 搬家预置产品页在前端、Agent、CMS 三侧共用的标识。
+ *
+ * 这个 slug 同时决定了：结构规划页插入的页面路径、Agent 的确定性 CMS 接线和
+ * 专用 View 任务匹配依据、以及 CMS 置备详情页时拼出的页面标题。三处必须逐字
+ * 相等，差一个字符就会让页面与容器对不上，表现为产品列表页空白或整套预置被
+ * 跳过，因此集中在这里定义一次。
+ *
+ * 不要为它加环境变量覆盖：浏览器读不到服务端环境变量，一旦服务端改了值，前端
+ * 插入的路径不会跟随，链路会静默断开。
+ */
+export declare const MIGRATION_PRODUCTS_SLUG = "products";
+/** 结构规划页插入的页面路径，也是列表页最终的访问地址。 */
+export declare const MIGRATION_PRODUCTS_ROUTE: "/products";
+/** 详情路由前缀，等于 CMS 地址模板里的固定段。 */
+export declare const MIGRATION_PRODUCTS_DETAIL_PREFIX: "/products";
+/** CMS 置备详情页时自动生成的标题，详情路由的页面身份声明必须与之相等。 */
+export declare const MIGRATION_PRODUCTS_CMS_DETAIL_PAGE_TITLE: "products detail";
+/** Sitemap / DesignPlan / Workspace 共用的产品集合布局节点类型。 */
+export declare const MIGRATION_PRODUCTS_VIEW_BLOCK_TYPE = "cms_collection_view";
+/** 产品中心静态承载页上的列表布局节点。 */
+export declare const MIGRATION_PRODUCTS_LIST_VIEW_VARIANT = "list";
+/** 产品动态详情路由使用的详情布局节点。 */
+export declare const MIGRATION_PRODUCTS_DETAIL_VIEW_VARIANT = "detail";
+export type MigrationProductsViewVariant = typeof MIGRATION_PRODUCTS_LIST_VIEW_VARIANT | typeof MIGRATION_PRODUCTS_DETAIL_VIEW_VARIANT;
+/**
+ * 搬家产品页是平台预置页面，但它最终出现在访客导航里，因此文案只能跟随站点
+ * 输出语种，不能跟随操作者控制台语种。站点语言目录比平台 UI 语言更宽；没有
+ * 明确译文时统一回退英文，避免中文控制台给其它语种站点写入中文导航。
+ */
+export interface MigrationProductsLocalizedCopy {
+    readonly pageTitle: string;
+    /** 列表布局节点文案；保留 blockLabel 名称兼容已有调用。 */
+    readonly blockLabel: string;
+    readonly detailBlockLabel: string;
+    /** 承载页首屏区块名。产品中心是平台建的页，没有它整页就没有 h1。 */
+    readonly heroBlockLabel: string;
+    /** 详情页面包屑里的首页一级。 */
+    readonly homeLabel: string;
+}
+export declare function migrationProductsCopyForLocale(locale: string | null | undefined): MigrationProductsLocalizedCopy;
+/** 系统已知预置标题；仅这些标题允许随站点 locale 自动改写。 */
+export declare function isMigrationProductsPresetPageTitle(value: string): boolean;
+/** 系统已知预置区块名；用户自定义区块名不得被 locale 同步覆盖。 */
+export declare function isMigrationProductsPresetBlockLabel(value: string): boolean;

package/dist/page-slug.d.ts

@@ -25,6 +25,8 @@
  */
 export declare const PAGE_SLUG_SEGMENT_PATTERN_SOURCE = "[a-z0-9]+(?:-[a-z0-9]+)*";
 export declare const PAGE_SLUG_PATTERN: RegExp;
+export declare const PLATFORM_OWNED_PAGE_SLUGS: readonly ["/privacy", "/cookie-policy"];
+export declare const PLATFORM_OWNED_ROUTE_FILE_PATHS: string[];
 export declare function isCanonicalPageSlug(value: unknown): value is string;
 /**
  * Best-effort canonicalization for ASCII-only semantic input. Returns `null`

package/dist/page-template.d.ts

@@ -0,0 +1,95 @@
+import { z } from "zod";
+/** Raw page-template identity; the contract intentionally preserves its value. */
+export declare const PageTemplateIdSchema: z.ZodString;
+export type PageTemplateId = z.infer<typeof PageTemplateIdSchema>;
+/** Site-relative page path without URL query or fragment components. */
+export declare const PageTemplatePagePathSchema: z.ZodString;
+export type PageTemplatePagePath = z.infer<typeof PageTemplatePagePathSchema>;
+export declare const ManagedPageTemplateRouteManifestV1Schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    route_id: z.ZodString;
+    canonical_entry_file: z.ZodString;
+    route_key: z.ZodString;
+    default_template_id: z.ZodString;
+    templates: z.ZodArray<z.ZodObject<{
+        template_id: z.ZodString;
+        safe_name: z.ZodString;
+        entry_file: z.ZodString;
+        kind: z.ZodEnum<{
+            default: "default";
+            additional: "additional";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ManagedPageTemplateRouteManifestV1 = z.infer<typeof ManagedPageTemplateRouteManifestV1Schema>;
+export declare const PageTemplateCreateRequestSchema: z.ZodObject<{
+    page_path: z.ZodString;
+    template_id: z.ZodString;
+    instruction: z.ZodString;
+}, z.core.$strict>;
+export type PageTemplateCreateRequest = z.infer<typeof PageTemplateCreateRequestSchema>;
+export declare const PageTemplatePromoteRequestSchema: z.ZodObject<{
+    page_path: z.ZodString;
+    template_id: z.ZodString;
+    exit_template_ids: z.ZodPipe<z.ZodDefault<z.ZodArray<z.ZodString>>, z.ZodTransform<string[], string[]>>;
+}, z.core.$strict>;
+export type PageTemplatePromoteRequest = z.infer<typeof PageTemplatePromoteRequestSchema>;
+export declare const PageTemplateCleanupRequestSchema: z.ZodObject<{
+    page_path: z.ZodString;
+    template_ids: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+}, z.core.$strict>;
+export type PageTemplateCleanupRequest = z.infer<typeof PageTemplateCleanupRequestSchema>;
+export declare const PageTemplateCreateResponseSchema: z.ZodObject<{
+    template_id: z.ZodString;
+    status: z.ZodLiteral<"created">;
+    ok: z.ZodLiteral<true>;
+    site_id: z.ZodUUID;
+    page_path: z.ZodString;
+    route_id: z.ZodString;
+    default_template_id: z.ZodString;
+    snapshot_id: z.ZodUUID;
+    route_mode: z.ZodLiteral<"delegated">;
+}, z.core.$strict>;
+export type PageTemplateCreateResponse = z.infer<typeof PageTemplateCreateResponseSchema>;
+export declare const PageTemplatePromoteResponseSchema: z.ZodObject<{
+    promoted_template_id: z.ZodString;
+    deleted_template_ids: z.ZodArray<z.ZodString>;
+    status: z.ZodLiteral<"promoted">;
+    ok: z.ZodLiteral<true>;
+    site_id: z.ZodUUID;
+    page_path: z.ZodString;
+    route_id: z.ZodString;
+    default_template_id: z.ZodString;
+    snapshot_id: z.ZodUUID;
+    route_mode: z.ZodLiteral<"delegated">;
+}, z.core.$strict>;
+export type PageTemplatePromoteResponse = z.infer<typeof PageTemplatePromoteResponseSchema>;
+export declare const PageTemplateCleanupResponseSchema: z.ZodObject<{
+    deleted_template_ids: z.ZodArray<z.ZodString>;
+    status: z.ZodLiteral<"cleaned">;
+    ok: z.ZodLiteral<true>;
+    site_id: z.ZodUUID;
+    page_path: z.ZodString;
+    route_id: z.ZodString;
+    default_template_id: z.ZodString;
+    snapshot_id: z.ZodUUID;
+    route_mode: z.ZodLiteral<"delegated">;
+}, z.core.$strict>;
+export type PageTemplateCleanupResponse = z.infer<typeof PageTemplateCleanupResponseSchema>;
+export declare const PageTemplateErrorCodeSchema: z.ZodEnum<{
+    PAGE_TEMPLATE_REQUEST_INVALID: "PAGE_TEMPLATE_REQUEST_INVALID";
+    PAGE_TEMPLATE_PAGE_NOT_FOUND: "PAGE_TEMPLATE_PAGE_NOT_FOUND";
+    PAGE_TEMPLATE_NOT_FOUND: "PAGE_TEMPLATE_NOT_FOUND";
+    PAGE_TEMPLATE_ALREADY_EXISTS: "PAGE_TEMPLATE_ALREADY_EXISTS";
+    PAGE_TEMPLATE_ID_COLLISION: "PAGE_TEMPLATE_ID_COLLISION";
+    PAGE_TEMPLATE_MANAGED_SOURCE_INVALID: "PAGE_TEMPLATE_MANAGED_SOURCE_INVALID";
+    PAGE_TEMPLATE_DEFAULT_PROTECTED: "PAGE_TEMPLATE_DEFAULT_PROTECTED";
+    PAGE_TEMPLATE_DEFAULT_ALREADY_ACTIVE: "PAGE_TEMPLATE_DEFAULT_ALREADY_ACTIVE";
+    PAGE_TEMPLATE_ASSET_IN_USE: "PAGE_TEMPLATE_ASSET_IN_USE";
+    PAGE_TEMPLATE_SNAPSHOT_CONFLICT: "PAGE_TEMPLATE_SNAPSHOT_CONFLICT";
+    PAGE_TEMPLATE_DYNAMIC_ROUTE_UNSUPPORTED: "PAGE_TEMPLATE_DYNAMIC_ROUTE_UNSUPPORTED";
+    PAGE_TEMPLATE_SOURCE_UNSUPPORTED: "PAGE_TEMPLATE_SOURCE_UNSUPPORTED";
+    PAGE_TEMPLATE_GENERATION_FAILED: "PAGE_TEMPLATE_GENERATION_FAILED";
+    PAGE_TEMPLATE_PATCH_FAILED: "PAGE_TEMPLATE_PATCH_FAILED";
+}>;
+export type PageTemplateErrorCode = z.infer<typeof PageTemplateErrorCodeSchema>;

package/dist/product-search.d.ts

@@ -0,0 +1,227 @@
+import { z } from "zod";
+export declare const ProductSearchAppSlugSchema: z.ZodString;
+export declare const ProductSearchFieldNameSchema: z.ZodString;
+export declare const ProductSearchValueShapeSchema: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    text: "text";
+    select: "select";
+    multi_select: "multi_select";
+    tags: "tags";
+    category_list: "category_list";
+}>;
+export declare const ProductSearchRouteIdSchema: z.ZodString;
+export declare const ProductSearchFilterMetaSchema: z.ZodObject<{
+    minimum: z.ZodNumber;
+    maximum: z.ZodNumber;
+    step: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ProductSearchPopularTermsSchema: z.ZodArray<z.ZodString>;
+export declare const ProductSearchPopularTermsReadSchema: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+export declare const ProductSearchAppConfigDraftSchema: z.ZodObject<{
+    filter_enabled: z.ZodBoolean;
+    selected_fields: z.ZodArray<z.ZodString>;
+    selected_card_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    popular_terms_enabled: z.ZodDefault<z.ZodBoolean>;
+    popular_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const ProductSearchDraftConfigSchema: z.ZodObject<{
+    app_slug: z.ZodString;
+    filter_enabled: z.ZodBoolean;
+    selected_fields: z.ZodArray<z.ZodString>;
+    selected_card_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    popular_terms_enabled: z.ZodDefault<z.ZodBoolean>;
+    popular_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const ProductSearchInteractionRequestSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"product_search_confirmation">;
+    baseline_snapshot_id: z.ZodUUID;
+    target_route_id: z.ZodString;
+    applications: z.ZodArray<z.ZodObject<{
+        app_slug: z.ZodString;
+        label: z.ZodString;
+        popular_terms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        current_config: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            filter_enabled: z.ZodBoolean;
+            selected_fields: z.ZodArray<z.ZodString>;
+            selected_card_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            popular_terms_enabled: z.ZodDefault<z.ZodBoolean>;
+            popular_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        affected_routes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fields: z.ZodArray<z.ZodObject<{
+            field_name: z.ZodString;
+            label: z.ZodString;
+            value_shape: z.ZodEnum<{
+                number: "number";
+                boolean: "boolean";
+                text: "text";
+                select: "select";
+                multi_select: "multi_select";
+                tags: "tags";
+                category_list: "category_list";
+            }>;
+            option_count: z.ZodOptional<z.ZodNumber>;
+            filter_meta: z.ZodOptional<z.ZodObject<{
+                minimum: z.ZodNumber;
+                maximum: z.ZodNumber;
+                step: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    current_config: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        app_slug: z.ZodString;
+        filter_enabled: z.ZodBoolean;
+        selected_fields: z.ZodArray<z.ZodString>;
+        selected_card_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        popular_terms_enabled: z.ZodDefault<z.ZodBoolean>;
+        popular_terms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    affected_routes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const ProductSearchInteractionResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"product_search_confirmation">;
+    action: z.ZodEnum<{
+        confirm: "confirm";
+        modify: "modify";
+    }>;
+    app_slug: z.ZodString;
+    filter_enabled: z.ZodBoolean;
+    popular_terms_enabled: z.ZodDefault<z.ZodBoolean>;
+    selected_fields: z.ZodArray<z.ZodString>;
+    selected_card_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"product_search_confirmation">;
+    action: z.ZodLiteral<"cancel">;
+}, z.core.$strict>]>;
+export declare const ProductSearchRequestSchema: z.ZodObject<{
+    q: z.ZodString;
+    page: z.ZodNumber;
+    page_size: z.ZodUnion<readonly [z.ZodLiteral<9>, z.ZodLiteral<20>]>;
+    sort: z.ZodEnum<{
+        published_at_desc: "published_at_desc";
+        published_at_asc: "published_at_asc";
+        product_name_asc: "product_name_asc";
+        product_name_desc: "product_name_desc";
+    }>;
+    filters: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        include_unlabeled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    display_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    missing_count_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    relaxation_count_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    facets: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        query: z.ZodString;
+        page: z.ZodNumber;
+        page_size: z.ZodLiteral<10>;
+        include_values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ProductSearchResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        thumbnail: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        summary: z.ZodString;
+        category: z.ZodNullable<z.ZodString>;
+        field_values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>;
+        url: z.ZodString;
+    }, z.core.$strict>>;
+    page: z.ZodObject<{
+        total: z.ZodNumber;
+        page: z.ZodNumber;
+        page_size: z.ZodUnion<readonly [z.ZodLiteral<9>, z.ZodLiteral<20>]>;
+    }, z.core.$strict>;
+    facets: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        total: z.ZodNumber;
+        page: z.ZodNumber;
+        page_size: z.ZodLiteral<10>;
+        values: z.ZodArray<z.ZodObject<{
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+            label: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strict>>;
+        selected_values: z.ZodArray<z.ZodObject<{
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+            label: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    missing_counts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    relaxation_counts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strict>;
+export declare const ProductSearchContractFixtureSchema: z.ZodObject<{
+    contract_version: z.ZodLiteral<1>;
+    request: z.ZodObject<{
+        q: z.ZodString;
+        page: z.ZodNumber;
+        page_size: z.ZodUnion<readonly [z.ZodLiteral<9>, z.ZodLiteral<20>]>;
+        sort: z.ZodEnum<{
+            published_at_desc: "published_at_desc";
+            published_at_asc: "published_at_asc";
+            product_name_asc: "product_name_asc";
+            product_name_desc: "product_name_desc";
+        }>;
+        filters: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>, z.ZodObject<{
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            include_unlabeled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>]>>;
+        display_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        missing_count_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        relaxation_count_fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        facets: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            query: z.ZodString;
+            page: z.ZodNumber;
+            page_size: z.ZodLiteral<10>;
+            include_values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            thumbnail: z.ZodNullable<z.ZodString>;
+            title: z.ZodString;
+            summary: z.ZodString;
+            category: z.ZodNullable<z.ZodString>;
+            field_values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+        page: z.ZodObject<{
+            total: z.ZodNumber;
+            page: z.ZodNumber;
+            page_size: z.ZodUnion<readonly [z.ZodLiteral<9>, z.ZodLiteral<20>]>;
+        }, z.core.$strict>;
+        facets: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            total: z.ZodNumber;
+            page: z.ZodNumber;
+            page_size: z.ZodLiteral<10>;
+            values: z.ZodArray<z.ZodObject<{
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+                label: z.ZodString;
+                count: z.ZodNumber;
+            }, z.core.$strict>>;
+            selected_values: z.ZodArray<z.ZodObject<{
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+                label: z.ZodString;
+                count: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        missing_counts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        relaxation_counts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ProductSearchInteractionRequest = z.infer<typeof ProductSearchInteractionRequestSchema>;
+export type ProductSearchInteractionResponse = z.infer<typeof ProductSearchInteractionResponseSchema>;
+export type ProductSearchRequest = z.infer<typeof ProductSearchRequestSchema>;
+export type ProductSearchResponse = z.infer<typeof ProductSearchResponseSchema>;