@riverbankcms/sdk 0.62.2 → 0.62.4

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import z42, { z, ZodError } from 'zod';
+import z44, { z, ZodError } from 'zod';
 import 'react/jsx-runtime';
 import { createJiti } from 'jiti';
 import * as path3 from 'path';
@@ -2126,90 +2126,11 @@ var init_blockAppearancePresets = __esm({
     ];
   }
 });
-
-// ../theme-core/src/site-styles/siteChromeAppearancePresets.ts
-function defineSiteChromeAppearancePreset(preset2) {
-  return preset2;
-}
-var siteChromeAppearancePresets;
-var init_siteChromeAppearancePresets = __esm({
-  "../theme-core/src/site-styles/siteChromeAppearancePresets.ts"() {
-    siteChromeAppearancePresets = [
-      defineSiteChromeAppearancePreset({
-        kind: "site-chrome",
-        id: "header-clean-base",
-        target: "site-header",
-        label: "Clean base header",
-        header: {
-          surface: {
-            kind: "neutral-solid",
-            token: "surface",
-            textColorToken: "text"
-          },
-          navTreatment: "minimal",
-          dropdownTreatment: "surface",
-          ctaTreatment: "default",
-          behavior: "default"
-        }
-      }),
-      defineSiteChromeAppearancePreset({
-        kind: "site-chrome",
-        id: "site-header-brand-solid-inverted-cta",
-        target: "site-header",
-        label: "Brand solid header with inverted CTA",
-        header: {
-          surface: {
-            kind: "brand-solid",
-            token: "primary",
-            textColorToken: "primaryForeground"
-          },
-          navTreatment: "uppercase-underline",
-          dropdownTreatment: "matched-solid",
-          ctaTreatment: "inverted",
-          behavior: "sticky-shrink"
-        }
-      }),
-      defineSiteChromeAppearancePreset({
-        kind: "site-chrome",
-        id: "footer-muted-grounding",
-        target: "site-footer",
-        label: "Muted grounding footer",
-        footer: {
-          kind: "grounding",
-          surface: "muted-band",
-          emphasis: "low"
-        }
-      }),
-      defineSiteChromeAppearancePreset({
-        kind: "site-chrome",
-        id: "site-footer-brand-two-band",
-        target: "site-footer",
-        label: "Two-band brand footer",
-        footer: {
-          kind: "brand-two-band",
-          surface: {
-            token: "primary",
-            shade: "800",
-            textColorToken: "primaryForeground"
-          },
-          bottomBand: {
-            token: "primary",
-            shade: "900",
-            textColorToken: "primaryForeground"
-          },
-          emphasis: "high"
-        }
-      })
-    ];
-  }
-});
 var init_appearancePresetCatalog = __esm({
   "../theme-core/src/site-styles/appearancePresetCatalog.ts"() {
     init_blockAppearancePresets();
-    init_siteChromeAppearancePresets();
     [
-      ...blockAppearancePresets,
-      ...siteChromeAppearancePresets
+      ...blockAppearancePresets
     ];
   }
 });
@@ -2220,6 +2141,34 @@ var init_appearancePresetTypes = __esm({
   }
 });
 
+// ../theme-core/src/site-styles/headerCtaVariants.ts
+function hasButtonVariant(theme, variantId) {
+  return theme.buttons?.variants.some((variant) => variant.enabled && variant.id === variantId) ?? false;
+}
+function resolveHeaderCtaVariant(theme, treatment) {
+  switch (treatment) {
+    case "default":
+      return void 0;
+    case "primary":
+      return "primary";
+    case "secondary":
+      return hasButtonVariant(theme, "secondary") ? "secondary" : "primary";
+    case "inverted":
+      if (hasButtonVariant(theme, "header")) return "header";
+      if (hasButtonVariant(theme, "secondary")) return "secondary";
+      if (hasButtonVariant(theme, "outline")) return "outline";
+      return "primary";
+    case "outline":
+      return hasButtonVariant(theme, "outline") ? "outline" : "secondary";
+    case "ghost":
+      return hasButtonVariant(theme, "ghost") ? "ghost" : "secondary";
+  }
+}
+var init_headerCtaVariants = __esm({
+  "../theme-core/src/site-styles/headerCtaVariants.ts"() {
+  }
+});
+
 // ../theme-core/src/site-styles/appearancePresets.ts
 var init_appearancePresets = __esm({
   "../theme-core/src/site-styles/appearancePresets.ts"() {
@@ -2227,7 +2176,7 @@ var init_appearancePresets = __esm({
     init_appearancePresetResolution();
     init_appearancePresetTypes();
     init_blockAppearancePresets();
-    init_siteChromeAppearancePresets();
+    init_headerCtaVariants();
   }
 });
 
@@ -2363,9 +2312,164 @@ var init_contentTemplateDesignIntent = __esm({
     init_types2();
   }
 });
+
+// ../theme-core/src/tokens/colorTokenParts.ts
+function parseOpacityPercent(source) {
+  const trimmed = source.trim();
+  if (!trimmed) return null;
+  if (!/^\d{1,3}(?:\.\d+)?$/.test(trimmed)) return null;
+  const value = Number(trimmed);
+  if (!Number.isFinite(value)) return null;
+  if (value < 0 || value > 100) return null;
+  return value;
+}
+function parseColorTokenParts(source) {
+  const trimmed = source.trim();
+  if (trimmed.startsWith("raw:")) {
+    return { kind: "raw", value: trimmed.slice(4) };
+  }
+  const [token, opacityRaw, extra] = trimmed.split("/");
+  if (!token || extra !== void 0) {
+    return { kind: "invalid", token: trimmed };
+  }
+  if (opacityRaw === void 0) {
+    return { kind: "token", token, opacityPercent: null };
+  }
+  const opacityPercent = parseOpacityPercent(opacityRaw);
+  if (opacityPercent === null) {
+    return { kind: "invalid", token: trimmed };
+  }
+  return { kind: "token", token, opacityPercent };
+}
+var init_colorTokenParts = __esm({
+  "../theme-core/src/tokens/colorTokenParts.ts"() {
+  }
+});
+
+// ../theme-core/src/tokens/blockColorTokens.ts
+function isBlockColorToken(value) {
+  if (typeof value !== "string") return false;
+  const parts = parseColorTokenParts(value);
+  return parts.kind === "token" && blockColorTokenNameSet.has(parts.token);
+}
+function parseBlockColorToken(value) {
+  if (!isBlockColorToken(value)) return null;
+  return value.trim();
+}
+var blockColorTokenNames, blockColorTokenNameSet;
+var init_blockColorTokens = __esm({
+  "../theme-core/src/tokens/blockColorTokens.ts"() {
+    init_colorTokenParts();
+    blockColorTokenNames = [
+      "text",
+      "heading",
+      "mutedText",
+      "surface",
+      "background",
+      "foreground",
+      "border",
+      "primary",
+      "secondary",
+      "accent",
+      "success",
+      "warning",
+      "info",
+      "error",
+      "destructive",
+      "scrim",
+      "shadow",
+      // Common "on*" tokens used when rendering colored chips/badges.
+      "onPrimary",
+      "onSecondary",
+      "onAccent",
+      "onSuccess",
+      "onWarning",
+      "onInfo",
+      "onError",
+      "onDestructive",
+      "onSurface"
+    ];
+    blockColorTokenNameSet = new Set(
+      blockColorTokenNames
+    );
+  }
+});
+function isKnownBaseToken(value) {
+  return themeColorBaseTokenSet.has(value);
+}
+function isKnownShadeToken(value) {
+  const match = value.match(/^([a-zA-Z][a-zA-Z0-9]*)(?:-([0-9]{2,3}))$/);
+  if (!match) return false;
+  const [, base, shade] = match;
+  return Boolean(base && shade && isKnownBaseToken(base) && shadeStepSet.has(shade));
+}
+function isThemeColorTokenBase(value) {
+  return isKnownBaseToken(value) || isKnownShadeToken(value);
+}
+function isThemeColorToken(value) {
+  if (typeof value !== "string") return false;
+  const parts = parseColorTokenParts(value);
+  return parts.kind === "token" && isThemeColorTokenBase(parts.token);
+}
+function parseThemeColorToken(value) {
+  if (!isThemeColorToken(value)) return null;
+  return value.trim();
+}
+var PALETTE_TOKEN_NAMES, paletteTokenNameSchema, themeColorBaseTokenNames, themeColorBaseTokenSet, SHADE_STEPS, shadeStepSet, themeColorTokenSchema;
+var init_themeColorTokens = __esm({
+  "../theme-core/src/tokens/themeColorTokens.ts"() {
+    init_blockColorTokens();
+    init_colorTokenParts();
+    PALETTE_TOKEN_NAMES = [
+      "primary",
+      "primaryForeground",
+      "secondary",
+      "accent",
+      "success",
+      "warning",
+      "destructive",
+      "background",
+      "surface",
+      "surfaceAlt",
+      "muted",
+      "text",
+      "border"
+    ];
+    paletteTokenNameSchema = z.enum(PALETTE_TOKEN_NAMES);
+    themeColorBaseTokenNames = [
+      ...PALETTE_TOKEN_NAMES,
+      ...blockColorTokenNames,
+      // Existing generated themes can carry palette-local "white" tokens in
+      // token-only component fields. Keep it explicit until those rows are
+      // migrated to canonical foreground/background roles.
+      "white",
+      "neutral",
+      "primaryText",
+      "secondaryForeground",
+      "accentForeground"
+    ];
+    themeColorBaseTokenSet = new Set(themeColorBaseTokenNames);
+    SHADE_STEPS = [
+      "50",
+      "100",
+      "200",
+      "300",
+      "400",
+      "500",
+      "600",
+      "700",
+      "800",
+      "900",
+      "950"
+    ];
+    shadeStepSet = new Set(SHADE_STEPS);
+    themeColorTokenSchema = z.string().min(1).refine((value) => Boolean(isThemeColorToken(value)), "Expected a known Theme V2 color token");
+  }
+});
 var VARIANT_ROLES, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, buttonGlobalSettingsSchema, gradientDirectionSchema, buttonBackgroundSchema, effectApplicationSchema, buttonBorderSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, buttonVariantSchema, buttonSystemSchema;
 var init_types3 = __esm({
   "../theme-core/src/buttons/types.ts"() {
+    init_themeColorTokens();
     VARIANT_ROLES = [
       "primary",
       "secondary",
@@ -2443,7 +2547,7 @@ var init_types3 = __esm({
       hoverTransform: hoverTransformSchema,
       hoverColor: hoverColorSchema,
       // When hoverColor is 'token', this specifies which token to use
-      hoverColorToken: z.string().optional(),
+      hoverColorToken: themeColorTokenSchema.optional(),
       // Gradient settings (if any variant uses gradients)
       gradientStyle: gradientStyleSchema.optional(),
       gradientAngle: z.number().min(0).max(360).optional(),
@@ -2451,10 +2555,10 @@ var init_types3 = __esm({
     });
     gradientDirectionSchema = z.enum(["to-r", "to-l", "to-t", "to-b", "to-tr", "to-tl", "to-br", "to-bl"]);
     buttonBackgroundSchema = z.discriminatedUnion("type", [
-      z.object({ type: z.literal("solid"), colorToken: z.string() }),
+      z.object({ type: z.literal("solid"), colorToken: themeColorTokenSchema }),
       z.object({
         type: z.literal("gradient"),
-        stops: z.array(z.string()).min(2),
+        stops: z.array(themeColorTokenSchema).min(2),
         direction: gradientDirectionSchema
       }),
       z.object({ type: z.literal("transparent") })
@@ -2465,7 +2569,7 @@ var init_types3 = __esm({
     });
     buttonBorderSchema = z.object({
       widthClass: z.string(),
-      colorToken: z.string()
+      colorToken: themeColorTokenSchema
     });
     variantShadowSchema = z.object({
       elevation: z.enum(["none", "low", "medium", "high"]),
@@ -2491,7 +2595,7 @@ var init_types3 = __esm({
       priority: prioritySchema,
       // Base appearance (token-based)
       background: buttonBackgroundSchema,
-      textColorToken: z.string(),
+      textColorToken: themeColorTokenSchema,
       /** Tailwind radius token (e.g. `'rounded-md'`). Omit to inherit from `global.cornerStyle`. */
       borderRadius: z.string().optional(),
       // Optional shadow override (uses theme.shadow if not specified)
@@ -3247,44 +3351,44 @@ var init_personalities = __esm({
 var hotspotSchema, rotationSchema, rectSchema, aspectCropSchema, transformSchema, mediaSchema;
 var init_media = __esm({
   "../theme-core/src/lib/media.ts"() {
-    hotspotSchema = z42.object({
-      x: z42.number().min(0).max(1),
-      y: z42.number().min(0).max(1),
-      radius: z42.number().optional()
-    });
-    rotationSchema = z42.union([z42.literal(0), z42.literal(90), z42.literal(180), z42.literal(270)]);
-    rectSchema = z42.tuple([z42.number(), z42.number(), z42.number(), z42.number()]);
-    aspectCropSchema = z42.object({
-      aspect: z42.preprocess((value) => value == null ? void 0 : value, z42.string().optional()),
-      rect: z42.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
-      hotspot: z42.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
-      rotation: z42.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
-    });
-    transformSchema = z42.object({
-      aspectCrops: z42.preprocess((value) => {
+    hotspotSchema = z44.object({
+      x: z44.number().min(0).max(1),
+      y: z44.number().min(0).max(1),
+      radius: z44.number().optional()
+    });
+    rotationSchema = z44.union([z44.literal(0), z44.literal(90), z44.literal(180), z44.literal(270)]);
+    rectSchema = z44.tuple([z44.number(), z44.number(), z44.number(), z44.number()]);
+    aspectCropSchema = z44.object({
+      aspect: z44.preprocess((value) => value == null ? void 0 : value, z44.string().optional()),
+      rect: z44.preprocess((value) => value == null ? void 0 : value, rectSchema.optional()),
+      hotspot: z44.preprocess((value) => value == null ? void 0 : value, hotspotSchema.optional()),
+      rotation: z44.preprocess((value) => value == null ? void 0 : value, rotationSchema.optional())
+    });
+    transformSchema = z44.object({
+      aspectCrops: z44.preprocess((value) => {
         if (!value || typeof value !== "object" || Array.isArray(value)) {
           return void 0;
         }
         return value;
-      }, z42.record(z42.string(), aspectCropSchema.catch({}))).optional(),
+      }, z44.record(z44.string(), aspectCropSchema.catch({}))).optional(),
       rect: rectSchema.optional(),
       hotspot: hotspotSchema.optional(),
       rotation: rotationSchema.optional()
     });
-    mediaSchema = z42.object({
-      type: z42.enum(["image", "video", "audio", "document", "spreadsheet", "archive"]),
-      purpose: z42.string().optional(),
-      placeholder: z42.boolean().default(true).optional(),
-      assetId: z42.string().optional(),
-      identifier: z42.string().optional(),
-      src: z42.string().optional(),
-      alt: z42.string().optional(),
-      filename: z42.string().optional(),
-      mimeType: z42.string().optional(),
-      width: z42.number().optional(),
-      height: z42.number().optional(),
-      storageBucket: z42.string().optional(),
-      storagePath: z42.string().optional(),
+    mediaSchema = z44.object({
+      type: z44.enum(["image", "video", "audio", "document", "spreadsheet", "archive"]),
+      purpose: z44.string().optional(),
+      placeholder: z44.boolean().default(true).optional(),
+      assetId: z44.string().optional(),
+      identifier: z44.string().optional(),
+      src: z44.string().optional(),
+      alt: z44.string().optional(),
+      filename: z44.string().optional(),
+      mimeType: z44.string().optional(),
+      width: z44.number().optional(),
+      height: z44.number().optional(),
+      storageBucket: z44.string().optional(),
+      storagePath: z44.string().optional(),
       transform: transformSchema.optional()
     });
   }
@@ -3461,21 +3565,22 @@ var init_buttons = __esm({
 var cardSpacingSchema, gradientDirectionSchema2, cardBackgroundSchema, cardBorderSchema, cardVariantSchema, cardSystemSchema;
 var init_types6 = __esm({
   "../theme-core/src/cards/types.ts"() {
+    init_themeColorTokens();
     cardSpacingSchema = z.enum(["none", "compact", "cozy", "medium", "comfortable", "spacious"]);
     gradientDirectionSchema2 = z.enum(["to-r", "to-l", "to-t", "to-b", "to-tr", "to-tl", "to-br", "to-bl"]);
     cardBackgroundSchema = z.discriminatedUnion("type", [
-      z.object({ type: z.literal("solid"), colorToken: z.string() }),
+      z.object({ type: z.literal("solid"), colorToken: themeColorTokenSchema }),
       z.object({
         type: z.literal("gradient"),
-        fromToken: z.string(),
-        toToken: z.string(),
+        fromToken: themeColorTokenSchema,
+        toToken: themeColorTokenSchema,
         direction: gradientDirectionSchema2
       }),
       z.object({ type: z.literal("transparent") })
     ]);
     cardBorderSchema = z.object({
       widthClass: z.string(),
-      colorToken: z.string()
+      colorToken: themeColorTokenSchema
     });
     cardVariantSchema = z.object({
       id: z.string(),
@@ -3541,6 +3646,7 @@ var init_cards = __esm({
 var accordionIconSchema, accordionSystemSchema;
 var init_types7 = __esm({
   "../theme-core/src/accordions/types.ts"() {
+    init_themeColorTokens();
     accordionIconSchema = z.enum([
       "plus-minus",
       // + becomes - (swap or rotate 90°)
@@ -3557,7 +3663,7 @@ var init_types7 = __esm({
       // Visual styling (solid color only - gradients can be added later if needed)
       background: z.object({
         type: z.literal("solid"),
-        colorToken: z.string()
+        colorToken: themeColorTokenSchema
       }),
       // Spacing (padding inside items)
       spacing: z.enum(["none", "compact", "cozy", "medium", "comfortable", "spacious"]),
@@ -3567,7 +3673,7 @@ var init_types7 = __esm({
       border: z.object({
         widthClass: z.string(),
         // e.g., 'border', 'border-2', 'border-0'
-        colorToken: z.string()
+        colorToken: themeColorTokenSchema
       }).nullable(),
       // Shadow (null = inherit from theme.shadow)
       shadow: z.object({
@@ -3583,19 +3689,19 @@ var init_types7 = __esm({
       }),
       // Trigger (question) styling
       trigger: z.object({
-        textColorToken: z.string(),
+        textColorToken: themeColorTokenSchema,
         fontWeight: z.enum(["regular", "medium", "semibold", "bold"]).nullable()
         // null = inherit from theme
       }),
       // Hover state styling
       hover: z.object({
-        backgroundColorToken: z.string().optional(),
-        textColorToken: z.string().optional(),
-        borderColorToken: z.string().optional()
+        backgroundColorToken: themeColorTokenSchema.optional(),
+        textColorToken: themeColorTokenSchema.optional(),
+        borderColorToken: themeColorTokenSchema.optional()
       }),
       // Content (answer) styling
       content: z.object({
-        textColorToken: z.string()
+        textColorToken: themeColorTokenSchema
       })
     });
   }
@@ -3603,23 +3709,24 @@ var init_types7 = __esm({
 var inputSystemSchema;
 var init_types8 = __esm({
   "../theme-core/src/inputs/types.ts"() {
+    init_themeColorTokens();
     inputSystemSchema = z.object({
       // Base styling (applied to all inputs)
       base: z.object({
         background: z.union([
           z.object({
             type: z.literal("solid"),
-            colorToken: z.string()
+            colorToken: themeColorTokenSchema
           }),
           z.object({
             type: z.literal("transparent")
           })
         ]),
-        textColorToken: z.string(),
+        textColorToken: themeColorTokenSchema,
         border: z.object({
           widthClass: z.string(),
           // e.g., 'border', 'border-2'
-          colorToken: z.string(),
+          colorToken: themeColorTokenSchema,
           style: z.enum(["all", "underline"]).optional()
         }),
         corners: z.enum(["square", "soft", "rounded", "pill"]).nullable(),
@@ -3634,7 +3741,7 @@ var init_types8 = __esm({
       }),
       // Label styling
       label: z.object({
-        textColorToken: z.string(),
+        textColorToken: themeColorTokenSchema,
         fontWeight: z.enum(["regular", "medium", "semibold", "bold", "black"]),
         fontSize: z.enum(["2xs", "xs", "sm", "base"]),
         textTransform: z.enum(["none", "uppercase", "lowercase", "capitalize"]).optional(),
@@ -3643,20 +3750,20 @@ var init_types8 = __esm({
       }),
       // Focus state
       focus: z.object({
-        ringColorToken: z.string(),
+        ringColorToken: themeColorTokenSchema,
         ringWidth: z.enum(["0", "1", "2", "3"]),
-        borderColorToken: z.string().optional()
+        borderColorToken: themeColorTokenSchema.optional()
         // Change border color on focus
       }),
       // Error state (for validation feedback)
       error: z.object({
-        borderColorToken: z.string(),
-        textColorToken: z.string()
+        borderColorToken: themeColorTokenSchema,
+        textColorToken: themeColorTokenSchema
       }),
       // Disabled state
       disabled: z.object({
-        backgroundColorToken: z.string(),
-        textColorToken: z.string(),
+        backgroundColorToken: themeColorTokenSchema,
+        textColorToken: themeColorTokenSchema,
         opacity: z.number().min(0.3).max(0.7)
       })
     });
@@ -3665,9 +3772,9 @@ var init_types8 = __esm({
 var gradientStopSchema, gradientConfigSchema;
 var init_types9 = __esm({
   "../theme-core/src/gradients/types.ts"() {
+    init_themeColorTokens();
     gradientStopSchema = z.object({
-      color: z.string(),
-      // Theme color token name (e.g., 'primary-500')
+      color: themeColorTokenSchema,
       position: z.number().min(0).max(100)
       // Percentage 0-100
     });
@@ -3716,6 +3823,7 @@ var navLinkPaddingSchema, navLinkPaddingXSchema, navLinkBorderRadiusSchema, navL
 var init_types10 = __esm({
   "../theme-core/src/navigation/types.ts"() {
     init_baseSchema();
+    init_themeColorTokens();
     navLinkPaddingSchema = z.enum(["none", "compact", "default"]);
     navLinkPaddingXSchema = z.enum(["none", "tight", "compact", "default", "relaxed", "spacious"]);
     navLinkBorderRadiusSchema = z.enum(["none", "sm", "md", "full"]);
@@ -3727,13 +3835,13 @@ var init_types10 = __esm({
       /** Typography settings (inherited from interactive base) */
       ...interactiveTypographySchema.shape,
       /** Text color token */
-      colorToken: z.string().default("text"),
+      colorToken: themeColorTokenSchema.default("text"),
       /** Optional text size override */
       textSize: navLinkTextSizeSchema.optional(),
       /** Optional letter spacing override */
       letterSpacing: navLinkLetterSpacingSchema.optional(),
       /** Hover/active color token (for color-change effects) */
-      hoverColorToken: z.string().nullable().optional(),
+      hoverColorToken: themeColorTokenSchema.nullable().optional(),
       /** Padding preset */
       padding: navLinkPaddingSchema.default("compact"),
       /** Horizontal padding override (overrides horizontal component of padding preset) */
@@ -3917,10 +4025,11 @@ var init_atRuleValidation = __esm({
 var componentBorderSchema, componentShadowSchema;
 var init_componentStyles = __esm({
   "../theme-core/src/shared/componentStyles.ts"() {
+    init_themeColorTokens();
     componentBorderSchema = z.object({
       width: z.enum(["none", "hairline", "thin", "medium", "thick"]).default("none"),
       style: z.enum(["solid", "dashed"]).default("solid"),
-      colorToken: z.string().optional()
+      colorToken: themeColorTokenSchema.optional()
       // defaults to "border" if not set
     });
     componentShadowSchema = z.object({
@@ -3935,6 +4044,135 @@ var init_shared = __esm({
     init_componentStyles();
   }
 });
+
+// ../theme-core/src/utils/colorStyles.ts
+function parseToken(source) {
+  const parts = parseColorTokenParts(source);
+  if (parts.kind === "raw") {
+    return { token: source, raw: parts.value };
+  }
+  if (parts.kind === "invalid") {
+    return { token: source };
+  }
+  return {
+    token: parts.token,
+    alpha: parts.opacityPercent === null ? void 0 : parts.opacityPercent / 100
+  };
+}
+function rgbColorValue(token) {
+  const { token: baseToken, alpha, raw } = parseToken(token);
+  if (raw) {
+    return raw;
+  }
+  const cssVar = `${COLOR_VAR_PREFIX}${baseToken}`;
+  if (alpha === void 0) {
+    return `rgb(var(${cssVar}))`;
+  }
+  return `rgba(var(${cssVar}), ${alpha})`;
+}
+function backgroundColorStyle(token) {
+  return { backgroundColor: rgbColorValue(token) };
+}
+function textColorStyle(token) {
+  return { color: rgbColorValue(token) };
+}
+function borderColorStyle(token) {
+  return { borderColor: rgbColorValue(token) };
+}
+function mergeStyles(...styles) {
+  const merged = {};
+  for (const style of styles) {
+    if (!style) continue;
+    Object.assign(merged, style);
+  }
+  return Object.keys(merged).length ? merged : void 0;
+}
+var COLOR_VAR_PREFIX;
+var init_colorStyles = __esm({
+  "../theme-core/src/utils/colorStyles.ts"() {
+    init_colorTokenParts();
+    COLOR_VAR_PREFIX = "--tb-";
+  }
+});
+function isCssColorLiteral(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return false;
+  return CSS_HEX_COLOR_PATTERN.test(trimmed) || CSS_COLOR_FUNCTION_PATTERN.test(trimmed) || /^var\(/i.test(trimmed) || CSS_COLOR_KEYWORDS.has(trimmed.toLowerCase());
+}
+function parseContextThemeColorToken(value, context) {
+  const parts = parseColorTokenParts(value);
+  if (parts.kind !== "token") return null;
+  const hasPaletteToken = Boolean(context?.palette?.[value.trim()]) || parts.opacityPercent !== null && Boolean(context?.palette?.[parts.token]);
+  if (!hasPaletteToken) return null;
+  return value.trim();
+}
+function isTokenShapedTypo(value) {
+  if (COMMON_CSS_NAMED_COLORS.has(value.toLowerCase())) return false;
+  if (!/^[a-zA-Z][a-zA-Z0-9]*(?:-[a-zA-Z0-9]+)*(?:\/[^/]+)?$/.test(value)) {
+    return false;
+  }
+  return !isCssColorLiteral(value);
+}
+function warnUnknownThemeColorReference(value) {
+  if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
+  if (!isTokenShapedTypo(value)) return;
+  console.warn(
+    `[theme-core] Unknown Theme V2 color token "${value}" treated as literal CSS. Use raw:* for deliberate custom CSS values.`
+  );
+}
+function parseThemeColorReference(input, context) {
+  const trimmed = input.trim();
+  if (trimmed.startsWith("raw:")) {
+    return { kind: "literal-css", value: trimmed.slice(4) };
+  }
+  const contextToken = parseContextThemeColorToken(trimmed, context);
+  if (contextToken) {
+    return { kind: "palette-context-token", token: contextToken };
+  }
+  const knownToken = parseThemeColorToken(trimmed);
+  if (knownToken) {
+    return { kind: "theme-token", token: knownToken };
+  }
+  warnUnknownThemeColorReference(trimmed);
+  return { kind: "literal-css", value: trimmed };
+}
+function resolveThemeColorReferenceValue(input, context) {
+  const reference = parseThemeColorReference(input, context);
+  return reference.kind === "literal-css" ? reference.value : rgbColorValue(reference.token);
+}
+var tokenOrCssColorValueSchema, CSS_COLOR_FUNCTION_PATTERN, CSS_HEX_COLOR_PATTERN, CSS_COLOR_KEYWORDS, COMMON_CSS_NAMED_COLORS;
+var init_tokenOrColor = __esm({
+  "../theme-core/src/utils/tokenOrColor.ts"() {
+    init_colorStyles();
+    init_colorTokenParts();
+    init_themeColorTokens();
+    tokenOrCssColorValueSchema = z.string();
+    CSS_COLOR_FUNCTION_PATTERN = /^(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color|color-mix|light-dark)\(/i;
+    CSS_HEX_COLOR_PATTERN = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+    CSS_COLOR_KEYWORDS = /* @__PURE__ */ new Set([
+      "transparent",
+      "currentcolor",
+      "inherit",
+      "initial",
+      "revert",
+      "revert-layer",
+      "unset"
+    ]);
+    COMMON_CSS_NAMED_COLORS = /* @__PURE__ */ new Set([
+      "black",
+      "blue",
+      "gray",
+      "green",
+      "grey",
+      "orange",
+      "pink",
+      "purple",
+      "red",
+      "white",
+      "yellow"
+    ]);
+  }
+});
 var axesSchema, colourHexString, paletteColorSchema, paletteMetaSchema, paletteSchema, typographyStyleSchema, bodyTypographyStyleSchema, headingSizeSchema, headingTypographyOverridesSchema, headingTypographyStyleSchema, proseLinkUnderlineStyleSchema, proseLinkUnderlineThicknessSchema, proseLinkUnderlineOffsetSchema, proseLinkStyleSchema, semanticSpacingSchema, boxRoundedSchema, boxBackgroundOverlaySchema, boxBackgroundSchema, sectionStylesOverrideSchema, containerStylesOverrideSchema, cardBorderOverrideSchema, cardStylesOverrideSchema, blockStyleOverridesSchema, blockThemeOverrideSchema, typographyScaleSchema, typographySchema, spaceSchema, corners, shadow, border, motion, inputStyle, headerVariant, headerPositioning, headerNavStyle, navFontWeight, headerMaxWidth, headerContainerSchema, headerBorderSchema, logoStyleSchema, headerLogoTextSchema, navEffectsSchema, dropdownStyleSchema, headerCtaGapSchema, headerCtaTreatmentSchema, navContainerSchema, headerBackgroundSchema, headerSchema, footerVariant, footerMaxWidth, footerMode, footerNavLayoutMode, footerNavLayoutAlign, footerSpacing, footerLogoPlacement, footerLogoSize, footerLogoMaxHeight, footerBottomTextLinkStyleSchema, footerBottomBarSchema, footerNavLayoutSchema, footerLogoSchema, footerSchema, containerPaddingPresetSchema, layoutSchema, heroTypographySizeSchema, heroTypographyLineHeightSchema, heroResponsiveTypographySchema, heroTypographySchema, heroSchema, bodyTextIntroTypographySizeSchema, bodyTextSchema, gradientsSchema, themeSchema;
 var init_schema3 = __esm({
   "../theme-core/src/schema.ts"() {
@@ -3949,6 +4187,8 @@ var init_schema3 = __esm({
     init_atRuleValidation();
     init_shared();
     init_types2();
+    init_themeColorTokens();
+    init_tokenOrColor();
     axesSchema = z.object({
       tone: z.enum(["minimal", "classic", "bold"]),
       energy: z.enum(["calm", "vibrant"]),
@@ -3985,24 +4225,22 @@ var init_schema3 = __esm({
       size: headingSizeSchema.nullable().optional(),
       lineHeight: z.enum(["normal", "relaxed", "loose"]).nullable().optional(),
       italic: z.boolean().nullable().optional(),
-      colorToken: z.string().min(1).nullable().optional()
-      // Palette token name for heading color
+      colorToken: themeColorTokenSchema.nullable().optional()
     });
     headingTypographyStyleSchema = typographyStyleSchema.extend({
       case: z.enum(["uppercase", "normal", "smallCaps"]).nullable(),
       italic: z.boolean().nullable(),
-      colorToken: z.string().min(1).nullable().optional()
-      // Palette token name for heading color
+      colorToken: themeColorTokenSchema.nullable().optional()
     });
     proseLinkUnderlineStyleSchema = z.enum(["solid", "dotted", "dashed"]);
     proseLinkUnderlineThicknessSchema = z.enum(["auto", "fromFont", "thin", "medium", "thick"]);
     proseLinkUnderlineOffsetSchema = z.enum(["auto", "tight", "normal", "loose"]);
     proseLinkStyleSchema = z.object({
-      colorToken: z.string().min(1).optional(),
-      hoverColorToken: z.string().min(1).optional(),
+      colorToken: themeColorTokenSchema.optional(),
+      hoverColorToken: themeColorTokenSchema.optional(),
       underline: z.boolean().optional(),
-      decorationColorToken: z.string().min(1).optional(),
-      hoverDecorationColorToken: z.string().min(1).optional(),
+      decorationColorToken: themeColorTokenSchema.optional(),
+      hoverDecorationColorToken: themeColorTokenSchema.optional(),
       underlineStyle: proseLinkUnderlineStyleSchema.optional(),
       underlineThickness: proseLinkUnderlineThicknessSchema.optional(),
       underlineOffset: proseLinkUnderlineOffsetSchema.optional()
@@ -4011,13 +4249,13 @@ var init_schema3 = __esm({
     boxRoundedSchema = z.enum(["none", "sm", "md", "lg", "xl", "2xl", "full"]);
     boxBackgroundOverlaySchema = z.object({
       type: z.enum(["none", "color", "gradient"]).nullable().optional(),
-      color: z.string().nullable().optional(),
+      color: tokenOrCssColorValueSchema.nullable().optional(),
       gradient: z.string().nullable().optional(),
       opacity: z.number().min(0).max(1).nullable().optional()
     });
     boxBackgroundSchema = z.object({
       type: z.enum(["color", "gradient", "image"]).optional(),
-      color: z.string().nullable().optional(),
+      color: tokenOrCssColorValueSchema.nullable().optional(),
       gradient: z.string().nullable().optional(),
       image: mediaSchema.nullable().optional(),
       objectFit: z.enum(["fill", "fit", "original", "custom"]).nullable().optional(),
@@ -4026,8 +4264,8 @@ var init_schema3 = __esm({
       opacity: z.number().min(0).max(1).nullable().optional(),
       motion: z.enum(["static", "fixed-frame"]).nullable().optional(),
       overlay: boxBackgroundOverlaySchema.nullable().optional(),
-      textColor: z.string().nullable().optional(),
-      headingColor: z.string().nullable().optional()
+      textColor: tokenOrCssColorValueSchema.nullable().optional(),
+      headingColor: tokenOrCssColorValueSchema.nullable().optional()
     });
     sectionStylesOverrideSchema = z.object({
       background: boxBackgroundSchema.nullable().optional(),
@@ -4046,7 +4284,7 @@ var init_schema3 = __esm({
     cardBorderOverrideSchema = z.object({
       enabled: z.boolean().nullable().optional(),
       width: z.enum(["none", "1", "2", "3"]).nullable().optional(),
-      colorToken: z.string().nullable().optional()
+      colorToken: themeColorTokenSchema.nullable().optional()
     });
     cardStylesOverrideSchema = z.object({
       background: boxBackgroundSchema.nullable().optional(),
@@ -4161,19 +4399,14 @@ var init_schema3 = __esm({
     }).optional();
     dropdownStyleSchema = z.object({
       // Container styling
-      background: z.string().default("surface"),
-      // color token
-      textColor: z.string().default("text"),
-      // color token
-      borderColor: z.string().nullable().default("border"),
-      // null = no border
+      background: themeColorTokenSchema.default("surface"),
+      textColor: themeColorTokenSchema.default("text"),
+      borderColor: themeColorTokenSchema.nullable().default("border"),
       shadow: z.enum(["none", "sm", "md", "lg"]).default("md"),
       borderRadius: z.enum(["none", "sm", "md", "lg"]).default("md"),
       // Link hover states (explicit control)
-      hoverBackground: z.string().nullable().optional(),
-      // color token, null = transparent
-      hoverTextColor: z.string().nullable().optional(),
-      // color token, null = inherit
+      hoverBackground: themeColorTokenSchema.nullable().optional(),
+      hoverTextColor: themeColorTokenSchema.nullable().optional(),
       // Typography
       textTransform: z.enum(["none", "uppercase", "capitalize"]).default("none"),
       letterSpacing: z.enum(["normal", "wide", "wider"]).default("normal"),
@@ -4191,10 +4424,10 @@ var init_schema3 = __esm({
     }).default({ type: "none", tint: null, opacity: 0.15 });
     headerBackgroundSchema = z.object({
       type: z.enum(["color", "gradient", "image"]),
-      color: z.string().nullable().optional(),
+      color: tokenOrCssColorValueSchema.nullable().optional(),
       gradient: gradientConfigSchema.nullable().optional(),
       image: mediaSchema.nullable().optional(),
-      textColor: z.string().nullable().optional()
+      textColor: tokenOrCssColorValueSchema.nullable().optional()
     });
     headerSchema = z.object({
       variant: headerVariant,
@@ -4206,11 +4439,9 @@ var init_schema3 = __esm({
         type: "color",
         color: "surface"
       }),
-      textColor: z.string().nullable().optional(),
-      // Site title and general header text
+      textColor: themeColorTokenSchema.nullable().optional(),
       navStyle: headerNavStyle,
-      navColor: z.string().nullable().optional(),
-      // Nav links (inherits textColor if not set)
+      navColor: themeColorTokenSchema.nullable().optional(),
       navWeight: navFontWeight.default("medium"),
       // New fields for header system enhancement
       container: headerContainerSchema,
@@ -4245,21 +4476,21 @@ var init_schema3 = __esm({
     footerLogoSize = z.enum(["sm", "md", "lg", "xl"]);
     footerLogoMaxHeight = z.enum(["sm", "md", "lg", "xl"]);
     footerBottomTextLinkStyleSchema = z.object({
-      colorToken: z.string().optional(),
-      hoverColorToken: z.string().nullable().optional(),
-      decorationColorToken: z.string().nullable().optional(),
+      colorToken: themeColorTokenSchema.optional(),
+      hoverColorToken: themeColorTokenSchema.nullable().optional(),
+      decorationColorToken: themeColorTokenSchema.nullable().optional(),
       underline: z.boolean().optional()
     });
     footerBottomBarSchema = z.object({
       enabled: z.boolean().optional(),
       fullBleed: z.boolean().optional(),
       background: headerBackgroundSchema.optional(),
-      textColor: z.string().nullable().optional(),
+      textColor: themeColorTokenSchema.nullable().optional(),
       textAlign: z.enum(["left", "center", "right"]).optional(),
       paddingY: footerSpacing.optional(),
       paddingX: footerSpacing.optional(),
       borderTop: z.object({
-        colorToken: z.string().nullable().optional(),
+        colorToken: themeColorTokenSchema.nullable().optional(),
         width: z.enum(["none", "thin", "medium", "thick"]).optional()
       }).optional()
     });
@@ -4294,7 +4525,7 @@ var init_schema3 = __esm({
       }),
       // Footer nav styling (independent from header)
       navStyle: headerNavStyle.default("minimal"),
-      navColor: z.string().nullable().optional(),
+      navColor: themeColorTokenSchema.nullable().optional(),
       navWeight: navFontWeight.default("medium"),
       // Full nav link customization (overrides navStyle if set)
       navLinkStyle: navLinkStyleSchema.optional(),
@@ -4448,28 +4679,13 @@ function definePaletteVariant(input) {
     colors: input.colors
   };
 }
-var paletteVariantIdSchema, PALETTE_TOKEN_NAMES, paletteTokenNameSchema, HEX_COLOR_REGEX, hexColorSchema, variantPaletteColorSchema;
+var paletteVariantIdSchema, HEX_COLOR_REGEX, hexColorSchema, variantPaletteColorSchema;
 var init_types11 = __esm({
   "../theme-core/src/palette/variants/types.ts"() {
     init_styleTags();
     init_schema3();
+    init_themeColorTokens();
     paletteVariantIdSchema = z.string().min(1).transform((value) => asPaletteVariantId(value));
-    PALETTE_TOKEN_NAMES = [
-      "primary",
-      "primaryForeground",
-      "secondary",
-      "accent",
-      "success",
-      "warning",
-      "destructive",
-      "background",
-      "surface",
-      "surfaceAlt",
-      "muted",
-      "text",
-      "border"
-    ];
-    paletteTokenNameSchema = z.enum(PALETTE_TOKEN_NAMES);
     HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/;
     hexColorSchema = z.string().regex(HEX_COLOR_REGEX, "Hex must be #RRGGBB (lowercase)").transform((value) => value);
     variantPaletteColorSchema = paletteColorSchema.extend({
@@ -4853,6 +5069,429 @@ var init_variants = __esm({
   }
 });
 
+// ../theme-core/src/site-styles/customizableSurfaces.ts
+var init_customizableSurfaces = __esm({
+  "../theme-core/src/site-styles/customizableSurfaces.ts"() {
+    init_types2();
+  }
+});
+
+// ../theme-core/src/site-styles/headerLooks.ts
+function asHeaderLookId(value) {
+  return value;
+}
+function baseHeader(theme) {
+  return {
+    ...theme.header,
+    navLinkStyle: void 0,
+    dropdownStyle: void 0,
+    ctaVariant: void 0
+  };
+}
+function solidBrandHeader(theme) {
+  const ctaVariant = resolveHeaderCtaVariant(theme, "inverted");
+  return {
+    ...baseHeader(theme),
+    variant: "classic",
+    positioning: "sticky",
+    shrinkOnScroll: true,
+    background: {
+      type: "color",
+      color: "primary"
+    },
+    textColor: "primaryForeground",
+    navColor: "primaryForeground",
+    navStyle: "underline-grow",
+    navWeight: "bold",
+    navLinkStyle: {
+      typography: "body",
+      fontWeight: "bold",
+      textTransform: "uppercase",
+      italic: false,
+      colorToken: "primaryForeground",
+      hoverColorToken: "secondary",
+      textSize: "sm",
+      letterSpacing: "wider",
+      padding: "compact",
+      paddingX: "compact",
+      borderRadius: "none",
+      effects: {
+        hover: [
+          { effectId: "text-color-change", options: { hoverColorToken: "secondary" } },
+          { effectId: "nav-underline", options: { style: "grow", colorToken: "secondary" } }
+        ]
+      }
+    },
+    dropdownStyle: {
+      background: "primary-700",
+      textColor: "primaryForeground",
+      borderColor: null,
+      shadow: "md",
+      borderRadius: "md",
+      hoverBackground: "primary-900",
+      hoverTextColor: "secondary",
+      textTransform: "uppercase",
+      letterSpacing: "wider",
+      fontWeight: "bold",
+      textSize: "sm"
+    },
+    border: {
+      style: "solid",
+      width: "none",
+      position: "none"
+    },
+    logoText: {
+      hideOnShrink: true,
+      mobileMaxWidth: "sm",
+      mobileWrapLines: 2
+    },
+    ctaGap: "compact",
+    ctaTreatment: "inverted",
+    ...ctaVariant ? { ctaVariant } : {}
+  };
+}
+function cleanBaseHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "classic",
+    positioning: "sticky",
+    shrinkOnScroll: false,
+    background: {
+      type: "color",
+      color: "surface"
+    },
+    textColor: "text",
+    navColor: "text",
+    navStyle: "minimal",
+    navWeight: "medium",
+    border: {
+      style: "solid",
+      width: "thin",
+      position: "bottom",
+      colorToken: "border"
+    },
+    ctaTreatment: "default",
+    ctaGap: "default"
+  };
+}
+function editorialLineHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "editorial",
+    positioning: "sticky",
+    shrinkOnScroll: false,
+    background: {
+      type: "color",
+      color: "background"
+    },
+    textColor: "text",
+    navColor: "text",
+    navStyle: "underline-grow",
+    navWeight: "medium",
+    logo: {
+      fontFamily: "heading",
+      letterSpacing: "wide",
+      gradient: false
+    },
+    ctaTreatment: "outline",
+    ctaVariant: resolveHeaderCtaVariant(theme, "outline"),
+    ctaGap: "relaxed"
+  };
+}
+function centeredCalmHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "centered",
+    positioning: "static",
+    shrinkOnScroll: false,
+    background: {
+      type: "color",
+      color: "surface"
+    },
+    textColor: "text",
+    navColor: "text",
+    navStyle: "minimal",
+    navWeight: "medium",
+    ctaTreatment: "ghost",
+    ctaVariant: resolveHeaderCtaVariant(theme, "ghost"),
+    ctaGap: "none"
+  };
+}
+function practicalUtilityHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "classic",
+    positioning: "sticky",
+    shrinkOnScroll: true,
+    background: {
+      type: "color",
+      color: "surface"
+    },
+    textColor: "text",
+    navColor: "text",
+    navStyle: "solid",
+    navWeight: "semibold",
+    shadow: {
+      elevation: "sm"
+    },
+    border: {
+      style: "solid",
+      width: "thin",
+      position: "bottom",
+      colorToken: "border"
+    },
+    ctaTreatment: "primary",
+    ctaVariant: resolveHeaderCtaVariant(theme, "primary"),
+    ctaGap: "compact",
+    logoText: {
+      mobileMaxWidth: "sm",
+      mobileWrapLines: 1,
+      hideOnShrink: false
+    }
+  };
+}
+function minimalTransparentHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "classic",
+    positioning: "static",
+    shrinkOnScroll: false,
+    background: {
+      type: "color",
+      color: "transparent"
+    },
+    textColor: "text",
+    navColor: "text",
+    navStyle: "underline",
+    navWeight: "medium",
+    border: {
+      style: "solid",
+      width: "none",
+      position: "none"
+    },
+    ctaTreatment: "outline",
+    ctaVariant: resolveHeaderCtaVariant(theme, "outline"),
+    ctaGap: "default"
+  };
+}
+function transparentOverlayHeader(theme) {
+  return {
+    ...baseHeader(theme),
+    variant: "transparent",
+    positioning: "fixed",
+    shrinkOnScroll: true,
+    background: {
+      type: "color",
+      color: "transparent"
+    },
+    textColor: "background",
+    navColor: "background",
+    navStyle: "frosted",
+    navWeight: "semibold",
+    border: {
+      style: "solid",
+      width: "none",
+      position: "none"
+    },
+    ctaTreatment: "inverted",
+    ctaVariant: resolveHeaderCtaVariant(theme, "inverted"),
+    ctaGap: "compact"
+  };
+}
+function floatingGlassHeader(theme) {
+  return {
+    ...transparentOverlayHeader(theme),
+    variant: "floating",
+    navStyle: "frosted",
+    navContainer: {
+      type: "glass",
+      tint: "text",
+      opacity: 0.16
+    },
+    container: {
+      rounded: "2xl",
+      border: true,
+      shadow: true,
+      padding: "sm",
+      tint: "background",
+      opacity: 0.12
+    }
+  };
+}
+var headerLookCatalog;
+var init_headerLooks = __esm({
+  "../theme-core/src/site-styles/headerLooks.ts"() {
+    init_headerCtaVariants();
+    init_customizableSurfaces();
+    init_types2();
+    headerLookCatalog = [
+      {
+        id: asHeaderLookId("clean-base"),
+        label: "Clean base",
+        visualTreatment: "solid-neutral",
+        layoutBehavior: "sticky",
+        openingRequirement: "none",
+        compile: cleanBaseHeader
+      },
+      {
+        id: asHeaderLookId("brand-solid"),
+        label: "Brand solid",
+        visualTreatment: "solid-brand",
+        layoutBehavior: "sticky-shrink",
+        openingRequirement: "none",
+        compile: solidBrandHeader
+      },
+      {
+        id: asHeaderLookId("editorial-line"),
+        label: "Editorial line",
+        visualTreatment: "light-editorial",
+        layoutBehavior: "sticky",
+        openingRequirement: "none",
+        maxRecommendedNavItems: 6,
+        compile: editorialLineHeader
+      },
+      {
+        id: asHeaderLookId("centered-calm"),
+        label: "Centered calm",
+        visualTreatment: "light-editorial",
+        layoutBehavior: "normal-flow",
+        openingRequirement: "none",
+        maxRecommendedNavItems: 5,
+        allowedLogoShapes: ["none", "text-only", "horizontal", "square"],
+        compile: centeredCalmHeader
+      },
+      {
+        id: asHeaderLookId("practical-utility"),
+        label: "Practical utility",
+        visualTreatment: "solid-neutral",
+        layoutBehavior: "sticky-shrink",
+        openingRequirement: "none",
+        requiresProminentCta: true,
+        compile: practicalUtilityHeader
+      },
+      {
+        id: asHeaderLookId("minimal-transparent"),
+        label: "Minimal transparent",
+        visualTreatment: "minimal-transparent",
+        layoutBehavior: "normal-flow",
+        openingRequirement: "reserved-space-ok",
+        compile: minimalTransparentHeader
+      },
+      {
+        id: asHeaderLookId("transparent-overlay"),
+        label: "Transparent overlay",
+        visualTreatment: "transparent-overlay",
+        layoutBehavior: "fixed-overlay",
+        openingRequirement: "requires-image-hero-with-contrast-overlay",
+        maxRecommendedNavItems: 5,
+        allowedLogoShapes: ["none", "text-only", "horizontal"],
+        compile: transparentOverlayHeader
+      },
+      {
+        id: asHeaderLookId("floating-glass"),
+        label: "Floating glass",
+        visualTreatment: "floating-glass",
+        layoutBehavior: "fixed-floating",
+        openingRequirement: "requires-image-hero-with-contrast-overlay",
+        maxRecommendedNavItems: 5,
+        allowedLogoShapes: ["none", "text-only", "horizontal"],
+        compile: floatingGlassHeader
+      }
+    ];
+    new Map(
+      headerLookCatalog.map((look) => [look.id, look])
+    );
+  }
+});
+
+// ../theme-core/src/site-styles/footerLooks.ts
+function asFooterLookId(value) {
+  return value;
+}
+function mutedGroundingFooter(theme) {
+  return theme.footer;
+}
+function brandTwoBandFooter(theme) {
+  return {
+    ...theme.footer,
+    variant: "split",
+    maxWidth: "container",
+    background: {
+      type: "color",
+      color: "primary-800"
+    },
+    navStyle: "minimal",
+    navWeight: "medium",
+    navColor: "primaryForeground",
+    navLinkStyle: {
+      typography: "body",
+      fontWeight: "medium",
+      textTransform: "none",
+      italic: false,
+      colorToken: "primaryForeground",
+      hoverColorToken: "secondary",
+      padding: "none",
+      borderRadius: "none"
+    },
+    bottomTextLinkStyle: {
+      colorToken: "secondary",
+      decorationColorToken: "secondary"
+    },
+    navLayout: {
+      layout: "inline-wrap",
+      align: "start",
+      gapX: "default",
+      gapY: "tight"
+    },
+    logo: {
+      showLogo: true,
+      showLogoText: false,
+      placement: "left",
+      size: "sm",
+      align: "start"
+    },
+    bottomBar: {
+      enabled: true,
+      fullBleed: true,
+      background: {
+        type: "color",
+        color: "primary-900"
+      },
+      textColor: "primaryForeground",
+      textAlign: "center",
+      paddingX: "default",
+      paddingY: "compact",
+      borderTop: {
+        width: "none"
+      }
+    }
+  };
+}
+var footerLookCatalog;
+var init_footerLooks = __esm({
+  "../theme-core/src/site-styles/footerLooks.ts"() {
+    init_customizableSurfaces();
+    init_types2();
+    footerLookCatalog = [
+      {
+        id: asFooterLookId("footer-muted-grounding"),
+        label: "Muted grounding footer",
+        compile: mutedGroundingFooter
+      },
+      {
+        id: asFooterLookId("site-footer-brand-two-band"),
+        label: "Two-band brand footer",
+        maxRecommendedNavDensity: "balanced",
+        allowedContentPresence: ["default-footer", "default-and-blocks"],
+        compile: brandTwoBandFooter
+      }
+    ];
+    new Map(
+      footerLookCatalog.map((look) => [look.id, look])
+    );
+  }
+});
+
 // ../theme-core/src/site-styles/curatedChoices.ts
 var init_curatedChoices = __esm({
   "../theme-core/src/site-styles/curatedChoices.ts"() {
@@ -4945,6 +5584,9 @@ function defineCuratedSiteStyle(input) {
     },
     ...input.themeOverrides ? { themeOverrides: input.themeOverrides } : {},
     recommendedAppearancePresetIds: (input.recommendedAppearancePresetIds ?? []).map(asAppearancePresetId),
+    recommendedHeaderLookIds: (input.recommendedHeaderLookIds ?? ["clean-base"]).map(asHeaderLookId),
+    // Empty is intentional: resolveFooterLook always appends its guaranteed fallback.
+    recommendedFooterLookIds: (input.recommendedFooterLookIds ?? []).map(asFooterLookId),
     buttonPersonalityChoices: input.buttonPersonalityChoices,
     paletteVariantChoices: input.paletteVariantChoices
   };
@@ -4960,6 +5602,8 @@ var init_curatedSiteStyles = __esm({
   "../theme-core/src/site-styles/curatedSiteStyles.ts"() {
     init_personalities();
     init_variants();
+    init_headerLooks();
+    init_footerLooks();
     init_curatedChoices();
     init_sourceCatalogs();
     init_types2();
@@ -5052,6 +5696,7 @@ var init_curatedSiteStyles = __esm({
           motion: "subtle"
         },
         compositionBudget: quietBudget,
+        recommendedHeaderLookIds: ["centered-calm", "minimal-transparent", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("soft-pill"),
           buttonChoice("pebble"),
@@ -5080,6 +5725,7 @@ var init_curatedSiteStyles = __esm({
           motion: "subtle"
         },
         compositionBudget: balancedBudget,
+        recommendedHeaderLookIds: ["practical-utility", "brand-solid", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("confident-chip"),
           buttonChoice("soft-pill"),
@@ -5106,6 +5752,7 @@ var init_curatedSiteStyles = __esm({
           motion: "subtle"
         },
         compositionBudget: balancedBudget,
+        recommendedHeaderLookIds: ["editorial-line", "minimal-transparent", "centered-calm"],
         buttonPersonalityChoices: [
           buttonChoice("editorial-link"),
           buttonChoice("soft-pill"),
@@ -5133,6 +5780,7 @@ var init_curatedSiteStyles = __esm({
           motion: "expressive"
         },
         compositionBudget: balancedBudget,
+        recommendedHeaderLookIds: ["brand-solid", "practical-utility", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("pebble"),
           buttonChoice("brushed-wash"),
@@ -5166,6 +5814,7 @@ var init_curatedSiteStyles = __esm({
           motion: "none"
         },
         compositionBudget: quietBudget,
+        recommendedHeaderLookIds: ["minimal-transparent", "editorial-line", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("editorial-link"),
           buttonChoice("confident-chip"),
@@ -5200,6 +5849,7 @@ var init_curatedSiteStyles = __esm({
           motion: "none"
         },
         compositionBudget: quietBudget,
+        recommendedHeaderLookIds: ["practical-utility", "brand-solid", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("confident-chip"),
           buttonChoice("pebble"),
@@ -5226,6 +5876,7 @@ var init_curatedSiteStyles = __esm({
           motion: "subtle"
         },
         compositionBudget: balancedBudget,
+        recommendedHeaderLookIds: ["centered-calm", "minimal-transparent", "clean-base"],
         buttonPersonalityChoices: [
           buttonChoice("soft-pill"),
           buttonChoice("pebble"),
@@ -5260,6 +5911,7 @@ var init_curatedSiteStyles = __esm({
           motion: "expressive"
         },
         compositionBudget: expressiveBudget,
+        recommendedHeaderLookIds: ["transparent-overlay", "floating-glass", "brand-solid"],
         buttonPersonalityChoices: [
           buttonChoice("ink-stamp"),
           buttonChoice("confident-chip"),
@@ -5349,14 +6001,14 @@ var init_curatedSiteStyles = __esm({
           inputs: expressiveUnderlineInputs
         },
         recommendedAppearancePresetIds: [
-          "site-header-brand-solid-inverted-cta",
-          "site-footer-brand-two-band",
           "hero-brand-scrim-fixed-frame",
           "body-text-editorial-intro",
           "schedule-details-brand-depth",
           "testimonials-accent-quote-proof",
           "contact-form-brand-depth-card"
         ],
+        recommendedHeaderLookIds: ["brand-solid", "transparent-overlay", "practical-utility"],
+        recommendedFooterLookIds: ["site-footer-brand-two-band", "footer-muted-grounding"],
         buttonPersonalityChoices: [
           buttonChoice("showtime-pill"),
           buttonChoice("confident-chip"),
@@ -5384,6 +6036,20 @@ var init_lookResolution = __esm({
     init_types2();
   }
 });
+var init_siteStyleBlockPolicies = __esm({
+  "../theme-core/src/site-styles/siteStyleBlockPolicies.ts"() {
+    init_lookResolution();
+    init_appearancePresets();
+    init_pageDesignIntent();
+    init_types2();
+    asPageFlowPresetId("generated-default");
+    asSiteStyleId("site-style:south-west-twerk-school");
+    asAppearancePresetId("hero-brand-scrim-fixed-frame");
+    asLayoutVariantKey("classic");
+    asLayoutVariantKey("micro");
+    asBoundaryOptionId("break:wave");
+  }
+});
 
 // ../theme-core/src/site-styles/pageDesignEditorModel.ts
 var noneBoundaryOption, softBoundaryOption, spaciousBoundaryOption;
@@ -5391,6 +6057,7 @@ var init_pageDesignEditorModel = __esm({
   "../theme-core/src/site-styles/pageDesignEditorModel.ts"() {
     init_curatedSiteStyles();
     init_lookResolution();
+    init_siteStyleBlockPolicies();
     init_pageDesignIntent();
     init_types2();
     noneBoundaryOption = {
@@ -5641,7 +6308,8 @@ var init_previewCompiler = __esm({
     init_curatedSiteStyles();
     init_resolver2();
     init_types2();
-    init_appearancePresets();
+    init_footerLooks();
+    init_headerLooks();
     init_runtimeCompiler();
     init_blockFlow();
     init_pageDesignEditorModel();
@@ -5766,14 +6434,29 @@ var init_generatedSchemas = __esm({
   }
 });
 
+// ../theme-core/src/site-styles/records.ts
+var init_records = __esm({
+  "../theme-core/src/site-styles/records.ts"() {
+  }
+});
+
+// ../theme-core/src/site-styles/headerOpeningSection.ts
+var init_headerOpeningSection = __esm({
+  "../theme-core/src/site-styles/headerOpeningSection.ts"() {
+    init_headerLooks();
+    init_records();
+  }
+});
+
 // ../theme-core/src/site-styles/generatedDesignPipeline.ts
 var init_generatedDesignPipeline = __esm({
   "../theme-core/src/site-styles/generatedDesignPipeline.ts"() {
     init_compositionBudget();
     init_designState();
     init_generatedSchemas();
-    init_pageDesignIntent();
+    init_siteStyleBlockPolicies();
     init_lookResolution();
+    init_headerOpeningSection();
     init_resolver2();
     init_runtimeCompiler();
     init_types2();
@@ -5941,9 +6624,13 @@ var init_site_styles = __esm({
     init_contentTemplateRuntimeCompiler();
     init_curatedChoices();
     init_curatedSiteStyles();
+    init_customizableSurfaces();
     init_designState();
+    init_footerLooks();
     init_generatedSchemas();
     init_generatedDesignPipeline();
+    init_headerLooks();
+    init_headerOpeningSection();
     init_lookResolution();
     init_pageDesignAuthority();
     init_pageDesignEditorErrors();
@@ -5951,8 +6638,10 @@ var init_site_styles = __esm({
     init_pageDesignIntent();
     init_previewCustomization();
     init_rawStyleFields();
+    init_records();
     init_resolver2();
     init_runtimeCompiler();
+    init_siteStyleBlockPolicies();
     init_sourceCatalogs();
     init_styleTags();
     init_tokenRecipes();
@@ -7114,56 +7803,6 @@ var init_ctaRow = __esm({
   }
 });
 
-// ../theme-core/src/utils/colorStyles.ts
-function parseToken(source) {
-  if (source.startsWith("raw:")) {
-    return { token: source, raw: source.slice(4) };
-  }
-  if (source.includes("/")) {
-    const [token, opacity] = source.split("/");
-    const alpha = Number(opacity) / 100;
-    if (!Number.isNaN(alpha) && token) {
-      return { token, alpha };
-    }
-    return { token: source };
-  }
-  return { token: source };
-}
-function rgbColorValue(token) {
-  const { token: baseToken, alpha, raw } = parseToken(token);
-  if (raw) {
-    return raw;
-  }
-  const cssVar = `${COLOR_VAR_PREFIX}${baseToken}`;
-  if (alpha === void 0) {
-    return `rgb(var(${cssVar}))`;
-  }
-  return `rgba(var(${cssVar}), ${alpha})`;
-}
-function backgroundColorStyle(token) {
-  return { backgroundColor: rgbColorValue(token) };
-}
-function textColorStyle(token) {
-  return { color: rgbColorValue(token) };
-}
-function borderColorStyle(token) {
-  return { borderColor: rgbColorValue(token) };
-}
-function mergeStyles(...styles) {
-  const merged = {};
-  for (const style of styles) {
-    if (!style) continue;
-    Object.assign(merged, style);
-  }
-  return Object.keys(merged).length ? merged : void 0;
-}
-var COLOR_VAR_PREFIX;
-var init_colorStyles = __esm({
-  "../theme-core/src/utils/colorStyles.ts"() {
-    COLOR_VAR_PREFIX = "--tb-";
-  }
-});
-
 // ../blocks/src/system/node/fragments/cardContainer.ts
 var init_cardContainer = __esm({
   "../blocks/src/system/node/fragments/cardContainer.ts"() {
@@ -7579,113 +8218,15 @@ var init_core3 = __esm({
   }
 });
 
-// ../blocks/src/system/transforms/registry/_utils/colorResolution.ts
-function isLiteralCssColorValue(value) {
-  return CSS_HEX_COLOR_PATTERN.test(value) || CSS_COLOR_FUNCTION_PATTERN.test(value) || value.startsWith("var(") || CSS_COLOR_KEYWORDS.has(value);
-}
-function resolveBackgroundColorValue(tokenOrCssValue, context) {
-  const trimmed = tokenOrCssValue.trim();
-  if (!trimmed) return "";
-  if (trimmed.startsWith("raw:")) {
-    return rgbColorValue(trimmed);
-  }
-  if (context?.theme?.palette?.[trimmed]) {
-    return rgbColorValue(trimmed);
-  }
-  if (trimmed.includes("/")) {
-    const [base, opacity] = trimmed.split("/");
-    const alpha = Number(opacity) / 100;
-    if (base && !Number.isNaN(alpha) && context?.theme?.palette?.[base]) {
-      return rgbColorValue(trimmed);
-    }
-  }
-  if (isLiteralCssColorValue(trimmed)) {
-    return trimmed;
-  }
-  if (THEME_COLOR_TOKEN_PATTERN.test(trimmed)) {
-    return rgbColorValue(trimmed);
-  }
-  return trimmed;
+// ../blocks/src/system/transforms/registry/_utils/themeColorResolution.ts
+function resolveBackgroundColorValue(value, context) {
+  return resolveThemeColorReferenceValue(value, {
+    palette: context.theme?.palette
+  });
 }
-var CSS_COLOR_FUNCTION_PATTERN, CSS_HEX_COLOR_PATTERN, THEME_COLOR_TOKEN_PATTERN, CSS_COLOR_KEYWORDS;
-var init_colorResolution = __esm({
-  "../blocks/src/system/transforms/registry/_utils/colorResolution.ts"() {
-    init_colorStyles();
-    CSS_COLOR_FUNCTION_PATTERN = /^(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color|color-mix|light-dark)\(/i;
-    CSS_HEX_COLOR_PATTERN = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
-    THEME_COLOR_TOKEN_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*(?:-[a-zA-Z0-9]+)*(?:\/(?:100|[1-9]?\d|0))?$/;
-    CSS_COLOR_KEYWORDS = /* @__PURE__ */ new Set([
-      "transparent",
-      "currentColor",
-      "inherit",
-      "initial",
-      "revert",
-      "revert-layer",
-      "unset"
-    ]);
-  }
-});
-
-// ../theme-core/src/tokens/blockColorTokens.ts
-function parseOpacityPercent(source) {
-  const trimmed = source.trim();
-  if (!trimmed) return null;
-  if (!/^\d{1,3}(?:\.\d+)?$/.test(trimmed)) return null;
-  const value = Number(trimmed);
-  if (!Number.isFinite(value)) return null;
-  if (value < 0 || value > 100) return null;
-  return value;
-}
-function isBlockColorToken(value) {
-  if (typeof value !== "string") return false;
-  const trimmed = value.trim();
-  if (!trimmed) return false;
-  const [name, opacityRaw, extra] = trimmed.split("/");
-  if (extra !== void 0) return false;
-  if (!name) return false;
-  if (!blockColorTokenNameSet.has(name)) return false;
-  if (opacityRaw === void 0) return true;
-  return parseOpacityPercent(opacityRaw) !== null;
-}
-function parseBlockColorToken(value) {
-  if (!isBlockColorToken(value)) return null;
-  return value.trim();
-}
-var blockColorTokenNames, blockColorTokenNameSet;
-var init_blockColorTokens = __esm({
-  "../theme-core/src/tokens/blockColorTokens.ts"() {
-    blockColorTokenNames = [
-      "text",
-      "heading",
-      "mutedText",
-      "surface",
-      "background",
-      "foreground",
-      "border",
-      "primary",
-      "secondary",
-      "accent",
-      "success",
-      "warning",
-      "info",
-      "error",
-      "destructive",
-      "scrim",
-      "shadow",
-      // Common "on*" tokens used when rendering colored chips/badges.
-      "onPrimary",
-      "onSecondary",
-      "onAccent",
-      "onSuccess",
-      "onWarning",
-      "onInfo",
-      "onError",
-      "onDestructive",
-      "onSurface"
-    ];
-    blockColorTokenNameSet = new Set(
-      blockColorTokenNames
-    );
+var init_themeColorResolution = __esm({
+  "../blocks/src/system/transforms/registry/_utils/themeColorResolution.ts"() {
+    init_tokenOrColor();
   }
 });
 
@@ -7733,8 +8274,8 @@ var init_boxStyles2 = __esm({
     init_spacing();
     init_site_styles();
     init_colorStyles();
-    init_colorResolution();
     init_blockColorTokens();
+    init_themeColorResolution();
     spacingTransform = {
       id: "boxStyles.spacing",
       kind: "string",
@@ -8020,17 +8561,17 @@ var init_boxStyles2 = __esm({
       id: "sectionStyles.resolveTextColorStyle",
       kind: "formatter",
       summary: "Resolve section text color token into a style object",
-      run: (value, options, _context) => {
+      run: (value, options, context) => {
         const fallbackToken = options?.fallbackToken;
         if (typeof value === "string" && value.trim()) {
-          const colorValue = rgbColorValue(value.trim());
+          const colorValue = resolveBackgroundColorValue(value.trim(), context);
           return {
             color: colorValue,
             "--section-text-color": colorValue
           };
         }
         if (typeof fallbackToken === "string" && fallbackToken.trim()) {
-          const colorValue = rgbColorValue(fallbackToken.trim());
+          const colorValue = resolveBackgroundColorValue(fallbackToken.trim(), context);
           return {
             color: colorValue,
             "--section-text-color": colorValue
@@ -8043,16 +8584,16 @@ var init_boxStyles2 = __esm({
       id: "sectionStyles.resolveHeadingColorStyle",
       kind: "formatter",
       summary: "Resolve section heading color token into a style object",
-      run: (value, options, _context) => {
+      run: (value, options, context) => {
         const fallbackToken = options?.fallbackToken;
         if (typeof value === "string" && value.trim()) {
-          const colorValue = rgbColorValue(value.trim());
+          const colorValue = resolveBackgroundColorValue(value.trim(), context);
           return {
             "--section-heading-color": colorValue
           };
         }
         if (typeof fallbackToken === "string" && fallbackToken.trim()) {
-          const colorValue = rgbColorValue(fallbackToken.trim());
+          const colorValue = resolveBackgroundColorValue(fallbackToken.trim(), context);
           return {
             "--section-heading-color": colorValue
           };
@@ -11794,7 +12335,7 @@ var init_colorConversion = __esm({
 });
 
 // ../blocks/src/lib/typeGuards.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var init_typeGuards = __esm({
@@ -11851,66 +12392,66 @@ var init_media2 = __esm({
       "audio",
       "video"
     ];
-    hotspotSchema2 = z42.object({
-      x: z42.number().min(0).max(1),
-      y: z42.number().min(0).max(1),
-      radius: z42.number().optional()
-    });
-    rotationSchema2 = z42.union([z42.literal(0), z42.literal(90), z42.literal(180), z42.literal(270)]);
-    rectSchema2 = z42.tuple([z42.number(), z42.number(), z42.number(), z42.number()]);
-    aspectCropSchema2 = z42.object({
-      aspect: z42.preprocess((value) => value == null ? void 0 : value, z42.string().optional()),
-      rect: z42.preprocess((value) => value == null ? void 0 : value, rectSchema2.optional()),
-      hotspot: z42.preprocess((value) => value == null ? void 0 : value, hotspotSchema2.optional()),
-      rotation: z42.preprocess((value) => value == null ? void 0 : value, rotationSchema2.optional())
-    });
-    transformSchema2 = z42.object({
-      aspectCrops: z42.preprocess((value) => {
+    hotspotSchema2 = z44.object({
+      x: z44.number().min(0).max(1),
+      y: z44.number().min(0).max(1),
+      radius: z44.number().optional()
+    });
+    rotationSchema2 = z44.union([z44.literal(0), z44.literal(90), z44.literal(180), z44.literal(270)]);
+    rectSchema2 = z44.tuple([z44.number(), z44.number(), z44.number(), z44.number()]);
+    aspectCropSchema2 = z44.object({
+      aspect: z44.preprocess((value) => value == null ? void 0 : value, z44.string().optional()),
+      rect: z44.preprocess((value) => value == null ? void 0 : value, rectSchema2.optional()),
+      hotspot: z44.preprocess((value) => value == null ? void 0 : value, hotspotSchema2.optional()),
+      rotation: z44.preprocess((value) => value == null ? void 0 : value, rotationSchema2.optional())
+    });
+    transformSchema2 = z44.object({
+      aspectCrops: z44.preprocess((value) => {
         if (!value || typeof value !== "object" || Array.isArray(value)) {
           return void 0;
         }
         return value;
-      }, z42.record(z42.string(), aspectCropSchema2.catch({}))).optional(),
+      }, z44.record(z44.string(), aspectCropSchema2.catch({}))).optional(),
       rect: rectSchema2.optional(),
       hotspot: hotspotSchema2.optional(),
       rotation: rotationSchema2.optional()
     });
-    mediaPosterSchema = z42.discriminatedUnion("tag", [
-      z42.object({
-        tag: z42.literal("storage"),
-        assetId: z42.string().optional(),
-        storageBucket: z42.string().min(1),
-        storagePath: z42.string().min(1)
+    mediaPosterSchema = z44.discriminatedUnion("tag", [
+      z44.object({
+        tag: z44.literal("storage"),
+        assetId: z44.string().optional(),
+        storageBucket: z44.string().min(1),
+        storagePath: z44.string().min(1)
       }),
-      z42.object({
-        tag: z42.literal("external-src"),
-        assetId: z42.string().optional(),
-        src: z42.string().url()
+      z44.object({
+        tag: z44.literal("external-src"),
+        assetId: z44.string().optional(),
+        src: z44.string().url()
       })
     ]);
-    mediaBaseSchema = z42.object({
-      purpose: z42.string().optional(),
-      placeholder: z42.boolean().default(true).optional(),
-      assetId: z42.string().optional(),
-      identifier: z42.string().optional(),
-      src: z42.string().optional(),
-      alt: z42.string().optional(),
-      filename: z42.string().optional(),
-      mimeType: z42.string().optional(),
-      width: z42.number().optional(),
-      height: z42.number().optional(),
-      storageBucket: z42.string().optional(),
-      storagePath: z42.string().optional(),
+    mediaBaseSchema = z44.object({
+      purpose: z44.string().optional(),
+      placeholder: z44.boolean().default(true).optional(),
+      assetId: z44.string().optional(),
+      identifier: z44.string().optional(),
+      src: z44.string().optional(),
+      alt: z44.string().optional(),
+      filename: z44.string().optional(),
+      mimeType: z44.string().optional(),
+      width: z44.number().optional(),
+      height: z44.number().optional(),
+      storageBucket: z44.string().optional(),
+      storagePath: z44.string().optional(),
       poster: mediaPosterSchema.optional(),
       transform: transformSchema2.optional()
     });
-    imageMediaSchema = mediaBaseSchema.extend({ type: z42.literal("image") });
-    videoMediaSchema = mediaBaseSchema.extend({ type: z42.literal("video") });
-    audioMediaSchema = mediaBaseSchema.extend({ type: z42.literal("audio") });
-    documentMediaSchema = mediaBaseSchema.extend({ type: z42.literal("document") });
-    spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z42.literal("spreadsheet") });
-    archiveMediaSchema = mediaBaseSchema.extend({ type: z42.literal("archive") });
-    mediaSchema2 = z42.discriminatedUnion("type", [
+    imageMediaSchema = mediaBaseSchema.extend({ type: z44.literal("image") });
+    videoMediaSchema = mediaBaseSchema.extend({ type: z44.literal("video") });
+    audioMediaSchema = mediaBaseSchema.extend({ type: z44.literal("audio") });
+    documentMediaSchema = mediaBaseSchema.extend({ type: z44.literal("document") });
+    spreadsheetMediaSchema = mediaBaseSchema.extend({ type: z44.literal("spreadsheet") });
+    archiveMediaSchema = mediaBaseSchema.extend({ type: z44.literal("archive") });
+    mediaSchema2 = z44.discriminatedUnion("type", [
       imageMediaSchema,
       videoMediaSchema,
       audioMediaSchema,
@@ -16519,6 +17060,8 @@ var init_tokens2 = __esm({
   "../theme-core/src/tokens/index.ts"() {
     init_tokens();
     init_blockColorTokens();
+    init_themeColorTokens();
+    init_colorTokenParts();
     init_resolver();
   }
 });
@@ -17862,6 +18405,46 @@ var ENDPOINT_DEFINITIONS = {
       "server:internal_error"
     ]
   },
+  listBookingClosures: {
+    path: "/sites/{siteId}/bookings/closures",
+    method: "GET",
+    auth: "user",
+    tags: ["site-{siteId}", "bookings", "closures-{siteId}"],
+    responseKind: "json",
+    errors: ["auth:forbidden", "server:internal_error"]
+  },
+  previewBookingClosure: {
+    path: "/sites/{siteId}/bookings/closures/preview",
+    method: "POST",
+    auth: "user",
+    tags: ["site-{siteId}", "bookings", "closures-{siteId}"],
+    responseKind: "json",
+    errors: ["validation:invalid_input", "auth:forbidden", "server:internal_error"]
+  },
+  createBookingClosure: {
+    path: "/sites/{siteId}/bookings/closures",
+    method: "POST",
+    auth: "user",
+    tags: ["site-{siteId}", "bookings", "closures-{siteId}"],
+    responseKind: "json",
+    errors: ["validation:invalid_input", "resource:conflict", "auth:forbidden", "server:internal_error"]
+  },
+  getBookingClosure: {
+    path: "/sites/{siteId}/bookings/closures/{closureId}",
+    method: "GET",
+    auth: "user",
+    tags: ["site-{siteId}", "bookings", "closures-{siteId}"],
+    responseKind: "json",
+    errors: ["resource:not_found", "server:internal_error"]
+  },
+  deleteBookingClosure: {
+    path: "/sites/{siteId}/bookings/closures/{closureId}",
+    method: "DELETE",
+    auth: "user",
+    tags: ["site-{siteId}", "bookings", "closures-{siteId}"],
+    responseKind: "json",
+    errors: ["resource:not_found", "server:internal_error"]
+  },
   // Ops (event hosts/admins)
   opsListUpcomingEventOccurrences: {
     path: "/ops/sites/{siteId}/events",
@@ -18279,7 +18862,7 @@ var ENDPOINT_DEFINITIONS = {
     method: "POST",
     auth: "user",
     responseKind: "json",
-    errors: ["validation:invalid_input", "server:internal_error"]
+    errors: ["validation:invalid_input", "billing:plan_limit_exceeded", "server:internal_error"]
   },
   getAppointmentResource: {
     path: "/sites/{siteId}/bookings/resources/{resourceId}",
@@ -18944,6 +19527,31 @@ var ENDPOINT_DEFINITIONS = {
     auth: "user",
     responseKind: "json"
   },
+  linkCurrentUserPractitioner: {
+    path: "/sites/{siteId}/members/practitioner-link",
+    method: "POST",
+    tags: ["site-{siteId}", "site-members-{siteId}"],
+    auth: "user",
+    responseKind: "json",
+    errors: [
+      "validation:invalid_input",
+      "auth:forbidden",
+      "resource:not_found",
+      "resource:already_exists",
+      "server:internal_error"
+    ]
+  },
+  unlinkCurrentUserPractitioner: {
+    path: "/sites/{siteId}/members/practitioner-link",
+    method: "DELETE",
+    tags: ["site-{siteId}", "site-members-{siteId}"],
+    auth: "user",
+    responseKind: "json",
+    errors: [
+      "auth:forbidden",
+      "server:internal_error"
+    ]
+  },
   authLogin: {
     path: "/auth/login/submit",
     method: "POST",
@@ -19139,6 +19747,42 @@ var ENDPOINT_DEFINITIONS = {
     auth: "user",
     responseKind: "json"
   },
+  listContentEntryVersions: {
+    path: "/sites/{siteId}/content/{type}/{entryId}/versions",
+    method: "GET",
+    errors: ["validation:invalid_input", "resource:not_found"],
+    tags: [
+      "site-{siteId}",
+      "content-{siteId}-{type}",
+      "content-entry-{entryId}"
+    ],
+    auth: "user",
+    responseKind: "json"
+  },
+  getContentEntryVersion: {
+    path: "/sites/{siteId}/content/{type}/{entryId}/versions/{versionId}",
+    method: "GET",
+    errors: ["validation:invalid_input", "resource:not_found"],
+    tags: [
+      "site-{siteId}",
+      "content-{siteId}-{type}",
+      "content-entry-{entryId}"
+    ],
+    auth: "user",
+    responseKind: "json"
+  },
+  restoreContentEntryVersion: {
+    path: "/sites/{siteId}/content/{type}/{entryId}/versions/{versionId}/restore",
+    method: "POST",
+    errors: ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"],
+    tags: [
+      "site-{siteId}",
+      "content-{siteId}-{type}",
+      "content-entry-{entryId}"
+    ],
+    auth: "user",
+    responseKind: "json"
+  },
   updateContentEntryContent: {
     path: "/sites/{siteId}/content/{type}/{entryId}/content",
     method: "PUT",
@@ -20509,6 +21153,30 @@ var ENDPOINT_DEFINITIONS = {
       "server:internal_error"
     ]
   },
+  listPageVersions: {
+    path: "/sites/{siteId}/pages/{pageId}/versions",
+    method: "GET",
+    errors: ["validation:invalid_input", "resource:not_found"],
+    tags: [TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById],
+    auth: "user",
+    responseKind: "json"
+  },
+  getPageVersion: {
+    path: "/sites/{siteId}/pages/{pageId}/versions/{versionId}",
+    method: "GET",
+    errors: ["validation:invalid_input", "resource:not_found"],
+    tags: [TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById],
+    auth: "user",
+    responseKind: "json"
+  },
+  restorePageVersion: {
+    path: "/sites/{siteId}/pages/{pageId}/versions/{versionId}/restore",
+    method: "POST",
+    errors: ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"],
+    tags: [TAG_TEMPLATES.siteRoutableContent, TAG_TEMPLATES.pageById],
+    auth: "user",
+    responseKind: "json"
+  },
   applyPageDesignEditorAction: {
     path: "/sites/{siteId}/pages/{pageId}/design/actions",
     method: "POST",
@@ -20559,21 +21227,21 @@ var ENDPOINT_DEFINITIONS = {
     responseKind: "json"
   },
   updateForm: {
-    path: "/sites/{siteId}/forms/{slug}",
+    path: "/sites/{siteId}/forms/{formId}",
     method: "PATCH",
     tags: [TAG_TEMPLATES.siteForms],
     auth: "user",
     responseKind: "json"
   },
   deleteForm: {
-    path: "/sites/{siteId}/forms/{slug}",
+    path: "/sites/{siteId}/forms/{formId}",
     method: "DELETE",
     tags: [TAG_TEMPLATES.siteForms],
     auth: "user",
     responseKind: "json"
   },
   listFormSubmissions: {
-    path: "/sites/{siteId}/forms/{slug}/submissions",
+    path: "/sites/{siteId}/forms/{formId}/submissions",
     method: "GET",
     revalidate: 30,
     tags: [TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug],
@@ -20581,7 +21249,7 @@ var ENDPOINT_DEFINITIONS = {
     responseKind: "json"
   },
   createFormSubmissionRectificationAnnotation: {
-    path: "/sites/{siteId}/forms/{slug}/submissions/{submissionId}/annotations",
+    path: "/sites/{siteId}/forms/{formId}/submissions/{submissionId}/annotations",
     method: "POST",
     tags: [TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug],
     auth: "user",
@@ -20594,7 +21262,7 @@ var ENDPOINT_DEFINITIONS = {
     ]
   },
   exportFormSubmissionsCsv: {
-    path: "/sites/{siteId}/forms/{slug}/submissions/export.csv",
+    path: "/sites/{siteId}/forms/{formId}/submissions/export.csv",
     method: "GET",
     tags: [TAG_TEMPLATES.siteForms, TAG_TEMPLATES.formSubmissionsBySlug],
     auth: "user",
@@ -27252,16 +27920,16 @@ var interpolateRichTextTokensOptionsSchema = z.object({
 var richTextTokenPattern = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
 function getSiteName(context) {
   const viewModel = context.viewModel;
-  if (!isRecord2(viewModel)) return null;
+  if (!isRecord3(viewModel)) return null;
   const site = viewModel.site;
-  if (isRecord2(site) && typeof site.title === "string") {
+  if (isRecord3(site) && typeof site.title === "string") {
     const title = site.title.trim();
     return title.length > 0 ? title : null;
   }
   const root = viewModel.$root;
-  if (isRecord2(root)) {
+  if (isRecord3(root)) {
     const rootSite = root.site;
-    if (isRecord2(rootSite) && typeof rootSite.title === "string") {
+    if (isRecord3(rootSite) && typeof rootSite.title === "string") {
       const title = rootSite.title.trim();
       if (title.length > 0) return title;
     }
@@ -27283,7 +27951,7 @@ function replaceTokenText(input, allowedTokens, tokenValues) {
   });
 }
 function visitRichTextNode(node, allowedTokens, tokenValues) {
-  if (!isRecord2(node)) return node;
+  if (!isRecord3(node)) return node;
   let changed = false;
   const nextNode = { ...node };
   if (nextNode.type === "text" && typeof nextNode.text === "string") {
@@ -27309,13 +27977,13 @@ function visitRichTextNode(node, allowedTokens, tokenValues) {
   return changed ? nextNode : node;
 }
 function interpolateRichTextTokens(value, options, context) {
-  if (!isRecord2(value)) return value;
+  if (!isRecord3(value)) return value;
   const allowedTokens = new Set(options.tokens);
   const tokenValues = {
     year: String((/* @__PURE__ */ new Date()).getFullYear()),
     site_name: getSiteName(context)
   };
-  if (isRecord2(value.doc)) {
+  if (isRecord3(value.doc)) {
     const nextDoc = visitRichTextNode(value.doc, allowedTokens, tokenValues);
     if (nextDoc === value.doc) return value;
     return { ...value, doc: nextDoc };
@@ -32215,7 +32883,7 @@ init_core3();
 
 // ../blocks/src/system/transforms/registry/background.ts
 init_background2();
-init_colorResolution();
+init_themeColorResolution();
 
 // ../blocks/src/system/helpers/backgroundMedia.ts
 init_media2();
@@ -35075,20 +35743,20 @@ var ManagementApiError = class extends Error {
 function is404Error(error) {
   return error instanceof ManagementApiError && error.statusCode === 404;
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isFieldError(value) {
-  return isRecord3(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
+  return isRecord4(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
 }
 function parseApiResponse(value) {
-  if (!isRecord3(value)) return null;
+  if (!isRecord4(value)) return null;
   if (value.success === true) {
     return { success: true, data: value.data };
   }
   if (value.success === false) {
     const error = value.error;
-    if (!isRecord3(error) || typeof error.code !== "string" || typeof error.message !== "string") {
+    if (!isRecord4(error) || typeof error.code !== "string" || typeof error.message !== "string") {
       return { success: false, error: { code: "sdk:http-error", message: "Request failed", details: error } };
     }
     const fieldErrorsRaw = error.fieldErrors;
@@ -36572,7 +37240,7 @@ function createListCommand(config2) {
 }
 
 // src/cli/push-config.ts
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null;
 }
 function parseErrorDetails(value) {
@@ -36580,10 +37248,10 @@ function parseErrorDetails(value) {
   if (typeof value === "string") {
     return { message: value };
   }
-  if (!isRecord4(value)) return {};
+  if (!isRecord5(value)) return {};
   const message = typeof value.message === "string" ? value.message : void 0;
   const fieldErrorsRaw = value.fieldErrors;
-  const fieldErrors = Array.isArray(fieldErrorsRaw) ? fieldErrorsRaw.filter(isRecord4).map((d) => ({
+  const fieldErrors = Array.isArray(fieldErrorsRaw) ? fieldErrorsRaw.filter(isRecord5).map((d) => ({
     field: typeof d.field === "string" ? d.field : "",
     message: typeof d.message === "string" ? d.message : ""
   })).filter((d) => d.field.length > 0 && d.message.length > 0) : void 0;
@@ -36595,12 +37263,12 @@ function formatFieldErrors(fieldErrors) {
 }
 function getDashboardErrorMessage(responseJson, fallback) {
   if (!responseJson) return fallback;
-  if (isRecord4(responseJson) && responseJson.success === false && "error" in responseJson) {
+  if (isRecord5(responseJson) && responseJson.success === false && "error" in responseJson) {
     const parsed = parseErrorDetails(responseJson.error);
     const msg = parsed.message ?? fallback;
     return msg + formatFieldErrors(parsed.fieldErrors);
   }
-  if (isRecord4(responseJson) && "error" in responseJson) {
+  if (isRecord5(responseJson) && "error" in responseJson) {
     const parsed = parseErrorDetails(responseJson.error);
     const msg = parsed.message ?? fallback;
     return msg + formatFieldErrors(parsed.fieldErrors);
@@ -36952,7 +37620,7 @@ function convertPulledFooterToLocal(remoteFooter) {
 
 // src/cli/media/portable.ts
 var ENV_SPECIFIC_MEDIA_KEYS = ["assetId", "storagePath", "storageBucket"];
-var isRecord5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isMediaObject = (value) => value.type === "image" || value.type === "video";
 function stripEnvSpecificMediaFieldsInPlace(value) {
   if (value === null || value === void 0) return;
@@ -36962,7 +37630,7 @@ function stripEnvSpecificMediaFieldsInPlace(value) {
     }
     return;
   }
-  if (!isRecord5(value)) return;
+  if (!isRecord6(value)) return;
   if (isMediaObject(value)) {
     const hasCmsRef = typeof value.identifier === "string" || typeof value.assetId === "string" || typeof value.storagePath === "string" || typeof value.storageBucket === "string";
     for (const key of ENV_SPECIFIC_MEDIA_KEYS) {
@@ -36973,7 +37641,7 @@ function stripEnvSpecificMediaFieldsInPlace(value) {
     }
     delete value.mimeType;
   }
-  if (value.type === "image" && isRecord5(value.attrs)) {
+  if (value.type === "image" && isRecord6(value.attrs)) {
     const attrs = value.attrs;
     const hasIdentifier = typeof attrs.identifier === "string" && attrs.identifier.trim().length > 0;
     if (hasIdentifier) {
@@ -38339,9 +39007,9 @@ async function localMediaFileExists(filePath) {
 }
 
 // src/cli/media/identifiers.ts
-var isRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isMediaValue = (value) => {
-  if (!isRecord6(value)) return false;
+  if (!isRecord7(value)) return false;
   const type = value.type;
   if (type !== "image" && type !== "video" && type !== "audio" && type !== "document" && type !== "spreadsheet" && type !== "archive") return false;
   return typeof value.identifier === "string" || typeof value.assetId === "string" || typeof value.storagePath === "string" || typeof value.src === "string";
@@ -38356,7 +39024,7 @@ var walkMediaValues = (value, location2, handler) => {
     });
     return;
   }
-  if (isRecord6(value)) {
+  if (isRecord7(value)) {
     Object.entries(value).forEach(([key, entry]) => {
       walkMediaValues(entry, location2 ? `${location2}.${key}` : key, handler);
     });
@@ -38464,7 +39132,7 @@ var normalizeMediaValueToIdentifierOnly = (value, identifier, asset) => {
 };
 
 // src/cli/media/rich-text.ts
-var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord8 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function collectRichTextImageAttrs(value, out = [], location2 = "") {
   if (Array.isArray(value)) {
     value.forEach(
@@ -38472,8 +39140,8 @@ function collectRichTextImageAttrs(value, out = [], location2 = "") {
     );
     return out;
   }
-  if (!isRecord7(value)) return out;
-  if (value.type === "image" && isRecord7(value.attrs)) {
+  if (!isRecord8(value)) return out;
+  if (value.type === "image" && isRecord8(value.attrs)) {
     out.push({ attrs: value.attrs, location: location2 ? `${location2}.attrs` : "attrs" });
   }
   for (const [key, child] of Object.entries(value)) {
@@ -42617,11 +43285,11 @@ function normalizeLocalContentShape(content) {
 function nullishToNull(value) {
   return value == null ? null : value;
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function normalizeVenueAddress(value) {
-  const obj = isRecord8(value) ? value : {};
+  const obj = isRecord9(value) ? value : {};
   return {
     line1: nullishToNull(typeof obj.line1 === "string" ? obj.line1 : void 0),
     line2: nullishToNull(typeof obj.line2 === "string" ? obj.line2 : void 0),
@@ -42638,7 +43306,7 @@ function normalizeVenueAddress(value) {
   };
 }
 function normalizeVenueLocation(value) {
-  if (!isRecord8(value)) return null;
+  if (!isRecord9(value)) return null;
   const obj = value;
   const lat = typeof obj.lat === "number" ? obj.lat : null;
   const lng = typeof obj.lng === "number" ? obj.lng : null;
@@ -42646,7 +43314,7 @@ function normalizeVenueLocation(value) {
   return { lat, lng };
 }
 function normalizeVenueForCompare(venue) {
-  const obj = isRecord8(venue) ? venue : {};
+  const obj = isRecord9(venue) ? venue : {};
   return {
     slug: String(obj.slug),
     title: String(obj.title),
@@ -42659,7 +43327,7 @@ function normalizeVenueForCompare(venue) {
   };
 }
 function normalizeEventCategoryForCompare(category) {
-  const obj = isRecord8(category) ? category : {};
+  const obj = isRecord9(category) ? category : {};
   return {
     identifier: String(obj.identifier),
     name: String(obj.name),
@@ -42669,9 +43337,9 @@ function normalizeEventCategoryForCompare(category) {
   };
 }
 function normalizeRemoteEventForCompare(event) {
-  const obj = isRecord8(event) ? event : {};
-  const schedule = isRecord8(obj.schedule) ? obj.schedule : {};
-  const pricing = isRecord8(obj.pricing) ? obj.pricing : {};
+  const obj = isRecord9(event) ? event : {};
+  const schedule = isRecord9(obj.schedule) ? obj.schedule : {};
+  const pricing = isRecord9(obj.pricing) ? obj.pricing : {};
   return {
     identifier: String(obj.identifier),
     title: String(obj.title),
@@ -42704,14 +43372,14 @@ function normalizeRemoteEventForCompare(event) {
     venueRef: nullishToNull(typeof obj.venueRef === "string" ? obj.venueRef : void 0),
     categoryRef: nullishToNull(typeof obj.categoryRef === "string" ? obj.categoryRef : void 0),
     formRef: nullishToNull(typeof obj.formRef === "string" ? obj.formRef : void 0),
-    content: isRecord8(obj.content) ? obj.content : {},
-    settings: isRecord8(obj.settings) ? obj.settings : {},
-    presentation: isRecord8(obj.presentation) ? obj.presentation : null,
+    content: isRecord9(obj.content) ? obj.content : {},
+    settings: isRecord9(obj.settings) ? obj.settings : {},
+    presentation: isRecord9(obj.presentation) ? obj.presentation : null,
     tags: Array.isArray(obj.tags) ? obj.tags : []
   };
 }
 function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
-  const local = isRecord8(localEvent) ? localEvent : {};
+  const local = isRecord9(localEvent) ? localEvent : {};
   const base = remoteEvent ? normalizeRemoteEventForCompare(remoteEvent) : normalizeRemoteEventForCompare({
     identifier: local.identifier,
     title: local.title,
@@ -42729,8 +43397,8 @@ function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
     presentation: local.presentation ?? null,
     tags: local.tags ?? []
   });
-  const schedule = isRecord8(local.schedule) ? local.schedule : {};
-  const pricing = isRecord8(local.pricing) ? local.pricing : {};
+  const schedule = isRecord9(local.schedule) ? local.schedule : {};
+  const pricing = isRecord9(local.pricing) ? local.pricing : {};
   return {
     ...base,
     identifier: String(local.identifier ?? base.identifier),
@@ -42756,9 +43424,9 @@ function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
     venueRef: local.venueRef === void 0 ? base.venueRef : nullishToNull(typeof local.venueRef === "string" ? local.venueRef : void 0),
     categoryRef: local.categoryRef === void 0 ? base.categoryRef : nullishToNull(typeof local.categoryRef === "string" ? local.categoryRef : void 0),
     formRef: local.formRef === void 0 ? base.formRef : nullishToNull(typeof local.formRef === "string" ? local.formRef : void 0),
-    content: local.content === void 0 ? base.content : isRecord8(local.content) ? local.content : {},
-    settings: local.settings === void 0 ? base.settings : isRecord8(local.settings) ? local.settings : {},
-    presentation: local.presentation === void 0 ? base.presentation : isRecord8(local.presentation) ? local.presentation : null,
+    content: local.content === void 0 ? base.content : isRecord9(local.content) ? local.content : {},
+    settings: local.settings === void 0 ? base.settings : isRecord9(local.settings) ? local.settings : {},
+    presentation: local.presentation === void 0 ? base.presentation : isRecord9(local.presentation) ? local.presentation : null,
     tags: local.tags === void 0 ? base.tags : Array.isArray(local.tags) ? local.tags : []
   };
 }
@@ -42770,7 +43438,7 @@ function toIsoStringOrOriginal(value) {
 function normalizeCourseSessions(value) {
   if (!Array.isArray(value)) return [];
   return value.map((session) => {
-    const obj = isRecord8(session) ? session : {};
+    const obj = isRecord9(session) ? session : {};
     return {
       startsAt: toIsoStringOrOriginal(obj.startsAt),
       endsAt: toIsoStringOrOriginal(obj.endsAt)
@@ -42782,18 +43450,18 @@ function normalizeCourseSessions(value) {
 }
 function normalizeCourseProgram(value) {
   if (value == null) return null;
-  if (!isRecord8(value)) {
+  if (!isRecord9(value)) {
     return { identifier: null, data: {} };
   }
   return {
     identifier: nullishToNull(
       typeof value.identifier === "string" ? value.identifier : void 0
     ),
-    data: isRecord8(value.data) ? value.data : {}
+    data: isRecord9(value.data) ? value.data : {}
   };
 }
 function normalizeRemoteCourseForCompare(course) {
-  const obj = isRecord8(course) ? course : {};
+  const obj = isRecord9(course) ? course : {};
   return {
     identifier: String(obj.identifier),
     title: String(obj.title),
@@ -42816,7 +43484,7 @@ function normalizeRemoteCourseForCompare(course) {
   };
 }
 function normalizeLocalCourseAgainstRemoteForCompare(localCourse, remoteCourse) {
-  const local = isRecord8(localCourse) ? localCourse : {};
+  const local = isRecord9(localCourse) ? localCourse : {};
   const base = remoteCourse ? normalizeRemoteCourseForCompare(remoteCourse) : normalizeRemoteCourseForCompare({
     identifier: local.identifier,
     title: local.title,
@@ -42837,11 +43505,11 @@ function normalizeLocalCourseAgainstRemoteForCompare(localCourse, remoteCourse)
   });
   const status = local.status === void 0 ? base.status : local.status === "active" || local.status === "cancelled" || local.status === "completed" ? local.status : "draft";
   const visibility = local.visibility === void 0 ? base.visibility : local.visibility === "public" || local.visibility === "private" || local.visibility === "unlisted" ? local.visibility : "public";
-  const program2 = local.program === void 0 ? base.program : local.program === null ? null : isRecord8(local.program) ? {
+  const program2 = local.program === void 0 ? base.program : local.program === null ? null : isRecord9(local.program) ? {
     identifier: local.program.identifier === void 0 ? base.program?.identifier ?? null : nullishToNull(
       typeof local.program.identifier === "string" ? local.program.identifier : void 0
     ),
-    data: isRecord8(local.program.data) ? local.program.data : base.program?.data ?? {}
+    data: isRecord9(local.program.data) ? local.program.data : base.program?.data ?? {}
   } : base.program;
   return {
     ...base,
@@ -45783,7 +46451,7 @@ var THEME_FIELD_CATEGORY_MAP = {
 };
 
 // src/cli/init-docs/zod-to-markdown.ts
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isZodTypeAny(value) {
@@ -45909,7 +46577,7 @@ function extractLiteralValue(schema) {
   const typeName = getTypeName(schema);
   if (typeName !== ZodTypeName.ZodLiteral) return void 0;
   const def = schema._def;
-  if (!isRecord9(def)) return void 0;
+  if (!isRecord10(def)) return void 0;
   return String(def.value);
 }
 function extractSchemaInfo(schema, skipFields = []) {
@@ -45979,7 +46647,7 @@ function extractFieldInfo(name, schema) {
   }
   if (typeName === ZodTypeName.ZodRecord) {
     const def = inner._def;
-    const valueSchema = isRecord9(def) ? def.valueType : void 0;
+    const valueSchema = isRecord10(def) ? def.valueType : void 0;
     if (!isZodTypeAny(valueSchema)) {
       info.recordValueType = "unknown";
       return info;
@@ -45994,7 +46662,7 @@ function extractFieldInfo(name, schema) {
       }
     } else if (getTypeName(valueInner) === ZodTypeName.ZodRecord) {
       const nestedDef = valueInner._def;
-      const nestedValueSchema = isRecord9(nestedDef) ? nestedDef.valueType : void 0;
+      const nestedValueSchema = isRecord10(nestedDef) ? nestedDef.valueType : void 0;
       if (!isZodTypeAny(nestedValueSchema)) {
         info.recordValueType = "record<string, unknown>";
         return info;
@@ -46005,7 +46673,7 @@ function extractFieldInfo(name, schema) {
   }
   if (typeName === ZodTypeName.ZodUnion || typeName === ZodTypeName.ZodDiscriminatedUnion) {
     const def = inner._def;
-    const optionsValue = isRecord9(def) ? def.options : void 0;
+    const optionsValue = isRecord10(def) ? def.options : void 0;
     const options = Array.isArray(optionsValue) ? optionsValue.filter(isZodTypeAny) : [];
     const optionTypes = options.map((opt) => {
       const { inner: optInner } = unwrapSchema(opt);
@@ -47165,7 +47833,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.62.2";
+var SDK_VERSION = "0.62.4";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {