@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/subsite-localization-input.d.ts

@@ -0,0 +1,121 @@
+import { z } from "zod";
+/**
+ * 子站本地化的**上游可传入参**合同：术语表与站点信息。
+ *
+ * 两项都可选，两项都遵循同一条取向：**服务不猜上游本该给的东西**。子站编排链路
+ * 上只有调用方知道「这个品牌词该译成什么」「这个站是做什么的」，服务端能做的只是
+ * 从主站已有数据里尽力还原一份兜底；传了就用传的，没传才走兜底。
+ *
+ * 三个使用点共用本文件：`apps/api` 公网入口（subsites.controller）、
+ * 该入口组装的入队 payload（subsites.service）、以及 `services/subsite-service`
+ * 侧对 payload 的读取。口径只此一份。
+ */
+/** 单条术语表条目的长度上限。原文与译文都是短语，超长即为误用。 */
+export declare const SUBSITE_GLOSSARY_ENTRY_MAX_CHARS = 200;
+/**
+ * 术语表条目数上限。术语表随**每一个**翻译批次一起发出去（不是每站一次），
+ * 条数直接乘进每批的输入 token，因此必须有上界。
+ */
+export declare const SUBSITE_GLOSSARY_MAX_ENTRIES = 200;
+/**
+ * 术语表条目的形态：`"原文:译文"`，半角冒号分隔，取第一个冒号为分隔点
+ * （译文里可以再出现冒号）。
+ *
+ * ✓ 实测（dev 翻译服务，2026-08-16）：术语表是**以指令方式交给模型**的，不是
+ * 字符串替换——同一批 6 条含品牌词的中文，不带术语表时译名在
+ * `SANY Heavy Industry` 与 `Sany Heavy Industry` 之间三三分裂；带上
+ * `三一重工:SANY` 后 6/6 全部落在 `SANY`。这正是「一个品牌名在产出站里裂成三种
+ * 写法」这条缺陷的修法。
+ *
+ * 返回 `null` 表示形态不合格（没有冒号、冒号在首位、或某一侧只有空白）。
+ */
+export declare function splitSubsiteGlossaryEntry(entry: string): {
+    readonly source: string;
+    readonly target: string;
+} | null;
+/**
+ * 单条术语表条目。**刻意不做 transform**：schema effect 会让 `z.toJSONSchema`
+ * 抛错，连带炸掉 OpenAPI 文档生成（与 `SubsiteMountPathSchema` 同一条约束）。
+ * refine 只校验不改值，条目原样进入翻译请求体。
+ */
+export declare const SubsiteGlossaryEntrySchema: z.ZodString;
+export declare const SubsiteGlossariesSchema: z.ZodArray<z.ZodString>;
+/**
+ * 翻译服务的站点上下文。
+ *
+ * **只有 `website_name` 必填**，行业与一句话简介可缺。✓ 实测（dev，2026-08-16）：
+ * 该服务对 `site_info` 既不强制存在、也不要求三项齐全——完全不带 `site_info`
+ * 与只带 `website_name` 都返回 200 且译文正常。因此「凑不齐三项」不是中止本地化
+ * 的正当理由：缺的字段省略掉，照常翻译，把不完整记成可观测的降级信号。
+ */
+export declare const SubsiteSiteInfoSchema: z.ZodObject<{
+    website_name: z.ZodString;
+    website_industry: z.ZodOptional<z.ZodString>;
+    website_description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsiteSiteInfo = z.infer<typeof SubsiteSiteInfoSchema>;
+/**
+ * 配色本地化档位。
+ *
+ * **只约束颜色与明暗底面，不约束图片**：`fonts_only` 档下用户在 `note` 里写的
+ * 换图诉求仍然生效。档位这个词容易被读成「什么都不变」，界面提示语必须写明这一点。
+ *
+ * 只有两档，却覆盖三级优先级：锁定色值不是第三种模式，而是在 `regional` 档下
+ * 按槽施加的约束（见 `SubsitePaletteSeedsSchema`）。
+ */
+export declare const SubsitePaletteModeSchema: z.ZodEnum<{
+    regional: "regional";
+    fonts_only: "fonts_only";
+}>;
+export type SubsitePaletteMode = z.infer<typeof SubsitePaletteModeSchema>;
+/**
+ * 用户锁定的色值。只接受 `#rrggbb`——界面给的是取色器，出来就是十六进制；
+ * 模型面 schema 允许 CSS 颜色名是给模型的宽容度，用户输入不需要那份宽容。
+ *
+ * **刻意不做 transform**：schema effect 会让 `z.toJSONSchema` 抛错，连带炸掉
+ * OpenAPI 文档生成（与 `SubsiteGlossaryEntrySchema` 同一条约束）。
+ */
+export declare const SubsiteHexColorSchema: z.ZodString;
+/**
+ * 四个角色与 `DesignColorSeeds` 一一对应，不自造一套命名。**逐槽可选**：
+ * 填了的槽服务端强制覆盖模型产出，空槽交给模型按目标地区补齐。
+ */
+export declare const SubsitePaletteSeedsSchema: z.ZodObject<{
+    primary: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    foreground: z.ZodOptional<z.ZodString>;
+    neutral: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsitePaletteSeeds = z.infer<typeof SubsitePaletteSeedsSchema>;
+/** 风格补充说明的长度上限。整段进用户提示词，必须有上界。 */
+export declare const SUBSITE_PALETTE_NOTE_MAX_CHARS = 600;
+export declare const SubsitePaletteLocalizationSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        regional: "regional";
+        fonts_only: "fonts_only";
+    }>>;
+    seeds: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+        neutral: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsitePaletteLocalization = z.infer<typeof SubsitePaletteLocalizationSchema>;
+/**
+ * 缺省档位。
+ *
+ * 存在的理由是一个容易踩的 zod 行为：上游把整个 `palette` 声明成 `.optional()`
+ * 之后，字段整体缺席时解析结果是 `undefined`，内层 `mode` 的 `.default()`
+ * **根本没机会触发**。若不在服务端显式补这一格，`undefined` 会一路传到底，
+ * 而下游每一层都得自己猜「空了算哪档」——同样的请求会产出不同结果。
+ */
+export declare const DEFAULT_SUBSITE_PALETTE: SubsitePaletteLocalization;
+/**
+ * 是否锁了至少一个色值槽。
+ *
+ * 两个使用点共用：公网入口据此拒绝「只改字体 + 又锁了色值」这种矛盾输入；
+ * 决策侧据此决定要不要逐槽压掉模型的颜色产出。
+ */
+export declare function hasLockedSeeds(seeds: SubsitePaletteSeeds | undefined): boolean;

package/dist/subsite-mount-path.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * 子站挂载路径合同（设计 5.3 约束 3）：单层、小写、带前导斜杠、不带尾斜杠，
+ * 形如 `/fr`。三个校验点——apps/api 公网入口（subsites.controller）、
+ * apps/api 内部回写（internal-subsites.controller）、subsite-service 入队
+ * （subsite-jobs.controller）——共用本文件，口径只此一份。
+ */
+export declare const SUBSITE_MOUNT_PATH_PATTERN: RegExp;
+/**
+ * 设计 5.4 保留段清单：主站基础设施占用的一级路径，不得作为 `mount_path`。
+ * `_next` / `robots.txt` / `sitemap.xml` / `.well-known` 当前已被字符集正则
+ * 天然挡掉（下划线与点号不在集合内），仍全量列出——保留段语义不依赖正则的
+ * 具体收紧程度，正则将来放宽（如允许点号后缀）时清单继续兜底。
+ */
+export declare const SUBSITE_RESERVED_MOUNT_SEGMENTS: readonly ["api", "_next", "assets", "static", "robots.txt", "sitemap.xml", ".well-known"];
+/** 传入不带前导斜杠的一级段（如 `api`）。 */
+export declare function isReservedSubsiteMountSegment(segment: string): boolean;
+/**
+ * 唯一的 `mount_path` 校验 schema：形态正则 + 保留段拦截。
+ * 刻意不做 transform（schema effect 会让 `z.toJSONSchema` 抛错，
+ * 连带炸掉 OpenAPI 文档生成），refine 仅校验不改值。
+ */
+export declare const SubsiteMountPathSchema: z.ZodString;

package/dist/subsite-visible-text-export.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+/**
+ * apps/api 调用 subsite-service 导出站点静态可见文本时的内部合同。
+ * tenant_id 是主库 text 主键（例如 tenant_dev），不是 UUID。
+ */
+export declare const SubsiteVisibleTextExportRequestSchema: z.ZodObject<{
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    snapshot_id: z.ZodUUID;
+    manifest_hash: z.ZodString;
+    object_key: z.ZodString;
+}, z.core.$strip>;
+export type SubsiteVisibleTextExportRequest = z.infer<typeof SubsiteVisibleTextExportRequestSchema>;
+/** 内部服务返回 Markdown 正文及可审计计数；公网接口只下载 markdown 字段。 */
+export declare const SubsiteVisibleTextExportResponseSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    snapshot_id: z.ZodUUID;
+    unit_count: z.ZodNumber;
+    file_count: z.ZodNumber;
+    markdown: z.ZodString;
+}, z.core.$strip>;
+export type SubsiteVisibleTextExportResponse = z.infer<typeof SubsiteVisibleTextExportResponseSchema>;

package/dist/template-upgrade-observability.d.ts

@@ -19,8 +19,8 @@ export declare const TemplateUpgradeValidationStageSchema: z.ZodEnum<{
 }>;
 export type TemplateUpgradeValidationStage = z.infer<typeof TemplateUpgradeValidationStageSchema>;
 export declare const TemplateUpgradeCasOutcomeSchema: z.ZodEnum<{
-    not_attempted: "not_attempted";
     promoted: "promoted";
+    not_attempted: "not_attempted";
     aborted: "aborted";
 }>;
 export type TemplateUpgradeCasOutcome = z.infer<typeof TemplateUpgradeCasOutcomeSchema>;
@@ -50,8 +50,8 @@ export declare const RecordTemplateUpgradeEventRequestSchema: z.ZodObject<{
         validation: "validation";
     }>>;
     cas_outcome: z.ZodNullable<z.ZodEnum<{
-        not_attempted: "not_attempted";
         promoted: "promoted";
+        not_attempted: "not_attempted";
         aborted: "aborted";
     }>>;
 }, z.core.$strict>;

package/dist/theme-presets.d.ts

@@ -6,13 +6,68 @@
  * resources (workspace ns, keyed by preset id) and switch with the locale;
  * the preset itself only holds stable data (id + seeds), never a label.
  */
-export type ThemePresetId = "ocean" | "forest" | "clay" | "violet" | "graphite" | "crimson";
+import type { SiteDesignRadiusId } from "./site-design-presets.js";
+export declare const THEME_PRESET_IDS: readonly ["ocean", "forest", "clay", "violet", "graphite", "crimson"];
+export type ThemePresetId = (typeof THEME_PRESET_IDS)[number];
+/**
+ * 旧 Step6 AI 目录的主题 id（`ai-*`）。生成式主题卡上线后不再有新推荐使用
+ * 这些 id，仅保留给存量 selection 行与历史推荐读取兼容（schema 并集的一员）。
+ */
+export declare const STEP6_AI_THEME_IDS: readonly ["ai-forest", "ai-navy", "ai-steel"];
+export type Step6AiThemeId = (typeof STEP6_AI_THEME_IDS)[number];
+/**
+ * 生成式主题卡 id：API 侧按卡片内容确定性派生（见 step6-design.service 的
+ * 拼接序列化），形状 `gen-` + 8 位小写 hex。内容相同则 id 相同。
+ */
+export declare const STEP6_GENERATED_THEME_ID_PATTERN: RegExp;
+export type Step6GeneratedThemeId = `gen-${string}`;
+export type SiteDesignThemeId = ThemePresetId | Step6AiThemeId | Step6GeneratedThemeId;
 export interface ThemePreset {
     /** Stable identity; the i18n display name keys off this. */
     id: ThemePresetId;
     colorSeeds: {
         primary: string;
         accent: string;
+        foreground: string;
     };
+    surfaceMode: "light" | "dark";
+    /**
+     * 该主题的默认圆角档位。用户在 Step6 换主题时随之带出，
+     * 之后仍可单独调整；调整过就不再被换主题覆盖。
+     */
+    radius: SiteDesignRadiusId;
 }
+export interface Step6AiThemePreset {
+    /**
+     * 旧目录 id（`ai-*`）。新推荐不再使用——生成卡用 `gen-*` id、fallback 卡也按
+     * 内容派生 `gen-*` id。保留该字段只为记录每套 fallback 内容对应的旧目录身份，
+     * 并让 `getSiteDesignThemeRadius` 能回答存量 `ai-*` 选择的圆角回退。
+     */
+    id: Step6AiThemeId;
+    name: string;
+    description: string;
+    /** fallback 卡的原因文案（为什么这套适合作为默认兜底）。 */
+    fallbackReason: string;
+    colorSeeds: {
+        primary: string;
+        accent: string;
+        foreground: string;
+    };
+    surfaceMode: "light" | "dark";
+    radius: SiteDesignRadiusId;
+}
+/**
+ * Step6 设计推荐的 deterministic fallback 内容：模型生成连续失败时，API 侧用
+ * 这三套人工调过的锚点造卡（`buildStep6FallbackThemeCards`），保证「卡必达」。
+ * 不再是模型排序的目录——生成式方案里颜色由模型按站点现场 authoring。
+ */
+export declare const STEP6_AI_THEME_PRESETS: readonly Step6AiThemePreset[];
 export declare const THEME_PRESETS: readonly ThemePreset[];
+export declare function getThemePreset(id: ThemePresetId): ThemePreset;
+/**
+ * 主题（含存量 `ai-*` 候选）对应的默认圆角档位。id 不认识时返回 undefined，
+ * 由调用方决定回退，避免在合同层吞掉未知主题。生成卡（`gen-*`）自带 radius，
+ * 不走这里。入参放宽为 string：zod 的 regex schema 推断类型是 string，
+ * 本函数只做查表，不认识就 undefined。
+ */
+export declare function getSiteDesignThemeRadius(id: string): SiteDesignRadiusId | undefined;

package/dist/user-facing-copy.d.ts

@@ -23,6 +23,7 @@ export declare const ERROR_COPY: {
     readonly WORKSPACE_MODEL_STREAM_ABORTED: "Generation was interrupted before finishing. Please try again.";
     readonly MODEL_OUTPUT_TRUNCATED: "The response was too long and was cut off before any change was applied. Try again, or split the request into smaller changes.";
     readonly WORKSPACE_EDIT_NOT_APPLIED: "No change was applied. Try describing the change differently.";
+    readonly PRODUCT_SEARCH_APPLY_NOT_AVAILABLE: "Product search changes aren't available yet. Please try again later.";
     readonly WORKSPACE_INITIAL_EXECUTION_FAILED: "Initial generation failed. Please retry from the brief.";
     readonly WORKSPACE_INITIAL_GENERATION_CHECK_FAILED: "Initial generation could not be verified. Please retry.";
     readonly WORKSPACE_INITIAL_GENERATION_FINALIZE_FAILED: "Initial generation could not finalize. Please retry.";

package/dist/workspace-design-apply.d.ts

@@ -4,7 +4,12 @@ export declare const WorkspaceDesignApplyRequestSchema: z.ZodObject<{
     colorSeeds: z.ZodOptional<z.ZodObject<{
         primary: z.ZodString;
         accent: z.ZodString;
+        foreground: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    surfaceMode: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
     fonts: z.ZodOptional<z.ZodObject<{
         heading: z.ZodString;
         body: z.ZodString;

package/dist/workspace-resource-operation.d.ts

@@ -1,14 +1,14 @@
 import { z } from "zod";
 export declare const WorkspaceResourceKindSchema: z.ZodEnum<{
-    page: "page";
     pages: "pages";
+    page: "page";
     component: "component";
 }>;
 export type WorkspaceResourceKind = z.infer<typeof WorkspaceResourceKindSchema>;
 export declare const WorkspaceResourceOperationSummarySchema: z.ZodObject<{
     resource_kind: z.ZodEnum<{
-        page: "page";
         pages: "pages";
+        page: "page";
         component: "component";
     }>;
     resource_name: z.ZodString;
@@ -35,7 +35,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
         id: z.ZodString;
         siteId: z.ZodUUID;
         baseSnapshotId: z.ZodUUID;
-        routeId: z.ZodOptional<z.ZodString>;
+        composition: z.ZodObject<{
+            routeId: z.ZodString;
+            templateId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
         kind: z.ZodEnum<{
             "insert-child": "insert-child";
             "update-text": "update-text";
@@ -47,24 +50,31 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
             "apply-style-draft": "apply-style-draft";
             "source-edit": "source-edit";
             "insert-page-resource": "insert-page-resource";
+            "delete-page-source": "delete-page-source";
         }>;
         target: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"node">;
             key: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page-unit">;
-            routeId: z.ZodString;
+            composition: z.ZodObject<{
+                routeId: z.ZodString;
+                templateId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
             placementUnitKey: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"route">;
-            routeId: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+            composition: z.ZodObject<{
+                routeId: z.ZodString;
+                templateId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"source-file">;
             path: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"source-batch">;
             paths: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"project">;
         }, z.core.$strict>], "kind">;
         documentVersion: z.ZodNumber;
@@ -143,7 +153,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
-                routeId: z.ZodString;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 placementUnitKey: z.ZodString;
                 relation: z.ZodEnum<{
                     before: "before";
@@ -155,6 +168,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
             }, z.core.$strict>]>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"move-node">;
@@ -174,7 +191,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
-                routeId: z.ZodString;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 placementUnitKey: z.ZodString;
                 relation: z.ZodEnum<{
                     before: "before";
@@ -186,7 +206,6 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
             preserveBindings: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"set-class-name-source">;
-            routeId: z.ZodOptional<z.ZodString>;
             filePath: z.ZodString;
             expectedVersion: z.ZodObject<{
                 documentVersion: z.ZodNumber;
@@ -227,7 +246,6 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"apply-style-draft">;
             className: z.ZodOptional<z.ZodObject<{
-                routeId: z.ZodOptional<z.ZodString>;
                 filePath: z.ZodString;
                 expectedVersion: z.ZodObject<{
                     documentVersion: z.ZodNumber;
@@ -289,11 +307,11 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
             artifact: z.ZodObject<{
                 resource_id: z.ZodString;
                 resource_type: z.ZodEnum<{
-                    page: "page";
                     pages: "pages";
+                    page: "page";
                 }>;
-                resolved_version: z.ZodString;
-                revision_id: z.ZodString;
+                resolved_version: z.ZodNumber;
+                revision_id: z.ZodOptional<z.ZodString>;
                 digest_sha256: z.ZodString;
                 components: z.ZodArray<z.ZodObject<{
                     component_id: z.ZodString;
@@ -345,8 +363,11 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 }, z.core.$strict>>;
                 project_dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNever>>;
             }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"delete-page-source">;
+            expectedUrlPath: z.ZodString;
         }, z.core.$strict>], "kind">;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     navigation_selection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"none">;
     }, z.core.$strict>, z.ZodObject<{
@@ -370,8 +391,8 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
         client_message_id: z.ZodString;
         display: z.ZodObject<{
             resource_kind: z.ZodEnum<{
-                page: "page";
                 pages: "pages";
+                page: "page";
                 component: "component";
             }>;
             resource_name: z.ZodString;
@@ -387,7 +408,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                 id: z.ZodString;
                 siteId: z.ZodUUID;
                 baseSnapshotId: z.ZodUUID;
-                routeId: z.ZodOptional<z.ZodString>;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 kind: z.ZodEnum<{
                     "insert-child": "insert-child";
                     "update-text": "update-text";
@@ -399,24 +423,31 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                     "apply-style-draft": "apply-style-draft";
                     "source-edit": "source-edit";
                     "insert-page-resource": "insert-page-resource";
+                    "delete-page-source": "delete-page-source";
                 }>;
                 target: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"node">;
                     key: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"page-unit">;
-                    routeId: z.ZodString;
+                    composition: z.ZodObject<{
+                        routeId: z.ZodString;
+                        templateId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
                     placementUnitKey: z.ZodString;
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"route">;
-                    routeId: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                    composition: z.ZodObject<{
+                        routeId: z.ZodString;
+                        templateId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"source-file">;
                     path: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"source-batch">;
                     paths: z.ZodArray<z.ZodString>;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"project">;
                 }, z.core.$strict>], "kind">;
                 documentVersion: z.ZodNumber;
@@ -495,7 +526,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
-                        routeId: z.ZodString;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                         placementUnitKey: z.ZodString;
                         relation: z.ZodEnum<{
                             before: "before";
@@ -507,6 +541,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                     }, z.core.$strict>]>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"move-node">;
@@ -526,7 +564,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
-                        routeId: z.ZodString;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                         placementUnitKey: z.ZodString;
                         relation: z.ZodEnum<{
                             before: "before";
@@ -538,7 +579,6 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                     preserveBindings: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"set-class-name-source">;
-                    routeId: z.ZodOptional<z.ZodString>;
                     filePath: z.ZodString;
                     expectedVersion: z.ZodObject<{
                         documentVersion: z.ZodNumber;
@@ -579,7 +619,6 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"apply-style-draft">;
                     className: z.ZodOptional<z.ZodObject<{
-                        routeId: z.ZodOptional<z.ZodString>;
                         filePath: z.ZodString;
                         expectedVersion: z.ZodObject<{
                             documentVersion: z.ZodNumber;
@@ -641,11 +680,11 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                     artifact: z.ZodObject<{
                         resource_id: z.ZodString;
                         resource_type: z.ZodEnum<{
-                            page: "page";
                             pages: "pages";
+                            page: "page";
                         }>;
-                        resolved_version: z.ZodString;
-                        revision_id: z.ZodString;
+                        resolved_version: z.ZodNumber;
+                        revision_id: z.ZodOptional<z.ZodString>;
                         digest_sha256: z.ZodString;
                         components: z.ZodArray<z.ZodObject<{
                             component_id: z.ZodString;
@@ -697,8 +736,11 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         }, z.core.$strict>>;
                         project_dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNever>>;
                     }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"delete-page-source">;
+                    expectedUrlPath: z.ZodString;
                 }, z.core.$strict>], "kind">;
-            }, z.core.$strip>;
+            }, z.core.$strict>;
             navigation_selection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"none">;
             }, z.core.$strict>, z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/contracts",
-  "version": "0.6.10",
+  "version": "0.7.0",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -51,6 +51,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@noble/hashes": "^1.8.0",
     "culori": "^4.0.2",
     "zod": "^4.0.0"
   },

package/dist/publish-plan.d.ts

@@ -1,54 +0,0 @@
-import { z } from "zod";
-export declare const PublishPlanFeatureSnapshotSchema: z.ZodObject<{
-    maxSites: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    maxStorageMb: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    customDomains: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-}, z.core.$loose>;
-export type PublishPlanFeatureSnapshot = z.infer<typeof PublishPlanFeatureSnapshotSchema>;
-export declare const PublishPlanSchema: z.ZodObject<{
-    subscriptionId: z.ZodString;
-    planId: z.ZodString;
-    locale: z.ZodUnion<[z.ZodEnum<{
-        en: "en";
-        zh_CN: "zh_CN";
-    }>, z.ZodString]>;
-    currentPeriodEnd: z.ZodNullable<z.ZodString>;
-    servicePeriodEnd: z.ZodNullable<z.ZodString>;
-    featureSnapshot: z.ZodNullable<z.ZodObject<{
-        maxSites: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        maxStorageMb: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        customDomains: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    }, z.core.$loose>>;
-    code: z.ZodNullable<z.ZodString>;
-    level: z.ZodNullable<z.ZodNumber>;
-    name: z.ZodNullable<z.ZodString>;
-}, z.core.$strict>;
-export type PublishPlan = z.infer<typeof PublishPlanSchema>;
-export declare const PublishEntitlementSchema: z.ZodObject<{
-    hasActiveSubscription: z.ZodBoolean;
-}, z.core.$strict>;
-export type PublishEntitlement = z.infer<typeof PublishEntitlementSchema>;
-export declare const GetSitePlanDataSchema: z.ZodObject<{
-    plan: z.ZodNullable<z.ZodObject<{
-        subscriptionId: z.ZodString;
-        planId: z.ZodString;
-        locale: z.ZodUnion<[z.ZodEnum<{
-            en: "en";
-            zh_CN: "zh_CN";
-        }>, z.ZodString]>;
-        currentPeriodEnd: z.ZodNullable<z.ZodString>;
-        servicePeriodEnd: z.ZodNullable<z.ZodString>;
-        featureSnapshot: z.ZodNullable<z.ZodObject<{
-            maxSites: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            maxStorageMb: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            customDomains: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-        }, z.core.$loose>>;
-        code: z.ZodNullable<z.ZodString>;
-        level: z.ZodNullable<z.ZodNumber>;
-        name: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>>;
-    entitlement: z.ZodObject<{
-        hasActiveSubscription: z.ZodBoolean;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-export type GetSitePlanData = z.infer<typeof GetSitePlanDataSchema>;