@vcp-dev/contracts 0.10.14 → 0.10.16

package/dist/launcher-prompt-templates.d.ts

@@ -248,6 +248,11 @@ export declare const LauncherPromptTemplateApplyRequestSchema: z.ZodObject<{
                 themeId: z.ZodOptional<z.ZodString>;
                 themeDescription: z.ZodOptional<z.ZodString>;
                 aestheticNote: z.ZodOptional<z.ZodString>;
+                weightStyle: z.ZodOptional<z.ZodEnum<{
+                    bold: "bold";
+                    light: "light";
+                    standard: "standard";
+                }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         userChoices: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -435,6 +440,11 @@ export declare const LauncherPromptTemplateApplyResponseSchema: z.ZodObject<{
                 themeId: z.ZodOptional<z.ZodString>;
                 themeDescription: z.ZodOptional<z.ZodString>;
                 aestheticNote: z.ZodOptional<z.ZodString>;
+                weightStyle: z.ZodOptional<z.ZodEnum<{
+                    bold: "bold";
+                    light: "light";
+                    standard: "standard";
+                }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         userChoices: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/site-design-notes.d.ts

@@ -23,9 +23,23 @@ export declare const PaletteInputsSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PaletteInputs = z.infer<typeof PaletteInputsSchema>;
+/**
+ * `type-inputs` 行的结构化载荷：Step 6 字重档位选择的记录。独立于
+ * `palette-inputs`，坏了只丢这一行（方案「对齐决定」#2）。
+ */
+export declare const TypeInputsSchema: z.ZodObject<{
+    weightStyle: z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>;
+}, z.core.$strip>;
+export type TypeInputs = z.infer<typeof TypeInputsSchema>;
 export type SiteDesignNotes = {
     lines: string[];
     paletteInputs: PaletteInputs | null;
+    /** Optional: `undefined` for callers building notes without a weight style choice. */
+    typeInputs?: TypeInputs;
 };
 export declare function formatSiteDesignNotes(notes: SiteDesignNotes): string;
 /**

package/dist/site-edit-operation.d.ts

@@ -71,13 +71,13 @@ export type SiteEditOperationResultTarget = z.infer<typeof SiteEditOperationResu
 export declare const SiteEditStylePropertySchema: z.ZodEnum<{
     color: "color";
     transform: "transform";
+    display: "display";
     cursor: "cursor";
     position: "position";
     columns: "columns";
     width: "width";
     height: "height";
     order: "order";
-    display: "display";
     top: "top";
     right: "right";
     bottom: "bottom";
@@ -188,6 +188,7 @@ export declare const SiteEditMoveTargetSchema: z.ZodUnion<readonly [z.ZodObject<
         after: "after";
     }>;
     anchorKey: z.ZodString;
+    parentKey: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     relation: z.ZodEnum<{
         prepend: "prepend";
@@ -325,6 +326,7 @@ export declare const SiteEditOperationParamsSchema: z.ZodDiscriminatedUnion<[z.Z
             after: "after";
         }>;
         anchorKey: z.ZodString;
+        parentKey: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         relation: z.ZodEnum<{
             prepend: "prepend";
@@ -388,6 +390,7 @@ export declare const SiteEditOperationParamsSchema: z.ZodDiscriminatedUnion<[z.Z
             after: "after";
         }>;
         anchorKey: z.ZodString;
+        parentKey: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         relation: z.ZodEnum<{
             prepend: "prepend";
@@ -768,6 +771,7 @@ export declare const SiteEditOperationRequestSchema: z.ZodObject<{
                 after: "after";
             }>;
             anchorKey: z.ZodString;
+            parentKey: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             relation: z.ZodEnum<{
                 prepend: "prepend";
@@ -831,6 +835,7 @@ export declare const SiteEditOperationRequestSchema: z.ZodObject<{
                 after: "after";
             }>;
             anchorKey: z.ZodString;
+            parentKey: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             relation: z.ZodEnum<{
                 prepend: "prepend";
@@ -1141,6 +1146,7 @@ export declare const SiteEditSignedOperationRequestSchema: z.ZodObject<{
                 after: "after";
             }>;
             anchorKey: z.ZodString;
+            parentKey: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             relation: z.ZodEnum<{
                 prepend: "prepend";
@@ -1204,6 +1210,7 @@ export declare const SiteEditSignedOperationRequestSchema: z.ZodObject<{
                 after: "after";
             }>;
             anchorKey: z.ZodString;
+            parentKey: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             relation: z.ZodEnum<{
                 prepend: "prepend";

package/dist/site-edit-render-document.d.ts

@@ -152,6 +152,7 @@ export declare const SiteEditDynamicDataSummarySchema: z.ZodObject<{
 export type SiteEditDynamicDataSummary = z.infer<typeof SiteEditDynamicDataSummarySchema>;
 export declare const SiteEditRenderEntrySchema: z.ZodObject<{
     key: z.ZodString;
+    parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     pageCompositionUnitKey: z.ZodOptional<z.ZodString>;
     operationSummary: z.ZodObject<{
         canUpdateText: z.ZodBoolean;
@@ -207,6 +208,7 @@ export declare const SiteEditRenderDocumentSchema: z.ZodObject<{
     version: z.ZodNumber;
     entries: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pageCompositionUnitKey: z.ZodOptional<z.ZodString>;
         operationSummary: z.ZodObject<{
             canUpdateText: z.ZodBoolean;
@@ -462,13 +464,13 @@ export declare const SiteEditStyleModelSchema: z.ZodUnion<readonly [z.ZodRecord<
         property: z.ZodEnum<{
             color: "color";
             transform: "transform";
+            display: "display";
             cursor: "cursor";
             position: "position";
             columns: "columns";
             width: "width";
             height: "height";
             order: "order";
-            display: "display";
             top: "top";
             right: "right";
             bottom: "bottom";

package/dist/site-edit-source.d.ts

@@ -216,9 +216,9 @@ export declare function isSiteEditSourcePath(path: string): boolean;
 export declare function isSiteEditTextSourcePath(path: string): boolean;
 export declare function isSiteEditSourceDirectoryPath(path: string): boolean;
 /**
- * 站点设计说明文档（根级 `design.md` / `DESIGN.md`）。它由后端从 DesignPlan
- * 确定性物化，不是用户手写的源码：既受删除保护，也不在工作台代码 tab 的
- * 源码树里暴露。
+ * 站点设计说明文档（根级 `design.md` / `DESIGN.md`）。这是旧快照里的遗留文件：
+ * 全站设计改为以 `app/globals.css` 为单一来源后，新站不再生成或维护它；仍需要
+ * 在存量快照里保护它不被删、也不在工作台代码 tab 的源码树里暴露。
  */
 export declare function isSiteEditDesignDocumentPath(path: string): boolean;
 export declare function getSiteEditSourceDeleteProtectionReason(path: string): SiteEditSourceDeleteProtectionReason | null;

package/dist/site-edit-version.d.ts

@@ -5,7 +5,7 @@
  *
  * 由 release-edit-engine-packages.ts 在 bump 版本时自动更新。
  */
-export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.14";
+export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.16";
 export declare const EDIT_ENGINE_VERSION_HEADER = "x-vcp-edit-engine-version";
 export declare const EDIT_ENGINE_VERSION_SOURCE_HEADER = "x-vcp-edit-engine-version-source";
 export type EditEngineVersionSource = "explicit" | "fallback_current" | "system_current";

package/dist/step6-design.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { type SiteDesignRadiusId } from "./site-design-presets.js";
+import { type WeightStyleId } from "./type-weight.js";
 /**
  * 审美说明上限 300 字。用户自由文本，服务端一律原样透传：不做替换、不截断
  * 关键词、不做正则规整 —— 这类处理在本仓有过把正文改坏的实际教训。
@@ -65,6 +66,11 @@ export declare const Step6AiThemeCandidateSchema: z.ZodObject<{
         comfortable: "comfortable";
         airy: "airy";
     }>;
+    weight_style: z.ZodOptional<z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>>;
     reason: z.ZodString;
 }, z.core.$strict>;
 export type Step6AiThemeCandidate = z.infer<typeof Step6AiThemeCandidateSchema>;
@@ -111,6 +117,11 @@ export declare const Step6GeneratedThemeCardSchema: z.ZodObject<{
         comfortable: "comfortable";
         airy: "airy";
     }>;
+    weight_style: z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>;
 }, z.core.$strict>;
 export type Step6GeneratedThemeCard = z.infer<typeof Step6GeneratedThemeCardSchema>;
 export declare const Step6DesignSelectionSchema: z.ZodObject<{
@@ -162,6 +173,11 @@ export declare const Step6DesignSelectionSchema: z.ZodObject<{
         lg: "lg";
         xl: "xl";
     }>>;
+    weight_style: z.ZodOptional<z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>>;
     aesthetic_note: z.ZodOptional<z.ZodString>;
     updated_at: z.ZodString;
 }, z.core.$strict>;
@@ -350,6 +366,11 @@ export declare const Step6DesignRecommendationSchema: z.ZodObject<{
                 comfortable: "comfortable";
                 airy: "airy";
             }>;
+            weight_style: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
+                light: "light";
+                standard: "standard";
+            }>>;
             reason: z.ZodString;
         }, z.core.$strict>>;
     }, z.core.$strict>;
@@ -587,6 +608,11 @@ export declare const Step6DesignRecommendationsResponseSchema: z.ZodObject<{
                     comfortable: "comfortable";
                     airy: "airy";
                 }>;
+                weight_style: z.ZodOptional<z.ZodEnum<{
+                    bold: "bold";
+                    light: "light";
+                    standard: "standard";
+                }>>;
                 reason: z.ZodString;
             }, z.core.$strict>>;
         }, z.core.$strict>;
@@ -680,6 +706,11 @@ export declare const Step6DesignRecommendationsResponseSchema: z.ZodObject<{
             lg: "lg";
             xl: "xl";
         }>>;
+        weight_style: z.ZodOptional<z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>>;
         aesthetic_note: z.ZodOptional<z.ZodString>;
         updated_at: z.ZodString;
     }, z.core.$strict>;
@@ -734,6 +765,11 @@ export declare const UpdateStep6DesignSelectionRequestSchema: z.ZodObject<{
         lg: "lg";
         xl: "xl";
     }>>;
+    weight_style: z.ZodOptional<z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>>;
     aesthetic_note: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type UpdateStep6DesignSelectionRequest = z.infer<typeof UpdateStep6DesignSelectionRequestSchema>;
@@ -787,6 +823,11 @@ export declare const UpdateStep6DesignSelectionResponseSchema: z.ZodObject<{
             lg: "lg";
             xl: "xl";
         }>>;
+        weight_style: z.ZodOptional<z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>>;
         aesthetic_note: z.ZodOptional<z.ZodString>;
         updated_at: z.ZodString;
     }, z.core.$strict>;
@@ -944,6 +985,11 @@ export declare const Step6DesignRecommendationModelOutputSchema: z.ZodObject<{
             comfortable: "comfortable";
             airy: "airy";
         }>;
+        weight_style: z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>;
     }, z.core.$strict>>;
     conversion: z.ZodOptional<z.ZodObject<{
         protocol: z.ZodEnum<{
@@ -970,8 +1016,20 @@ export declare function buildStep6FallbackThemeCards(): Step6GeneratedThemeCard[
  * 主题也认不出时才落到物化端同款默认，保证老站行为不变。
  */
 export declare function resolveStep6RadiusId(selection: Step6DesignSelection): SiteDesignRadiusId;
-/** Deterministic handoff from persisted selection to Sitemap/DesignPlan. */
-export declare function toStep6GenerationVisualHints(selection: Step6DesignSelection): {
+/**
+ * 用户选择的字重档位。存量选择没有该字段时，先按本轮推荐里与已选主题同 id
+ * 的卡回退，那张卡也找不到（如存量 `ai-*` 选择对不上本轮 `gen-*` 推荐）就
+ * 退到卡 #1，推荐本身读不到时才落到平台默认档 `"standard"`。
+ */
+export declare function resolveStep6WeightStyle(selection: Step6DesignSelection, recommendation?: Step6DesignRecommendation): WeightStyleId;
+/**
+ * Deterministic handoff from persisted selection to Sitemap/DesignPlan.
+ *
+ * `recommendation` is optional and only used to resolve `weightStyle` when
+ * the selection itself doesn't carry one (see `resolveStep6WeightStyle`);
+ * omitting it just falls straight through to the platform default `"standard"`.
+ */
+export declare function toStep6GenerationVisualHints(selection: Step6DesignSelection, recommendation?: Step6DesignRecommendation): {
     readonly colorSeeds: {
         primary: string;
         accent: string;
@@ -986,5 +1044,6 @@ export declare function toStep6GenerationVisualHints(selection: Step6DesignSelec
     readonly motionLevel: "subtle" | "moderate" | "expressive";
     readonly motionPreset: "subtle" | "moderate" | "expressive";
     readonly radius: "none" | "sm" | "md" | "lg" | "xl";
+    readonly weightStyle: "bold" | "light" | "standard";
 };
 export declare function defaultStep6Selection(recommendation: Step6DesignRecommendation, now: Date): Step6DesignSelection;

package/dist/step6-gpt-design.d.ts

@@ -42,6 +42,11 @@ export declare const Step6GptDesignRecommendationModelOutputSchema: z.ZodObject<
             comfortable: "comfortable";
             airy: "airy";
         }>;
+        weight_style: z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>;
     }, z.core.$strict>>;
     conversion: z.ZodOptional<z.ZodObject<{
         protocol: z.ZodEnum<{
@@ -100,6 +105,11 @@ export declare const Step6DesignAgentRecommendationsResponseSchema: z.ZodUnion<r
             comfortable: "comfortable";
             airy: "airy";
         }>;
+        weight_style: z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>;
     }, z.core.$strict>>;
     conversion: z.ZodOptional<z.ZodObject<{
         protocol: z.ZodEnum<{
@@ -152,6 +162,11 @@ export declare const Step6DesignAgentRecommendationsResponseSchema: z.ZodUnion<r
             comfortable: "comfortable";
             airy: "airy";
         }>;
+        weight_style: z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>;
     }, z.core.$strict>>;
     conversion: z.ZodOptional<z.ZodObject<{
         protocol: z.ZodEnum<{

package/dist/type-weight.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export declare const WEIGHT_STYLE_IDS: readonly ["light", "standard", "bold"];
+export type WeightStyleId = (typeof WEIGHT_STYLE_IDS)[number];
+export declare const WeightStyleIdSchema: z.ZodEnum<{
+    bold: "bold";
+    light: "light";
+    standard: "standard";
+}>;
+export declare const DEFAULT_WEIGHT_STYLE_ID: WeightStyleId;
+export type WeightRole = "display" | "heading" | "title" | "ui" | "button" | "body" | "strong";
+/** 三档预设表：以后加档只改这张表（方案「已确认的决定」）。 */
+export declare const WEIGHT_STYLE_PRESETS: Readonly<Record<WeightStyleId, Readonly<Record<WeightRole, number>>>>;
+export declare const SITE_WEIGHT_TOKEN_NAMES: string[];
+export declare const SITE_LEADING_BODY_TOKEN = "--site-leading-body";
+/**
+ * `resolveFontDisplayName` silently falls back to `"Inter"` for a name it
+ * doesn't recognize, so calling it first would make an unknown font
+ * indistinguishable from a real "Inter" request. Check the original name
+ * first, then its normalized form (trimmed, underscore-joined,
+ * lower-cased — matching either a display name or an `import` name); only
+ * once one of those two matches do we resolve and look up the range.
+ */
+export declare function availableFontWeights(family: string): readonly number[] | null;
+export declare function siteWeightVariables(style: WeightStyleId | undefined, fonts?: {
+    heading?: string;
+    body?: string;
+}): Record<`--site-weight-${WeightRole}`, string>;
+export declare function siteLeadingBody(locale: string | undefined): string;
+export declare function resolveTryOnFontWeights(family: string, wanted: readonly number[]): string[];

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

@@ -14,6 +14,11 @@ export declare const WorkspaceDesignApplyRequestSchema: z.ZodObject<{
         heading: z.ZodString;
         body: z.ZodString;
     }, z.core.$strict>>;
+    weightStyle: z.ZodOptional<z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>>;
 }, z.core.$strict>;
 export type WorkspaceDesignApplyRequest = z.infer<typeof WorkspaceDesignApplyRequestSchema>;
 export declare const WorkspaceDesignApplyResponseSchema: z.ZodObject<{
@@ -74,6 +79,11 @@ export declare const WorkspaceDesignApplyResponseSchema: z.ZodObject<{
             muted: z.ZodOptional<z.ZodString>;
             border: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        weightStyle: z.ZodOptional<z.ZodEnum<{
+            bold: "bold";
+            light: "light";
+            standard: "standard";
+        }>>;
     }, z.core.$strip>>>;
     changed_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
@@ -118,6 +128,11 @@ export declare const WorkspaceDesignCurrentResponseSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    weight_style: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        bold: "bold";
+        light: "light";
+        standard: "standard";
+    }>>>;
     source: z.ZodEnum<{
         globals_css: "globals_css";
         design_plan_archive: "design_plan_archive";

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

@@ -144,6 +144,7 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                     after: "after";
                 }>;
                 anchorKey: z.ZodString;
+                parentKey: z.ZodString;
             }, z.core.$strip>, z.ZodObject<{
                 relation: z.ZodEnum<{
                     prepend: "prepend";
@@ -207,6 +208,7 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                     after: "after";
                 }>;
                 anchorKey: z.ZodString;
+                parentKey: z.ZodString;
             }, z.core.$strip>, z.ZodObject<{
                 relation: z.ZodEnum<{
                     prepend: "prepend";
@@ -547,6 +549,7 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                             after: "after";
                         }>;
                         anchorKey: z.ZodString;
+                        parentKey: z.ZodString;
                     }, z.core.$strip>, z.ZodObject<{
                         relation: z.ZodEnum<{
                             prepend: "prepend";
@@ -610,6 +613,7 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                             after: "after";
                         }>;
                         anchorKey: z.ZodString;
+                        parentKey: z.ZodString;
                     }, z.core.$strip>, z.ZodObject<{
                         relation: z.ZodEnum<{
                             prepend: "prepend";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/contracts",
-  "version": "0.10.14",
+  "version": "0.10.16",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {