@vcp-dev/contracts 0.4.8 → 0.4.9

package/dist/input-context-bundle.d.ts

@@ -77,6 +77,7 @@ export declare const InputSourceSchema: z.ZodObject<{
     original_ref: z.ZodString;
     source_metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     error_code: z.ZodOptional<z.ZodString>;
+    submitted: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type InputSource = z.infer<typeof InputSourceSchema>;
 export declare const InputConflictSchema: z.ZodObject<{
@@ -211,6 +212,7 @@ export declare const InputContextBundleSchema: z.ZodObject<{
         original_ref: z.ZodString;
         source_metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         error_code: z.ZodOptional<z.ZodString>;
+        submitted: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     facts: z.ZodArray<z.ZodObject<{
         fact: z.ZodString;

package/dist/page-slug.d.ts

@@ -18,12 +18,21 @@
  * silently skipped. Routing both ends through this one function removes the
  * divergence at the root.
  *
- * Both functions are pure & total: any input (including non-string) yields a
- * canonical result and never throws. Path traversal is neutralized (the `..`
- * segment collapses to empty and is dropped) rather than rejected, so a
- * misbehaving slug degrades to a safe route instead of failing finalization
- * and blocking the user journey.
+ * Model-output repair is intentionally kept out of this module. These helpers
+ * define the fail-closed route identity consumed after Sitemap hydration: an
+ * unsafe/non-ASCII value has no canonical route and must be rejected instead
+ * of silently materializing a second public path.
  */
+export declare const PAGE_SLUG_SEGMENT_PATTERN_SOURCE = "[a-z0-9]+(?:-[a-z0-9]+)*";
+export declare const PAGE_SLUG_PATTERN: RegExp;
+export declare function isCanonicalPageSlug(value: unknown): value is string;
+/**
+ * Best-effort canonicalization for ASCII-only semantic input. Returns `null`
+ * when accepting the value would require transliteration, traversal cleanup,
+ * or non-string coercion. Page-index/id fallbacks belong to Sitemap hydration,
+ * where uniqueness and home-page position are available.
+ */
+export declare function tryCanonicalizeAsciiPageSlug(value: unknown): string | null;
 /**
  * Canonicalize a sitemap page slug into the form
  * `deriveSitemapRouteIdentity` emits in its `slug` field once the route file
@@ -31,13 +40,13 @@
  * stay consistent.
  *
  * Examples:
- * - `/` / `""` / non-string → `/`
+ * - `/` / `""` → `/`
  * - `Products` → `/products`
  * - `index` / `home` → `/` (top-level only; `blog/index` → `/blog/index`)
  * - `about_us` → `/about-us`
  * - `Our Services` → `/our-services`
- * - `产品` → `/产品`
- * - `/../admin` → `/admin`
+ * Unsafe, non-ASCII, traversal, and runtime non-string inputs throw. Model-facing
+ * repair must run before this authority is called.
  */
 export declare function canonicalizePageSlug(slug: string): string;
 /**
@@ -49,6 +58,6 @@ export declare function canonicalizePageSlug(slug: string): string;
  * - `/` / `index` / `home` → `app/page.tsx`
  * - `Products` → `app/products/page.tsx`
  * - `services/Repair` → `app/services/repair/page.tsx`
- * - `产品` → `app/产品/page.tsx`
+ * Unsafe/non-ASCII input throws before a snapshot path is constructed.
  */
 export declare function pageSlugToRouteFilePath(slug: string): string;

package/dist/publish-plan.d.ts

@@ -0,0 +1,54 @@
+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>;

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

@@ -130,8 +130,8 @@ export declare const SiteEditStylePropertySchema: z.ZodEnum<{
 }>;
 export type SiteEditStyleProperty = z.infer<typeof SiteEditStylePropertySchema>;
 export declare const SiteEditStyleStateModeSchema: z.ZodEnum<{
-    hover: "hover";
     active: "active";
+    hover: "hover";
     focus: "focus";
     disabled: "disabled";
 }>;

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

@@ -363,8 +363,8 @@ export declare const SiteEditStyleModelSchema: z.ZodUnion<readonly [z.ZodRecord<
             "2xl": "2xl";
         }>>;
         state: z.ZodOptional<z.ZodEnum<{
-            hover: "hover";
             active: "active";
+            hover: "hover";
             focus: "focus";
             disabled: "disabled";
         }>>;

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.4.8";
+export declare const CURRENT_EDIT_ENGINE_VERSION = "0.4.9";
 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/site-locale.d.ts

@@ -1,14 +1,84 @@
 import { z } from "zod";
-export { DEFAULT_SITE_LOCALE, ISO_639_3_TO_SITE_LOCALE, SITE_LOCALE_CODES, SUPPORTED_SITE_LOCALES, resolveSiteLocaleFromIso6393, type SiteLocale, type SiteLocaleOption, } from "@vcp-dev/i18n/site-locale";
+/**
+ * Site output locale constants. These describe generated-site visitor language,
+ * not the platform console UI language.
+ */
+export declare const SELECTABLE_SITE_LOCALE_CODES: readonly ["zh-CN", "zh-HK", "zh-TW", "en-US", "en-GB", "ja-JP", "ko-KR", "es-ES", "fr-FR", "de-DE", "pt-PT", "ru-RU", "ar-SA", "id-ID", "vi-VN", "th-TH", "it-IT", "nl-NL", "tr-TR", "pl-PL", "uk-UA", "cs-CZ", "sk-SK", "hu-HU", "ro-RO", "el-GR", "sv-SE", "da-DK", "fi-FI", "hr-HR", "lt-LT", "lv-LV", "et-EE", "ga-IE", "mt-MT", "ka-GE", "fa-IR", "bn-BD", "ta-IN", "si-LK", "ms-MY", "fil-PH", "my-MM", "km-KH", "lo-LA", "mn-MN", "kk-KZ"];
+export type SelectableSiteLocale = (typeof SELECTABLE_SITE_LOCALE_CODES)[number];
+/**
+ * 已持久化站点仍可能携带这些旧短码。它们继续通过运行时合同，但不会出现在
+ * 澄清页的新建/切换目录中；本次 UI 调整不做数据迁移。
+ */
+export declare const LEGACY_SITE_LOCALE_CODES: readonly ["en", "ja", "es", "fr", "de", "ko", "pt", "pt-BR", "it", "ru", "ar", "hi", "id", "vi", "th", "tr", "nl", "pl", "uk", "sv", "da", "fi", "no", "cs", "el", "hu", "ro", "he", "ms", "fil", "bn", "ta", "ca", "sk", "hr", "bg", "lt", "lv", "et", "fa", "sw", "sr", "is"];
+export declare const SITE_LOCALE_CODES: readonly ["zh-CN", "zh-HK", "zh-TW", "en-US", "en-GB", "ja-JP", "ko-KR", "es-ES", "fr-FR", "de-DE", "pt-PT", "ru-RU", "ar-SA", "id-ID", "vi-VN", "th-TH", "it-IT", "nl-NL", "tr-TR", "pl-PL", "uk-UA", "cs-CZ", "sk-SK", "hu-HU", "ro-RO", "el-GR", "sv-SE", "da-DK", "fi-FI", "hr-HR", "lt-LT", "lv-LV", "et-EE", "ga-IE", "mt-MT", "ka-GE", "fa-IR", "bn-BD", "ta-IN", "si-LK", "ms-MY", "fil-PH", "my-MM", "km-KH", "lo-LA", "mn-MN", "kk-KZ", "en", "ja", "es", "fr", "de", "ko", "pt", "pt-BR", "it", "ru", "ar", "hi", "id", "vi", "th", "tr", "nl", "pl", "uk", "sv", "da", "fi", "no", "cs", "el", "hu", "ro", "he", "ms", "fil", "bn", "ta", "ca", "sk", "hr", "bg", "lt", "lv", "et", "fa", "sw", "sr", "is"];
+export type SiteLocale = (typeof SITE_LOCALE_CODES)[number];
+export type SiteTextDirection = "ltr" | "rtl";
+export interface SiteLocaleOption {
+    code: SelectableSiteLocale;
+    label: string;
+    englishName: string;
+    common?: boolean;
+}
+export declare const SUPPORTED_SITE_LOCALES: readonly SiteLocaleOption[];
+export declare function resolveSelectableSiteLocale(locale: SiteLocale): SelectableSiteLocale | undefined;
+export declare const DEFAULT_SITE_LOCALE: SiteLocale;
+export declare function resolveSiteTextDirection(locale: SiteLocale): SiteTextDirection;
+export declare const ISO_639_3_TO_SITE_LOCALE: Readonly<Record<string, SiteLocale>>;
+export declare function resolveSiteLocaleFromIso6393(iso6393: string): SiteLocale;
 export declare const SiteLocaleSchema: z.ZodEnum<{
     id: "id";
     "zh-CN": "zh-CN";
+    "zh-HK": "zh-HK";
+    "zh-TW": "zh-TW";
+    "en-US": "en-US";
+    "en-GB": "en-GB";
+    "ja-JP": "ja-JP";
+    "ko-KR": "ko-KR";
+    "es-ES": "es-ES";
+    "fr-FR": "fr-FR";
+    "de-DE": "de-DE";
+    "pt-PT": "pt-PT";
+    "ru-RU": "ru-RU";
+    "ar-SA": "ar-SA";
+    "id-ID": "id-ID";
+    "vi-VN": "vi-VN";
+    "th-TH": "th-TH";
+    "it-IT": "it-IT";
+    "nl-NL": "nl-NL";
+    "tr-TR": "tr-TR";
+    "pl-PL": "pl-PL";
+    "uk-UA": "uk-UA";
+    "cs-CZ": "cs-CZ";
+    "sk-SK": "sk-SK";
+    "hu-HU": "hu-HU";
+    "ro-RO": "ro-RO";
+    "el-GR": "el-GR";
+    "sv-SE": "sv-SE";
+    "da-DK": "da-DK";
+    "fi-FI": "fi-FI";
+    "hr-HR": "hr-HR";
+    "lt-LT": "lt-LT";
+    "lv-LV": "lv-LV";
+    "et-EE": "et-EE";
+    "ga-IE": "ga-IE";
+    "mt-MT": "mt-MT";
+    "ka-GE": "ka-GE";
+    "fa-IR": "fa-IR";
+    "bn-BD": "bn-BD";
+    "ta-IN": "ta-IN";
+    "si-LK": "si-LK";
+    "ms-MY": "ms-MY";
+    "fil-PH": "fil-PH";
+    "my-MM": "my-MM";
+    "km-KH": "km-KH";
+    "lo-LA": "lo-LA";
+    "mn-MN": "mn-MN";
+    "kk-KZ": "kk-KZ";
     en: "en";
     ja: "ja";
     es: "es";
     fr: "fr";
     de: "de";
-    "zh-TW": "zh-TW";
     ko: "ko";
     pt: "pt";
     "pt-BR": "pt-BR";

package/package.json

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