@vcp-dev/contracts 0.6.10 → 0.7.0

package/README.md

@@ -31,11 +31,12 @@ import {
 
 const request: SiteEditOperationRequest = SiteEditOperationRequestSchema.parse({
   id: "op_123",
-  siteId: "site_123",
-  baseSnapshotId: "snapshot_123",
+  siteId: "018f6f4d-a9b8-7401-8401-0123456789ab",
+  baseSnapshotId: "018f6f4d-a9b8-7402-8402-0123456789ab",
   kind: "update-text",
-  target: { kind: "object", key: "hero-title" },
-  payload: { text: "Hello VCP" },
+  target: { kind: "node", key: "hero-title" },
+  documentVersion: 3,
+  params: { kind: "update-text", segmentIndex: 0, value: "Hello VCP" },
 });
 ```
 

package/dist/api-response.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export type ApiResponse<T> = {
+    code: number;
+    data: T;
+    message: string;
+};
+export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    code: z.ZodNumber;
+    data: T;
+    message: z.ZodString;
+}, z.core.$strip>;

package/dist/business-facts.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * 用户在建站之前已经确认过的业务事实。
+ *
+ * 两条流都填这一个形状：
+ * - 有原站流：Step2 冻结结果里的主营产品、现有市场、资质；
+ * - 无原站流：客户资料表里的对应字段。
+ *
+ * 刻意只放中立短文本，三条硬边界：
+ * - **不含公司名**。站点名单独走现有的权威段落，两处同义但可能不同的值会打架。
+ * - **不含网址、不含证据数组**。那会把原站原文和链接带进提示词。
+ * - **不含行业码**。行业先验是另一条独立的判定链路，不从这里读。
+ *
+ * 全部可选：任一侧读不到就整个字段不注入，按原请求体转发，提示词与今天一致。
+ */
+export declare const BusinessFactsSchema: z.ZodObject<{
+    primary_products: z.ZodOptional<z.ZodString>;
+    current_markets: z.ZodOptional<z.ZodString>;
+    qualifications: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BusinessFacts = z.infer<typeof BusinessFactsSchema>;
+/** 一条都没有的业务事实等于没有，调用方据此整个不注入。 */
+export declare function hasAnyBusinessFact(facts: BusinessFacts): boolean;

package/dist/cms-page-directory.d.ts

@@ -0,0 +1,281 @@
+import { z } from "zod";
+export declare const HOME_PAGE_URL_PATH = "/";
+export declare const CMS_PAGE_URL_PATH_MAX_LENGTH = 255;
+export declare const CMS_PAGE_DIRECTORY_MAX_NODES = 5000;
+export declare const CMS_PAGE_DIRECTORY_MAX_DEPTH = 64;
+/** CMS-managed, browser-safe site-relative identity. */
+export declare const CmsPageUrlPathSchema: z.ZodString;
+export declare const CmsManagedPageTypeSchema: z.ZodEnum<{
+    landing_page: "landing_page";
+    general_page: "general_page";
+    detail_page: "detail_page";
+}>;
+export type CmsManagedPageType = z.infer<typeof CmsManagedPageTypeSchema>;
+export declare const CmsPageTypeSchema: z.ZodEnum<{
+    landing_page: "landing_page";
+    general_page: "general_page";
+    detail_page: "detail_page";
+    list_page: "list_page";
+    category_page: "category_page";
+    tag_page: "tag_page";
+    author_page: "author_page";
+    search_page: "search_page";
+    date_page: "date_page";
+}>;
+export type CmsPageType = z.infer<typeof CmsPageTypeSchema>;
+export interface CmsPageDirectoryNode {
+    readonly cms_page_id: number;
+    readonly title: string;
+    readonly url_path: string;
+    readonly url: string | null;
+    readonly page_type: CmsPageType;
+    readonly vcp_managed: boolean;
+    readonly children: readonly CmsPageDirectoryNode[];
+}
+export declare const CmsPageDirectoryNodeSchema: z.ZodType<CmsPageDirectoryNode>;
+export declare const CmsPageDirectoryGroupSchema: z.ZodObject<{
+    group_id: z.ZodString;
+    title: z.ZodString;
+    pages: z.ZodArray<z.ZodType<CmsPageDirectoryNode, unknown, z.core.$ZodTypeInternals<CmsPageDirectoryNode, unknown>>>;
+}, z.core.$strict>;
+export type CmsPageDirectoryGroup = z.infer<typeof CmsPageDirectoryGroupSchema>;
+export declare const CmsPageDirectorySchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        group_id: z.ZodString;
+        title: z.ZodString;
+        pages: z.ZodArray<z.ZodType<CmsPageDirectoryNode, unknown, z.core.$ZodTypeInternals<CmsPageDirectoryNode, unknown>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CmsPageDirectory = z.infer<typeof CmsPageDirectorySchema>;
+/** 将 CMS 当前页面目录响应归一化为 VCP 内部目录模型。 */
+export declare function parseCmsPageDirectory(input: unknown): CmsPageDirectory | null;
+export declare const DesignerPageDisabledReasonSchema: z.ZodEnum<{
+    invalid_url_path: "invalid_url_path";
+    missing_url: "missing_url";
+    not_vcp_managed: "not_vcp_managed";
+    unsupported_page_type: "unsupported_page_type";
+}>;
+export type DesignerPageDisabledReason = z.infer<typeof DesignerPageDisabledReasonSchema>;
+export declare const DesignerPageDeleteBlockReasonSchema: z.ZodEnum<{
+    invalid_url_path: "invalid_url_path";
+    not_vcp_managed: "not_vcp_managed";
+    unsupported_page_type: "unsupported_page_type";
+    home_page: "home_page";
+    not_selectable: "not_selectable";
+    page_has_children: "page_has_children";
+    last_selectable_page: "last_selectable_page";
+    cms_unbound: "cms_unbound";
+}>;
+export type DesignerPageDeleteBlockReason = z.infer<typeof DesignerPageDeleteBlockReasonSchema>;
+export interface DesignerPageNode {
+    /** Null for VCP sitemap pages when the site has no CMS binding. */
+    readonly cms_page_id: number | null;
+    readonly title: string;
+    readonly url_path: string;
+    readonly url: string | null;
+    readonly page_type: CmsPageType;
+    readonly vcp_managed: boolean;
+    readonly selectable: boolean;
+    readonly disabled_reason: DesignerPageDisabledReason | null;
+    readonly can_delete: boolean;
+    readonly delete_block_reason: DesignerPageDeleteBlockReason | null;
+    readonly has_cms_children: boolean;
+    readonly children: readonly DesignerPageNode[];
+}
+export declare const DesignerPageNodeSchema: z.ZodType<DesignerPageNode>;
+export declare const DesignerPageGroupSchema: z.ZodObject<{
+    group_id: z.ZodString;
+    title: z.ZodString;
+    pages: z.ZodArray<z.ZodType<DesignerPageNode, unknown, z.core.$ZodTypeInternals<DesignerPageNode, unknown>>>;
+}, z.core.$strict>;
+export type DesignerPageGroup = z.infer<typeof DesignerPageGroupSchema>;
+export declare const DeleteDesignerPageRequestSchema: z.ZodObject<{
+    base_snapshot_id: z.ZodUUID;
+    expected_url_path: z.ZodString;
+}, z.core.$strict>;
+export type DeleteDesignerPageRequest = z.infer<typeof DeleteDesignerPageRequestSchema>;
+export declare const PageDirectoryReconcileStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+}>;
+export declare const PageDirectoryReconcileFailedPageSchema: z.ZodObject<{
+    url_path: z.ZodString;
+    phase: z.ZodEnum<{
+        ensure: "ensure";
+        binding: "binding";
+        delete: "delete";
+    }>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const PageDirectoryReconcileResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+    }>;
+    checked_count: z.ZodNumber;
+    ensured_count: z.ZodNumber;
+    deleted_count: z.ZodNumber;
+    already_absent_count: z.ZodNumber;
+    failed_pages: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        phase: z.ZodEnum<{
+            ensure: "ensure";
+            binding: "binding";
+            delete: "delete";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type PageDirectoryReconcileResult = z.infer<typeof PageDirectoryReconcileResultSchema>;
+export declare const DeleteDesignerPageResultSchema: z.ZodObject<{
+    result_snapshot_id: z.ZodUUID;
+    deleted_files: z.ZodArray<z.ZodString>;
+    updated_files: z.ZodArray<z.ZodString>;
+    preserved_shared_files: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    next_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+    previous_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+    cms_reconcile_result: z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        checked_count: z.ZodNumber;
+        ensured_count: z.ZodNumber;
+        deleted_count: z.ZodNumber;
+        already_absent_count: z.ZodNumber;
+        failed_pages: z.ZodArray<z.ZodObject<{
+            url_path: z.ZodString;
+            phase: z.ZodEnum<{
+                ensure: "ensure";
+                binding: "binding";
+                delete: "delete";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type DeleteDesignerPageResult = z.infer<typeof DeleteDesignerPageResultSchema>;
+export declare const DeleteDesignerPageResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        result_snapshot_id: z.ZodUUID;
+        deleted_files: z.ZodArray<z.ZodString>;
+        updated_files: z.ZodArray<z.ZodString>;
+        preserved_shared_files: z.ZodArray<z.ZodString>;
+        warnings: z.ZodArray<z.ZodString>;
+        next_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        previous_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
+        cms_reconcile_result: z.ZodObject<{
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            checked_count: z.ZodNumber;
+            ensured_count: z.ZodNumber;
+            deleted_count: z.ZodNumber;
+            already_absent_count: z.ZodNumber;
+            failed_pages: z.ZodArray<z.ZodObject<{
+                url_path: z.ZodString;
+                phase: z.ZodEnum<{
+                    ensure: "ensure";
+                    binding: "binding";
+                    delete: "delete";
+                }>;
+                code: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strict>>;
+            warnings: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type DeleteDesignerPageResponse = z.infer<typeof DeleteDesignerPageResponseSchema>;
+export declare const DeleteDesignerPageErrorDetailsSchema: z.ZodObject<{
+    source_committed: z.ZodBoolean;
+    result_snapshot_id: z.ZodOptional<z.ZodUUID>;
+    cms_reconcile_result: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        checked_count: z.ZodNumber;
+        ensured_count: z.ZodNumber;
+        deleted_count: z.ZodNumber;
+        already_absent_count: z.ZodNumber;
+        failed_pages: z.ZodArray<z.ZodObject<{
+            url_path: z.ZodString;
+            phase: z.ZodEnum<{
+                ensure: "ensure";
+                binding: "binding";
+                delete: "delete";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DeleteDesignerPageErrorDetails = z.infer<typeof DeleteDesignerPageErrorDetailsSchema>;
+export declare const PageTargetKindSchema: z.ZodEnum<{
+    landing_page: "landing_page";
+    general_page: "general_page";
+    detail_page: "detail_page";
+}>;
+export declare const PageTargetSchema: z.ZodObject<{
+    url_path: z.ZodString;
+    title: z.ZodString;
+    kind: z.ZodEnum<{
+        landing_page: "landing_page";
+        general_page: "general_page";
+        detail_page: "detail_page";
+    }>;
+    route_file: z.ZodString;
+    collection_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PageTarget = z.infer<typeof PageTargetSchema>;
+export declare const PageTargetSetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    complete: z.ZodLiteral<true>;
+    targets: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            general_page: "general_page";
+            detail_page: "detail_page";
+        }>;
+        route_file: z.ZodString;
+        collection_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    complete: z.ZodLiteral<false>;
+    targets: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            general_page: "general_page";
+            detail_page: "detail_page";
+        }>;
+        route_file: z.ZodString;
+        collection_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "complete">;
+export type PageTargetSet = z.infer<typeof PageTargetSetSchema>;
+export declare const PageTargetProjectionHashSchema: z.ZodString;
+export type PageTargetProjectionHash = z.infer<typeof PageTargetProjectionHashSchema>;
+export declare const PageDirectoryReconcileStateSchema: z.ZodObject<{
+    projection_hash: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type PageDirectoryReconcileState = z.infer<typeof PageDirectoryReconcileStateSchema>;
+export declare const UpdatePageDirectoryReconcileStateRequestSchema: z.ZodObject<{
+    expected_projection_hash: z.ZodNullable<z.ZodString>;
+    projection_hash: z.ZodString;
+}, z.core.$strict>;
+export type UpdatePageDirectoryReconcileStateRequest = z.infer<typeof UpdatePageDirectoryReconcileStateRequestSchema>;

package/dist/cms-site-id.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+/** CMS owns this identifier; VCP only persists and forwards a validated UUID. */
+export declare const CmsSiteIdSchema: z.ZodString;
+export type CmsSiteId = z.infer<typeof CmsSiteIdSchema>;

package/dist/colorway-distinctness.js

@@ -1 +1 @@
-import{converter as re,differenceCiede2000 as ne}from"culori";import{converter as K,parse as k,wcagContrast as b}from"culori";var p=K("oklch"),A=4.5,e={paper:"oklch(0.92 0.008 250)",cream:"oklch(0.90 0.035 85)",sand:"oklch(0.75 0.05 78)",stone:"oklch(0.60 0.02 75)",ash:"oklch(0.60 0.012 250)",slate:"oklch(0.45 0.025 250)",charcoal:"oklch(0.30 0.015 255)",ink:"oklch(0.25 0.04 260)",sky:"oklch(0.72 0.12 230)",blue:"oklch(0.58 0.17 250)","medical blue":"oklch(0.58 0.12 235)",indigo:"oklch(0.50 0.18 280)",navy:"oklch(0.40 0.10 258)",ocean:"oklch(0.55 0.13 220)","slate blue":"oklch(0.46 0.06 245)",teal:"oklch(0.60 0.12 195)","soft aqua":"oklch(0.78 0.07 190)",mint:"oklch(0.78 0.10 165)",sage:"oklch(0.65 0.05 145)",green:"oklch(0.58 0.15 145)","clinical green":"oklch(0.62 0.12 155)",emerald:"oklch(0.60 0.16 155)",forest:"oklch(0.45 0.10 145)",olive:"oklch(0.58 0.08 115)",lime:"oklch(0.72 0.17 130)",yellow:"oklch(0.82 0.15 100)",gold:"oklch(0.72 0.14 85)",amber:"oklch(0.70 0.16 70)",orange:"oklch(0.66 0.18 55)",coral:"oklch(0.68 0.16 32)",terracotta:"oklch(0.55 0.12 42)",rust:"oklch(0.50 0.13 38)",brown:"oklch(0.45 0.07 55)",rose:"oklch(0.65 0.16 18)",red:"oklch(0.58 0.20 25)",crimson:"oklch(0.52 0.20 22)",wine:"oklch(0.42 0.13 18)",pink:"oklch(0.72 0.14 0)",magenta:"oklch(0.60 0.22 345)",lavender:"oklch(0.72 0.08 295)",violet:"oklch(0.58 0.19 295)",purple:"oklch(0.52 0.19 305)",plum:"oklch(0.45 0.13 325)",electric:"oklch(0.62 0.23 285)","clean white":"oklch(0.97 0.01 245)","cool gray":"oklch(0.62 0.02 245)",zinc:"oklch(0.60 0.012 250)",gray:"oklch(0.60 0.012 250)",grey:"oklch(0.60 0.012 250)",neutral:"oklch(0.60 0.005 250)",gunmetal:"oklch(0.30 0.015 255)"},q={\u84DD:e.blue,\u84DD\u8272:e.blue,\u5929\u84DD:e.sky,\u5929\u84DD\u8272:e.sky,\u6D45\u84DD:e.sky,\u6E56\u84DD:e.ocean,\u6D77\u84DD:e.ocean,\u6DF1\u84DD:e.navy,\u85CF\u84DD:e.navy,\u85CF\u9752:e.navy,\u6D77\u519B\u84DD:e.navy,\u6DF1\u6D77\u519B\u84DD:e.navy,\u5348\u591C\u84DD:e.navy,\u975B\u84DD:e.indigo,\u975B\u9752:e.indigo,\u94A2\u84DD:e["slate blue"],\u9752:e.teal,\u9752\u8272:e.teal,\u84DD\u7EFF:e.teal,\u7EFF:e.green,\u7EFF\u8272:e.green,\u6D45\u7EFF:e.mint,\u8584\u8377\u7EFF:e.mint,\u8349\u7EFF:e.lime,\u6A44\u6984\u7EFF:e.olive,\u58A8\u7EFF:e.forest,\u6DF1\u7EFF:e.forest,\u68EE\u6797\u7EFF:e.forest,\u7FE0\u7EFF:e.emerald,\u7956\u6BCD\u7EFF:e.emerald,\u9EC4:e.yellow,\u9EC4\u8272:e.yellow,\u91D1:e.gold,\u91D1\u8272:e.gold,\u91D1\u9EC4:e.gold,\u7425\u73C0:e.amber,\u7425\u73C0\u8272:e.amber,\u6A59:e.orange,\u6A59\u8272:e.orange,\u6A58\u8272:e.orange,\u6A58\u9EC4:e.orange,\u6D3B\u529B\u6A59:e.orange,\u6696\u6A59:e.orange,\u73CA\u745A:e.coral,\u73CA\u745A\u6A59:e.coral,\u9676\u571F:e.terracotta,\u8D64\u9676:e.terracotta,\u9508\u7EA2:e.rust,\u68D5:e.brown,\u68D5\u8272:e.brown,\u8910\u8272:e.brown,\u5496\u5561\u8272:e.brown,\u7EA2:e.red,\u7EA2\u8272:e.red,\u6731\u7EA2:e.red,\u7EEF\u7EA2:e.crimson,\u6DF1\u7EA2:e.crimson,\u9152\u7EA2:e.wine,\u73AB\u7470:e.rose,\u73AB\u7EA2:e.rose,\u7C89:e.pink,\u7C89\u8272:e.pink,\u7C89\u7EA2:e.pink,\u6D0B\u7EA2:e.magenta,\u54C1\u7EA2:e.magenta,\u7D2B:e.purple,\u7D2B\u8272:e.purple,\u6DE1\u7D2B:e.lavender,\u85B0\u8863\u8349:e.lavender,\u7D2B\u7F57\u5170:e.violet,\u6885\u7EA2:e.plum,\u7070:e.gray,\u7070\u8272:e.gray,\u6D45\u7070:e.gray,\u6DE1\u7070:e.gray,\u51B7\u7070:e["cool gray"],\u51B7\u7070\u767D:e["cool gray"],\u6696\u7070:e.stone,\u6DF1\u7070:e.slate,\u77F3\u58A8\u7070:e.slate,\u77F3\u677F\u7070:e.slate,\u70AD\u7070:e.charcoal,\u70AD\u9ED1:e.charcoal,\u58A8:e.ink,\u58A8\u8272:e.ink,\u9ED1:e.ink,\u9ED1\u8272:e.ink,\u767D:e["clean white"],\u767D\u8272:e["clean white"],\u7C73\u767D:e.cream,\u7C73\u8272:e.cream,\u8C61\u7259\u767D:e.cream,\u5976\u6CB9\u767D:e.cream,\u6C99\u8272:e.sand},_={...e,...q};function F(t){let o=t.colorSeeds??{primary:"slate",accent:"blue",neutral:"zinc"},r=t.surfaceMode,n=v(o.primary||"slate"),c=s(n),l=s(v(o.accent||"blue")),h=o.neutral?v(o.neutral):Q(n),i=u(h.h),d,a,f,g,S,w;r==="dark"?(d=s({mode:"oklch",l:.14,c:.03,h:i}),a=s({mode:"oklch",l:.95,c:.02,h:i}),f=s({mode:"oklch",l:.2,c:.04,h:i}),g=s({mode:"oklch",l:.29,c:.05,h:i}),S=s({mode:"oklch",l:.78,c:.02,h:i}),w=s({mode:"oklch",l:.35,c:.06,h:i})):(d=s({mode:"oklch",l:.98,c:.01,h:i}),a=s({mode:"oklch",l:.2,c:.02,h:i}),f=s({mode:"oklch",l:.96,c:.015,h:i}),g=s({mode:"oklch",l:.92,c:.02,h:i}),S=s({mode:"oklch",l:.43,c:.02,h:i}),w=s({mode:"oklch",l:.84,c:.025,h:i}));let m=t.imagePalette;if(m){let M=typeof m.background=="string"&&E(m.background),x=M&&te(m.background,r);M&&x&&(d=s(v(m.background))),x&&typeof m.card=="string"&&E(m.card)&&(f=s(v(m.card))),x&&typeof m.muted=="string"&&E(m.muted)&&(g=s(v(m.muted))),typeof m.foreground=="string"&&E(m.foreground)?a=ee(s(v(m.foreground)),d,A):M&&x&&(a=y(d)),typeof m.border=="string"&&E(m.border)&&(w=oe(s(v(m.border)),d))}let I=r!=="dark",B={"--background":d,"--foreground":a,"--card":f,"--card-foreground":a,"--muted":g,"--muted-foreground":S,"--border":w,"--input":w,"--ring":l,"--primary":c,"--primary-foreground":y(c),"--primary-hover":O(c,I),"--accent":l,"--accent-foreground":y(l),"--accent-ink":C(l,d),"--accent-subtle":Y(l,I),"--accent-hover":O(l,I),"--overlay-on-dark":s({mode:"oklch",l:.96,c:.02,h:i}),"--overlay-on-light":s({mode:"oklch",l:.2,c:.02,h:i})},P=a,H=y(a),G=D(a,i),$=C(l,a),V=p(k(c)??c),z=u(V?.h),U=D(c,z),j=C(l,c);return J({...B,...{"--surface-inverse":P,"--surface-inverse-foreground":H,"--surface-inverse-muted":G,"--surface-inverse-accent-ink":$,"--surface-primary-muted":U,"--surface-primary-accent-ink":j}},o)}function J(t,o){let r=s({mode:"oklch",l:.58,c:.22,h:28}),n=s({mode:"oklch",l:.6,c:.14,h:150}),c=s({mode:"oklch",l:.75,c:.15,h:75}),l={...t,"--popover":"var(--card)","--popover-foreground":"var(--card-foreground)","--secondary":"var(--muted)","--secondary-foreground":"var(--foreground)","--destructive":r,"--destructive-foreground":y(r),"--success":n,"--success-foreground":y(n),"--warning":c,"--warning-foreground":y(c)},[h,i]=W(o,l);return l["--supporting-0"]=h,l["--supporting-1"]=i,Z(l["--accent"]).forEach((a,f)=>{l[`--chart-${f+1}`]=a}),l}function W(t,o){let c=(t.supporting??[]).filter(h=>!!(h&&h.trim())).slice(0,2).map(h=>s(v(h))),l=[o["--primary"],o["--accent"]];for(;c.length<2;)c.push(l[c.length]);return[c[0],c[1]]}function E(t){let o=(t??"").trim();if(!o||o.startsWith("#")&&!/^#[0-9A-Fa-f]{3,8}$/.test(o))return!1;let r=_[o.toLowerCase()]??o;return!!k(r)}function v(t,o="paper"){let r=(t??"").trim();if(!r)return v(o);let n=_[r.toLowerCase()]??r,c=k(n);if(c){let l=p(c);if(l)return l}return X(r)}function X(t){let o=2166136261,r=t.toLowerCase();for(let h=0;h<r.length;h++)o^=r.charCodeAt(h),o=Math.imul(o,16777619)>>>0;let n=o%360,c=.08+(o>>>9)%9/100;return{mode:"oklch",l:.52+(o>>>18)%16/100,c,h:n}}function Q(t){return{mode:"oklch",l:.6,c:.02,h:u(t.h)}}function O(t,o){let r=p(k(t)??t);if(!r)return t;let n=o?-.06:.06,c=Math.max(.06,Math.min(.97,u(r.l)+n));return s({mode:"oklch",l:c,c:u(r.c),h:u(r.h)})}function Y(t,o){let r=p(k(t)??t),n=u(r?.h),c=Math.min(u(r?.c),o?.05:.06);return s({mode:"oklch",l:o?.95:.24,c,h:n})}function Z(t){let o=p(k(t)??t),r=u(o?.h),n=Math.max(.12,Math.min(u(o?.c),.16));return[0,72,144,216,288].map(c=>s({mode:"oklch",l:.62,c:n,h:(r+c)%360}))}function y(t){let o=k(t),r=o?p(o):void 0,n=u(r?.h),c={mode:"oklch",l:.99,c:.01,h:n},l={mode:"oklch",l:.18,c:.02,h:n},h=b(o??t,c),i=b(o??t,l);return s(h>=i?c:l)}function ee(t,o,r){let n=p(k(t)??t);if(!n)return y(o);if(b(t,o)>=r)return s(n);let c=p(k(o)??o),h=(c?u(c.l)>=.5:!0)?-.02:.02,i=u(n.l),d=u(n.c),a=u(n.h);for(let f=1;f<=50;f++){let g=i+h*f;if(g<=0||g>=1)break;let S={mode:"oklch",l:g,c:d,h:a};if(b(S,o)>=r)return s(S)}return y(o)}var L=1.3;function oe(t,o){let r=p(k(t)??t);if(!r)return t;if(b(t,o)>=L)return s(r);let n=p(k(o)??o),l=(n?u(n.l)>=.5:!0)?-.03:.03,h=u(r.l),i=u(r.c),d=u(r.h);for(let a=1;a<=40;a++){let f=h+l*a;if(f<=0||f>=1)break;let g={mode:"oklch",l:f,c:i,h:d};if(b(g,o)>=L)return s(g)}return t}function te(t,o){let r=p(k(t)??t);if(!r)return!1;let n=u(r.l)>=.5;return o==="dark"?!n:n}function C(t,o){let r=p(k(t)??t);if(!r)return t;let n=u(r.h),c=u(r.c),l=u(r.l),h=p(k(o)??o),d=(h?u(h.l)>=.5:!0)?-.02:.02;for(let a=0;a<=50;a++){let f=l+d*a;if(f<=0||f>=1)break;let g={mode:"oklch",l:f,c,h:n};if(b(g,o)>=A)return s(g)}return y(o)}function D(t,o){let r=p(k(t)??t),c=(r?u(r.l):.5)>=.5,l=c?.75:.35,h=c?-.02:.02;for(let i=0;i<=50;i++){let d=l+h*i;if(d<=0||d>=1)break;let a={mode:"oklch",l:d,c:.02,h:o};if(b(a,t)>=A)return s(a)}return y(t)}function u(t){return typeof t=="number"&&Number.isFinite(t)?t:0}function s(t){let o=u(t.l),r=u(t.c),n=u(t.h);return`oklch(${o.toFixed(2)} ${r.toFixed(2)} ${n.toFixed(2)})`}var ce=10,T=25,le=re("oklch"),ae=ne();function se(t){return typeof t.colorSeeds?.primary=="string"&&t.colorSeeds.primary.trim().length>0}function N(t){let o=le(t);return o&&typeof o.h=="number"?o.h:void 0}function R(t){let o=0;for(let r=0;r<t.length;r+=1)for(let n=r+1;n<t.length;n+=1){let c=t[r],l=t[n];if(c===void 0||l===void 0)continue;let h=Math.abs(c-l)%360,i=h>180?360-h:h;i>o&&(o=i)}return o}function ie(t){let o=0,r=1/0;for(let n=0;n<t.length;n+=1)for(let c=n+1;c<t.length;c+=1){let l=ae(t[n],t[c]);l>o&&(o=l),l<r&&(r=l)}return{max:o,min:r===1/0?0:r}}function ke(t){let o=t.filter(se);if(o.length<2)return{minBackgroundDeltaE:null,tooSimilar:!1,insufficient:!0};let r=o.map(a=>a.surfaceMode??"light"),n=o.map((a,f)=>F({colorSeeds:a.colorSeeds,surfaceMode:r[f]})),c=ie(n.map(a=>a["--background"])),l=R(n.map(a=>N(a["--primary"]))),h=R(n.map(a=>N(a["--accent"]))),d=!(new Set(r).size===1)||c.max>=ce||l>=T||h>=T;return{minBackgroundDeltaE:c.min,tooSimilar:!d,insufficient:!1}}export{ke as measureColorwayDistinctness};
+import{converter as re,differenceCiede2000 as ne}from"culori";import{converter as q,parse as k,wcagContrast as b}from"culori";var p=q("oklch"),I=4.5,e={paper:"oklch(0.92 0.008 250)",cream:"oklch(0.90 0.035 85)",sand:"oklch(0.75 0.05 78)",stone:"oklch(0.60 0.02 75)",ash:"oklch(0.60 0.012 250)",slate:"oklch(0.45 0.025 250)",charcoal:"oklch(0.30 0.015 255)",ink:"oklch(0.25 0.04 260)",sky:"oklch(0.72 0.12 230)",blue:"oklch(0.58 0.17 250)","medical blue":"oklch(0.58 0.12 235)",indigo:"oklch(0.50 0.18 280)",navy:"oklch(0.40 0.10 258)",ocean:"oklch(0.55 0.13 220)","slate blue":"oklch(0.46 0.06 245)",teal:"oklch(0.60 0.12 195)","soft aqua":"oklch(0.78 0.07 190)",mint:"oklch(0.78 0.10 165)",sage:"oklch(0.65 0.05 145)",green:"oklch(0.58 0.15 145)","clinical green":"oklch(0.62 0.12 155)",emerald:"oklch(0.60 0.16 155)",forest:"oklch(0.45 0.10 145)",olive:"oklch(0.58 0.08 115)",lime:"oklch(0.72 0.17 130)",yellow:"oklch(0.82 0.15 100)",gold:"oklch(0.72 0.14 85)",amber:"oklch(0.70 0.16 70)",orange:"oklch(0.66 0.18 55)",coral:"oklch(0.68 0.16 32)",terracotta:"oklch(0.55 0.12 42)",rust:"oklch(0.50 0.13 38)",brown:"oklch(0.45 0.07 55)",rose:"oklch(0.65 0.16 18)",red:"oklch(0.58 0.20 25)",crimson:"oklch(0.52 0.20 22)",wine:"oklch(0.42 0.13 18)",pink:"oklch(0.72 0.14 0)",magenta:"oklch(0.60 0.22 345)",lavender:"oklch(0.72 0.08 295)",violet:"oklch(0.58 0.19 295)",purple:"oklch(0.52 0.19 305)",plum:"oklch(0.45 0.13 325)",electric:"oklch(0.62 0.23 285)","clean white":"oklch(0.97 0.01 245)","cool gray":"oklch(0.62 0.02 245)",zinc:"oklch(0.60 0.012 250)",gray:"oklch(0.60 0.012 250)",grey:"oklch(0.60 0.012 250)",neutral:"oklch(0.60 0.005 250)",gunmetal:"oklch(0.30 0.015 255)"},J={\u84DD:e.blue,\u84DD\u8272:e.blue,\u5929\u84DD:e.sky,\u5929\u84DD\u8272:e.sky,\u6D45\u84DD:e.sky,\u6E56\u84DD:e.ocean,\u6D77\u84DD:e.ocean,\u6DF1\u84DD:e.navy,\u85CF\u84DD:e.navy,\u85CF\u9752:e.navy,\u6D77\u519B\u84DD:e.navy,\u6DF1\u6D77\u519B\u84DD:e.navy,\u5348\u591C\u84DD:e.navy,\u975B\u84DD:e.indigo,\u975B\u9752:e.indigo,\u94A2\u84DD:e["slate blue"],\u9752:e.teal,\u9752\u8272:e.teal,\u84DD\u7EFF:e.teal,\u7EFF:e.green,\u7EFF\u8272:e.green,\u6D45\u7EFF:e.mint,\u8584\u8377\u7EFF:e.mint,\u8349\u7EFF:e.lime,\u6A44\u6984\u7EFF:e.olive,\u58A8\u7EFF:e.forest,\u6DF1\u7EFF:e.forest,\u68EE\u6797\u7EFF:e.forest,\u7FE0\u7EFF:e.emerald,\u7956\u6BCD\u7EFF:e.emerald,\u9EC4:e.yellow,\u9EC4\u8272:e.yellow,\u91D1:e.gold,\u91D1\u8272:e.gold,\u91D1\u9EC4:e.gold,\u7425\u73C0:e.amber,\u7425\u73C0\u8272:e.amber,\u6A59:e.orange,\u6A59\u8272:e.orange,\u6A58\u8272:e.orange,\u6A58\u9EC4:e.orange,\u6D3B\u529B\u6A59:e.orange,\u6696\u6A59:e.orange,\u73CA\u745A:e.coral,\u73CA\u745A\u6A59:e.coral,\u9676\u571F:e.terracotta,\u8D64\u9676:e.terracotta,\u9508\u7EA2:e.rust,\u68D5:e.brown,\u68D5\u8272:e.brown,\u8910\u8272:e.brown,\u5496\u5561\u8272:e.brown,\u7EA2:e.red,\u7EA2\u8272:e.red,\u6731\u7EA2:e.red,\u7EEF\u7EA2:e.crimson,\u6DF1\u7EA2:e.crimson,\u9152\u7EA2:e.wine,\u73AB\u7470:e.rose,\u73AB\u7EA2:e.rose,\u7C89:e.pink,\u7C89\u8272:e.pink,\u7C89\u7EA2:e.pink,\u6D0B\u7EA2:e.magenta,\u54C1\u7EA2:e.magenta,\u7D2B:e.purple,\u7D2B\u8272:e.purple,\u6DE1\u7D2B:e.lavender,\u85B0\u8863\u8349:e.lavender,\u7D2B\u7F57\u5170:e.violet,\u6885\u7EA2:e.plum,\u7070:e.gray,\u7070\u8272:e.gray,\u6D45\u7070:e.gray,\u6DE1\u7070:e.gray,\u51B7\u7070:e["cool gray"],\u51B7\u7070\u767D:e["cool gray"],\u6696\u7070:e.stone,\u6DF1\u7070:e.slate,\u77F3\u58A8\u7070:e.slate,\u77F3\u677F\u7070:e.slate,\u70AD\u7070:e.charcoal,\u70AD\u9ED1:e.charcoal,\u58A8:e.ink,\u58A8\u8272:e.ink,\u9ED1:e.ink,\u9ED1\u8272:e.ink,\u767D:e["clean white"],\u767D\u8272:e["clean white"],\u7C73\u767D:e.cream,\u7C73\u8272:e.cream,\u8C61\u7259\u767D:e.cream,\u5976\u6CB9\u767D:e.cream,\u6C99\u8272:e.sand},F={...e,...J};function T(t){let o=t.colorSeeds??{primary:"slate",accent:"blue",neutral:"zinc"},r=t.surfaceMode,n=y(o.primary||"slate"),c=s(n),l=s(y(o.accent||"blue")),h=o.neutral?y(o.neutral):Y(n),i=u(h.h),d,a,f,g,S,E;r==="dark"?(d=s({mode:"oklch",l:.14,c:.03,h:i}),a=s({mode:"oklch",l:.95,c:.02,h:i}),f=s({mode:"oklch",l:.2,c:.04,h:i}),g=s({mode:"oklch",l:.29,c:.05,h:i}),S=s({mode:"oklch",l:.78,c:.02,h:i}),E=s({mode:"oklch",l:.35,c:.06,h:i})):(d=s({mode:"oklch",l:.98,c:.01,h:i}),a=s({mode:"oklch",l:.2,c:.02,h:i}),f=s({mode:"oklch",l:.96,c:.015,h:i}),g=s({mode:"oklch",l:.92,c:.02,h:i}),S=s({mode:"oklch",l:.43,c:.02,h:i}),E=s({mode:"oklch",l:.84,c:.025,h:i}));let m=t.imagePalette;if(m){let C=typeof m.background=="string"&&w(m.background),x=C&&te(m.background,r);C&&x&&(d=s(y(m.background))),x&&typeof m.card=="string"&&w(m.card)&&(f=s(y(m.card))),x&&typeof m.muted=="string"&&w(m.muted)&&(g=s(y(m.muted))),typeof m.foreground=="string"&&w(m.foreground)?a=L(s(y(m.foreground)),d,I):C&&x&&(a=v(d)),typeof m.border=="string"&&w(m.border)&&(E=oe(s(y(m.border)),d))}typeof o.foreground=="string"&&w(o.foreground)&&(a=L(s(y(o.foreground)),d,I));let M=r!=="dark",P={"--background":d,"--foreground":a,"--card":f,"--card-foreground":a,"--muted":g,"--muted-foreground":S,"--border":E,"--input":E,"--ring":l,"--primary":c,"--primary-foreground":v(c),"--primary-hover":O(c,M),"--accent":l,"--accent-foreground":v(l),"--accent-ink":A(l,d),"--accent-subtle":Z(l,M),"--accent-hover":O(l,M),"--overlay-on-dark":s({mode:"oklch",l:.96,c:.02,h:i}),"--overlay-on-light":s({mode:"oklch",l:.2,c:.02,h:i})},H=a,G=v(a),$=_(a,i),V=A(l,a),z=p(k(c)??c),U=u(z?.h),j=_(c,U),K=A(l,c);return W({...P,...{"--surface-inverse":H,"--surface-inverse-foreground":G,"--surface-inverse-muted":$,"--surface-inverse-accent-ink":V,"--surface-primary-muted":j,"--surface-primary-accent-ink":K}},o)}function W(t,o){let r=s({mode:"oklch",l:.58,c:.22,h:28}),n=s({mode:"oklch",l:.6,c:.14,h:150}),c=s({mode:"oklch",l:.75,c:.15,h:75}),l={...t,"--popover":"var(--card)","--popover-foreground":"var(--card-foreground)","--secondary":"var(--muted)","--secondary-foreground":"var(--foreground)","--destructive":r,"--destructive-foreground":v(r),"--success":n,"--success-foreground":v(n),"--warning":c,"--warning-foreground":v(c)},[h,i]=X(o,l);return l["--supporting-0"]=h,l["--supporting-1"]=i,ee(l["--accent"]).forEach((a,f)=>{l[`--chart-${f+1}`]=a}),l}function X(t,o){let c=(t.supporting??[]).filter(h=>!!(h&&h.trim())).slice(0,2).map(h=>s(y(h))),l=[o["--primary"],o["--accent"]];for(;c.length<2;)c.push(l[c.length]);return[c[0],c[1]]}function w(t){let o=(t??"").trim();if(!o||o.startsWith("#")&&!/^#[0-9A-Fa-f]{3,8}$/.test(o))return!1;let r=F[o.toLowerCase()]??o;return!!k(r)}function y(t,o="paper"){let r=(t??"").trim();if(!r)return y(o);let n=F[r.toLowerCase()]??r,c=k(n);if(c){let l=p(c);if(l)return l}return Q(r)}function Q(t){let o=2166136261,r=t.toLowerCase();for(let h=0;h<r.length;h++)o^=r.charCodeAt(h),o=Math.imul(o,16777619)>>>0;let n=o%360,c=.08+(o>>>9)%9/100;return{mode:"oklch",l:.52+(o>>>18)%16/100,c,h:n}}function Y(t){return{mode:"oklch",l:.6,c:.02,h:u(t.h)}}function O(t,o){let r=p(k(t)??t);if(!r)return t;let n=o?-.06:.06,c=Math.max(.06,Math.min(.97,u(r.l)+n));return s({mode:"oklch",l:c,c:u(r.c),h:u(r.h)})}function Z(t,o){let r=p(k(t)??t),n=u(r?.h),c=Math.min(u(r?.c),o?.05:.06);return s({mode:"oklch",l:o?.95:.24,c,h:n})}function ee(t){let o=p(k(t)??t),r=u(o?.h),n=Math.max(.12,Math.min(u(o?.c),.16));return[0,72,144,216,288].map(c=>s({mode:"oklch",l:.62,c:n,h:(r+c)%360}))}function v(t){let o=k(t),r=o?p(o):void 0,n=u(r?.h),c={mode:"oklch",l:.99,c:.01,h:n},l={mode:"oklch",l:.18,c:.02,h:n},h=b(o??t,c),i=b(o??t,l);return s(h>=i?c:l)}function L(t,o,r){let n=p(k(t)??t);if(!n)return v(o);if(b(t,o)>=r)return s(n);let c=p(k(o)??o),h=(c?u(c.l)>=.5:!0)?-.02:.02,i=u(n.l),d=u(n.c),a=u(n.h);for(let f=1;f<=50;f++){let g=i+h*f;if(g<=0||g>=1)break;let S={mode:"oklch",l:g,c:d,h:a};if(b(S,o)>=r)return s(S)}return v(o)}var D=1.3;function oe(t,o){let r=p(k(t)??t);if(!r)return t;if(b(t,o)>=D)return s(r);let n=p(k(o)??o),l=(n?u(n.l)>=.5:!0)?-.03:.03,h=u(r.l),i=u(r.c),d=u(r.h);for(let a=1;a<=40;a++){let f=h+l*a;if(f<=0||f>=1)break;let g={mode:"oklch",l:f,c:i,h:d};if(b(g,o)>=D)return s(g)}return t}function te(t,o){let r=p(k(t)??t);if(!r)return!1;let n=u(r.l)>=.5;return o==="dark"?!n:n}function A(t,o){let r=p(k(t)??t);if(!r)return t;let n=u(r.h),c=u(r.c),l=u(r.l),h=p(k(o)??o),d=(h?u(h.l)>=.5:!0)?-.02:.02;for(let a=0;a<=50;a++){let f=l+d*a;if(f<=0||f>=1)break;let g={mode:"oklch",l:f,c,h:n};if(b(g,o)>=I)return s(g)}return v(o)}function _(t,o){let r=p(k(t)??t),c=(r?u(r.l):.5)>=.5,l=c?.75:.35,h=c?-.02:.02;for(let i=0;i<=50;i++){let d=l+h*i;if(d<=0||d>=1)break;let a={mode:"oklch",l:d,c:.02,h:o};if(b(a,t)>=I)return s(a)}return v(t)}function u(t){return typeof t=="number"&&Number.isFinite(t)?t:0}function s(t){let o=u(t.l),r=u(t.c),n=u(t.h);return`oklch(${o.toFixed(2)} ${r.toFixed(2)} ${n.toFixed(2)})`}var ce=10,N=25,le=re("oklch"),ae=ne();function se(t){return typeof t.colorSeeds?.primary=="string"&&t.colorSeeds.primary.trim().length>0}function R(t){let o=le(t);return o&&typeof o.h=="number"?o.h:void 0}function B(t){let o=0;for(let r=0;r<t.length;r+=1)for(let n=r+1;n<t.length;n+=1){let c=t[r],l=t[n];if(c===void 0||l===void 0)continue;let h=Math.abs(c-l)%360,i=h>180?360-h:h;i>o&&(o=i)}return o}function ie(t){let o=0,r=1/0;for(let n=0;n<t.length;n+=1)for(let c=n+1;c<t.length;c+=1){let l=ae(t[n],t[c]);l>o&&(o=l),l<r&&(r=l)}return{max:o,min:r===1/0?0:r}}function ke(t){let o=t.filter(se);if(o.length<2)return{minBackgroundDeltaE:null,tooSimilar:!1,insufficient:!0};let r=o.map(a=>a.surfaceMode??"light"),n=o.map((a,f)=>T({colorSeeds:a.colorSeeds,surfaceMode:r[f]})),c=ie(n.map(a=>a["--background"])),l=B(n.map(a=>R(a["--primary"]))),h=B(n.map(a=>R(a["--accent"]))),d=!(new Set(r).size===1)||c.max>=ce||l>=N||h>=N;return{minBackgroundDeltaE:c.min,tooSimilar:!d,insufficient:!1}}export{ke as measureColorwayDistinctness};

package/dist/connect-dynamic-collection.d.ts

@@ -8,11 +8,11 @@ export declare const FieldDeclSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
+        url: "url";
         title: "title";
         text: "text";
         richtext: "richtext";
         datetime: "datetime";
-        url: "url";
         email: "email";
         color: "color";
         select: "select";
@@ -46,17 +46,21 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
     route_file_path: z.ZodString;
     target_component_path: z.ZodString;
     content_type_hint: z.ZodString;
+    collection_purpose: z.ZodOptional<z.ZodEnum<{
+        generic: "generic";
+        product: "product";
+    }>>;
     required_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
             date: "date";
+            url: "url";
             title: "title";
             text: "text";
             richtext: "richtext";
             datetime: "datetime";
-            url: "url";
             email: "email";
             color: "color";
             select: "select";
@@ -81,11 +85,11 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
             number: "number";
             boolean: "boolean";
             date: "date";
+            url: "url";
             title: "title";
             text: "text";
             richtext: "richtext";
             datetime: "datetime";
-            url: "url";
             email: "email";
             color: "color";
             select: "select";

package/dist/connect-form.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
  * 词表→CMS 表单字段类型映射在 agent 侧 `cms/forms/field-type-to-form.ts`，
  * 与 connect-dynamic-collection 的 FIELD_TYPES/field-type-to-cms 同款分层。
  */
-export declare const FORM_FIELD_TYPES: readonly ["text", "textarea", "email", "phone", "select", "radio", "multiselect", "boolean", "date", "number"];
+export declare const FORM_FIELD_TYPES: readonly ["text", "textarea", "email", "phone", "select", "radio", "multiselect", "boolean", "date", "number", "file"];
 export type FormFieldType = (typeof FORM_FIELD_TYPES)[number];
 export declare const FormFieldDeclSchema: z.ZodObject<{
     name: z.ZodString;
@@ -12,6 +12,7 @@ export declare const FormFieldDeclSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
+        file: "file";
         text: "text";
         email: "email";
         select: "select";
@@ -40,6 +41,7 @@ export declare const ConnectFormInputSchema: z.ZodObject<{
             number: "number";
             boolean: "boolean";
             date: "date";
+            file: "file";
             text: "text";
             email: "email";
             select: "select";
@@ -70,9 +72,9 @@ export type ConnectFormResult = {
     fields: ResolvedFormField[];
     /** 历史表单来源页 id，仅用于旧生成站点兼容；当前提交按 url_path 解析真实页面。 */
     source_page_id: number | null;
-    /** LLM 要写的表单 view 组件路径（必须 "use client"）。 */
+    /** 公开 Workspace 工具已创建的标准表单容器路径；调用方只负责挂载。 */
     form_view: string;
-    /** 逐字段人话渲染契约 + 提交链路用法（LLM 写 form view 的零猜测依据），确定性派生。 */
+    /** 标准容器挂载契约，确定性派生；不得据此另写 form view。 */
     form_contract: string;
     /** 工具已写入 working set 的确定性产物路径——LLM 绝不可再 create/覆盖。 */
     created_files: string[];
@@ -92,8 +94,8 @@ export type ConnectFormResult = {
 }
 /**
  * 幂等命中：该表单的 scaffold 已存在于 base snapshot（此前 run 绑定过），
- * 本次会补建或升级确定性提交基建。LLM 收到后下一步：按实时重算的 form_contract 写 form view，
- * 绝不重建 existing_files、绝不手写提交链路（与 connect_dynamic_collection
+ * 本次会补建或升级确定性提交基建。该状态只保留给旧内部调用方；公开 Workspace
+ * 工具不会再进入 legacy scaffold。绝不重建 existing_files、绝不手写提交链路（与 connect_dynamic_collection
  * 的 already_bound 同款）。
  */
  | {

package/dist/conversion-hints.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+/**
+ * 用户已确认的转化目标（访客该怎么迈出下一步）。
+ *
+ * 两条上游都写这个形状，下游只认这一个：
+ * - 旧 Clarify 流：转化题每个 option 自带 `conversionHints`，API 把选中项镜像到
+ *   `SitemapAnswer.conversion`，sitemap.service 再提到
+ *   `SitemapSchema.confirmedChoices.conversion`。
+ * - 新 Launcher 流：Step5 转化卡是自由文本，没有结构化协议可读；由 Step6 设计
+ *   推荐那一次已有的模型调用顺带产出，结构确认物化设计选择时写进同一个位置。
+ *
+ * 下游 inspect-sitemap / DesignPlan / worker prompt 据此读到用户确认的转化目标，
+ * 不依赖 block props。
+ *
+ * 字段语义：
+ * - protocol：访客怎么完成这个动作 —— phone（tel: 链接）、form（留资表单）、
+ *   download（文件）、route（站内页面）、external（第三方地址）。
+ * - ctaLabel：具体的行动号召文案，能确定站点语种时就用站点语种，否则用需求
+ *   原文的语言（≤40 字），如「立即致电咨询」或 "Book a consultation"。
+ * - ctaTarget：可选的具体目标 —— 电话号码 / 站内路径 / 网址 / 锚点；缺省时由
+ *   站主稍后补。
+ * - requiresOwnerDetail：该协议需要一项需求里没有的站主信息时为 true（例如选了
+ *   电话但没给号码）。
+ */
+export declare const ConversionHintsSchema: 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>;
+export type ConversionHints = z.infer<typeof ConversionHintsSchema>;