@riverbankcms/sdk 0.80.0 → 0.82.0

package/dist/_dts/theme-core/src/site-styles/generatedSchemas.d.ts

@@ -5,8 +5,8 @@ export declare const generatedContentFrameIntentSchema: z.ZodDiscriminatedUnion<
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"panel">;
     treatment: z.ZodEnum<{
-        inset: "inset";
         raised: "raised";
+        inset: "inset";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"flush-panel">;
@@ -32,7 +32,8 @@ export declare const generatedSiteStyleIdSchema: z.ZodPipe<z.ZodEnum<{
     "site-style:clarity-zen-blue": "site-style:clarity-zen-blue";
     "site-style:bold-launch": "site-style:bold-launch";
     "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+    "site-style:original-joy": "site-style:original-joy";
+}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:original-joy">>;
 export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
     sectionSurface: z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"generated">;
@@ -59,8 +60,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"panel">;
             treatment: z.ZodEnum<{
-                inset: "inset";
                 raised: "raised";
+                inset: "inset";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"flush-panel">;
@@ -82,10 +83,11 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
             flat: "flat";
             none: "none";
             default: "default";
-            inset: "inset";
             editorial: "editorial";
             raised: "raised";
+            "color-blocked": "color-blocked";
             outlined: "outlined";
+            inset: "inset";
         }>;
     }, z.core.$strict>], "kind">;
     transitionAfter: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -108,8 +110,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         kind: z.ZodLiteral<"explicit">;
         value: z.ZodEnum<{
             medium: "medium";
-            high: "high";
             low: "low";
+            high: "high";
         }>;
     }, z.core.$strict>], "kind">;
 }, z.core.$strict>;
@@ -178,7 +180,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
         "site-style:clarity-zen-blue": "site-style:clarity-zen-blue";
         "site-style:bold-launch": "site-style:bold-launch";
         "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+        "site-style:original-joy": "site-style:original-joy";
+    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:original-joy">>;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         blockKind: z.ZodString;
@@ -209,8 +212,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"panel">;
                     treatment: z.ZodEnum<{
-                        inset: "inset";
                         raised: "raised";
+                        inset: "inset";
                     }>;
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"flush-panel">;
@@ -232,10 +235,11 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                     flat: "flat";
                     none: "none";
                     default: "default";
-                    inset: "inset";
                     editorial: "editorial";
                     raised: "raised";
+                    "color-blocked": "color-blocked";
                     outlined: "outlined";
+                    inset: "inset";
                 }>;
             }, z.core.$strict>], "kind">;
             transitionAfter: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -258,8 +262,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"explicit">;
                 value: z.ZodEnum<{
                     medium: "medium";
-                    high: "high";
                     low: "low";
+                    high: "high";
                 }>;
             }, z.core.$strict>], "kind">;
         }, z.core.$strict>;

package/dist/_dts/theme-core/src/site-styles/headerLooks.d.ts

@@ -136,6 +136,11 @@ export type HeaderConfigurationResolution = Readonly<{
 }>;
 export type HeaderLookOpeningRequirement = 'none' | 'reserved-space-ok' | 'requires-image-hero-with-contrast-overlay';
 export type HeaderLogoShape = 'none' | 'text-only' | 'horizontal' | 'square' | 'tall';
+export type HeaderLogoDimensions = Readonly<{
+    width: number | null;
+    height: number | null;
+}>;
+export declare function deriveHeaderLogoShapeFromDimensions({ width, height, }: HeaderLogoDimensions): HeaderLogoShape;
 export type HeaderStyleNavTypography = 'plain' | 'heading' | 'quiet-caps' | 'brand-caps';
 export type HeaderLookDefinition = Readonly<{
     id: HeaderLookId;

package/dist/_dts/theme-core/src/site-styles/index.d.ts

@@ -1,6 +1,7 @@
 export * from './accessibleSurfaces';
 export * from './appearancePresets';
 export * from './blockFlow';
+export * from './backgroundAppearance';
 export * from './compositionBudget';
 export * from './contentTemplateDesignIntent';
 export * from './contentTemplateRuntimeCompiler';
@@ -25,6 +26,8 @@ export * from './rawStyleFields';
 export * from './records';
 export * from './resolver';
 export * from './runtimeCompiler';
+export * from './sectionTransitions';
+export * from './siteChromeBackgrounds';
 export * from './siteStyleThemeCompiler';
 export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';

package/dist/_dts/theme-core/src/site-styles/logoBranding.d.ts

@@ -42,16 +42,16 @@ export declare const logoContainsTextSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     kind: z.ZodLiteral<"contains-text">;
     confidence: z.ZodEnum<{
         medium: "medium";
-        high: "high";
         low: "low";
+        high: "high";
     }>;
     text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"no-text">;
     confidence: z.ZodEnum<{
         medium: "medium";
-        high: "high";
         low: "low";
+        high: "high";
     }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"unknown">;
@@ -88,16 +88,16 @@ export declare const logoFactsSchema: z.ZodObject<{
         kind: z.ZodLiteral<"contains-text">;
         confidence: z.ZodEnum<{
             medium: "medium";
-            high: "high";
             low: "low";
+            high: "high";
         }>;
         text: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"no-text">;
         confidence: z.ZodEnum<{
             medium: "medium";
-            high: "high";
             low: "low";
+            high: "high";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"unknown">;

package/dist/_dts/theme-core/src/site-styles/pageDesignEditorModel.d.ts

@@ -1,7 +1,9 @@
 import type { BlockAppearanceDesign, BlockAppearanceOptionGroup } from './appearancePresets';
 import type { BlockDesignMetadata, BlockLayoutDesignProfile } from './blockFlow';
 import { type PageDesignIntent } from './pageDesignIntent';
-import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId, type SiteStyleSectionTransitionIntent } from './types';
+import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId } from './types';
+import { type BoundaryOption } from './sectionTransitions';
+export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
 export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
 export type PageFlowPreset = Readonly<{
     id: PageFlowPresetId;
@@ -9,11 +11,6 @@ export type PageFlowPreset = Readonly<{
     boundaryStrategy: PageFlowBoundaryStrategy;
     defaultBoundaryOptionId: BoundaryOptionId;
 }>;
-export type BoundaryOption = Readonly<{
-    id: BoundaryOptionId;
-    label: string;
-    transitionAfter: SiteStyleSectionTransitionIntent;
-}>;
 export type PageDesignEditorBlockInput<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     blockId: TBlockId;
     blockKind: string;
@@ -125,23 +122,6 @@ export type PageDesignEditorReadModel<TBlockId extends DesignBlockId = DesignBlo
     boundaries: readonly PageDesignEditorBoundary<TBlockId>[];
     issues: readonly PageDesignEditorIssue<TBlockId>[];
 }>;
-export declare const boundaryOptions: readonly [{
-    readonly id: BoundaryOptionId;
-    readonly label: "None";
-    readonly transitionAfter: "none";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Soft";
-    readonly transitionAfter: "soft-fade-short";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Wave";
-    readonly transitionAfter: "wave-edge";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Spacious";
-    readonly transitionAfter: "soft-fade-long";
-}];
 /**
  * Must remain non-empty; downstream code indexes `[0]` as the documented default.
  */

package/dist/_dts/theme-core/src/site-styles/pageDesignIntent.d.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type PageFlowPresetId, type SiteStyleId } from './types';
 import { type SchemaVersionedJsonParseIssue } from './schemaVersionedJson';
-export declare const pageDesignIntentSchemaVersion = 1;
+import { type SectionBoundaryTreatment } from './sectionTransitions';
+export declare const pageDesignIntentSchemaVersion = 2;
+export declare const legacyPageDesignIntentSchemaVersion = 1;
 export type PageDesignAutoChoice = Readonly<{
     kind: 'auto';
 }>;
@@ -16,11 +18,24 @@ export type PageDesignBlockLookPin<TBlockId extends DesignBlockId = DesignBlockI
     choice: PageDesignUserPinnedChoice<AppearancePresetId>;
 }>;
 export type PageDesignBoundaryPin<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
+    boundaryId: DesignBoundaryId;
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    choice: PageDesignUserPinnedChoice<SectionBoundaryTreatment>;
+}>;
+export type LegacyPageDesignBoundaryPin<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     boundaryId: DesignBoundaryId;
     previousBlockId: TBlockId;
     nextBlockId: TBlockId;
     choice: PageDesignUserPinnedChoice<BoundaryOptionId>;
 }>;
+export type LegacyPageDesignIntent<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
+    schemaVersion: typeof legacyPageDesignIntentSchemaVersion;
+    siteStyleId: SiteStyleId;
+    pageFlowPresetId: PageFlowPresetId;
+    blockLookPins: readonly PageDesignBlockLookPin<TBlockId>[];
+    boundaryPins: readonly LegacyPageDesignBoundaryPin<TBlockId>[];
+}>;
 export type PageDesignIntent<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     schemaVersion: typeof pageDesignIntentSchemaVersion;
     siteStyleId: SiteStyleId;
@@ -63,7 +78,7 @@ export type PageDesignUserAction<TBlockId extends DesignBlockId = DesignBlockId>
     kind: 'set-boundary';
     previousBlockId: TBlockId;
     nextBlockId: TBlockId;
-    choice: PageDesignChoice<BoundaryOptionId>;
+    choice: PageDesignChoice<SectionBoundaryTreatment>;
 }>;
 export type PageDesignIntentIssueFeedback = 'debug' | 'user-facing';
 export type PageDesignIntentIssue<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
@@ -122,6 +137,121 @@ export declare const pageDesignUserPinnedBoundaryChoiceSchema: z.ZodObject<{
     kind: z.ZodLiteral<"user-pinned">;
     value: z.ZodPipe<z.ZodString, z.ZodTransform<BoundaryOptionId, string>>;
 }, z.core.$strict>;
+export declare const pageDesignBoundaryTreatmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"none">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"soft-fade">;
+    height: z.ZodEnum<{
+        medium: "medium";
+        compact: "compact";
+        large: "large";
+        expansive: "expansive";
+    }>;
+    curve: z.ZodEnum<{
+        spacious: "spacious";
+        soft: "soft";
+        expansive: "expansive";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"wave-edge">;
+    height: z.ZodEnum<{
+        medium: "medium";
+        compact: "compact";
+        large: "large";
+    }>;
+    amplitude: z.ZodEnum<{
+        bold: "bold";
+        subtle: "subtle";
+        balanced: "balanced";
+    }>;
+    rhythm: z.ZodEnum<{
+        single: "single";
+        double: "double";
+    }>;
+    symmetry: z.ZodEnum<{
+        symmetrical: "symmetrical";
+        asymmetrical: "asymmetrical";
+        drift: "drift";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"angle-edge">;
+    height: z.ZodEnum<{
+        medium: "medium";
+        compact: "compact";
+        large: "large";
+    }>;
+    slope: z.ZodEnum<{
+        subtle: "subtle";
+        balanced: "balanced";
+        steep: "steep";
+    }>;
+    direction: z.ZodEnum<{
+        reverse: "reverse";
+        forward: "forward";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"legacy-unsupported">;
+    boundaryOptionId: z.ZodPipe<z.ZodString, z.ZodTransform<BoundaryOptionId, string>>;
+}, z.core.$strict>], "kind">;
+export declare const pageDesignUserPinnedBoundaryTreatmentChoiceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"user-pinned">;
+    value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"soft-fade">;
+        height: z.ZodEnum<{
+            medium: "medium";
+            compact: "compact";
+            large: "large";
+            expansive: "expansive";
+        }>;
+        curve: z.ZodEnum<{
+            spacious: "spacious";
+            soft: "soft";
+            expansive: "expansive";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"wave-edge">;
+        height: z.ZodEnum<{
+            medium: "medium";
+            compact: "compact";
+            large: "large";
+        }>;
+        amplitude: z.ZodEnum<{
+            bold: "bold";
+            subtle: "subtle";
+            balanced: "balanced";
+        }>;
+        rhythm: z.ZodEnum<{
+            single: "single";
+            double: "double";
+        }>;
+        symmetry: z.ZodEnum<{
+            symmetrical: "symmetrical";
+            asymmetrical: "asymmetrical";
+            drift: "drift";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"angle-edge">;
+        height: z.ZodEnum<{
+            medium: "medium";
+            compact: "compact";
+            large: "large";
+        }>;
+        slope: z.ZodEnum<{
+            subtle: "subtle";
+            balanced: "balanced";
+            steep: "steep";
+        }>;
+        direction: z.ZodEnum<{
+            reverse: "reverse";
+            forward: "forward";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"legacy-unsupported">;
+        boundaryOptionId: z.ZodPipe<z.ZodString, z.ZodTransform<BoundaryOptionId, string>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
 export declare const pageDesignBlockLookPinSchema: z.ZodObject<{
     blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
     blockKind: z.ZodString;
@@ -131,6 +261,70 @@ export declare const pageDesignBlockLookPinSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const pageDesignBoundaryPinSchema: z.ZodObject<{
+    boundaryId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBoundaryId, string>>;
+    previousBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
+    nextBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
+    choice: z.ZodObject<{
+        kind: z.ZodLiteral<"user-pinned">;
+        value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"soft-fade">;
+            height: z.ZodEnum<{
+                medium: "medium";
+                compact: "compact";
+                large: "large";
+                expansive: "expansive";
+            }>;
+            curve: z.ZodEnum<{
+                spacious: "spacious";
+                soft: "soft";
+                expansive: "expansive";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"wave-edge">;
+            height: z.ZodEnum<{
+                medium: "medium";
+                compact: "compact";
+                large: "large";
+            }>;
+            amplitude: z.ZodEnum<{
+                bold: "bold";
+                subtle: "subtle";
+                balanced: "balanced";
+            }>;
+            rhythm: z.ZodEnum<{
+                single: "single";
+                double: "double";
+            }>;
+            symmetry: z.ZodEnum<{
+                symmetrical: "symmetrical";
+                asymmetrical: "asymmetrical";
+                drift: "drift";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"angle-edge">;
+            height: z.ZodEnum<{
+                medium: "medium";
+                compact: "compact";
+                large: "large";
+            }>;
+            slope: z.ZodEnum<{
+                subtle: "subtle";
+                balanced: "balanced";
+                steep: "steep";
+            }>;
+            direction: z.ZodEnum<{
+                reverse: "reverse";
+                forward: "forward";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"legacy-unsupported">;
+            boundaryOptionId: z.ZodPipe<z.ZodString, z.ZodTransform<BoundaryOptionId, string>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const legacyPageDesignBoundaryPinSchema: z.ZodObject<{
     boundaryId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBoundaryId, string>>;
     previousBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
     nextBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
@@ -166,12 +360,90 @@ export declare const pageDesignIntentV1Schema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export declare const pageDesignIntentV2Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
+    pageFlowPresetId: z.ZodPipe<z.ZodString, z.ZodTransform<PageFlowPresetId, string>>;
+    blockLookPins: z.ZodArray<z.ZodObject<{
+        blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
+        blockKind: z.ZodString;
+        choice: z.ZodObject<{
+            kind: z.ZodLiteral<"user-pinned">;
+            value: z.ZodPipe<z.ZodString, z.ZodTransform<AppearancePresetId, string>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    boundaryPins: z.ZodArray<z.ZodObject<{
+        boundaryId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBoundaryId, string>>;
+        previousBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
+        nextBlockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
+        choice: z.ZodObject<{
+            kind: z.ZodLiteral<"user-pinned">;
+            value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"none">;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"soft-fade">;
+                height: z.ZodEnum<{
+                    medium: "medium";
+                    compact: "compact";
+                    large: "large";
+                    expansive: "expansive";
+                }>;
+                curve: z.ZodEnum<{
+                    spacious: "spacious";
+                    soft: "soft";
+                    expansive: "expansive";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"wave-edge">;
+                height: z.ZodEnum<{
+                    medium: "medium";
+                    compact: "compact";
+                    large: "large";
+                }>;
+                amplitude: z.ZodEnum<{
+                    bold: "bold";
+                    subtle: "subtle";
+                    balanced: "balanced";
+                }>;
+                rhythm: z.ZodEnum<{
+                    single: "single";
+                    double: "double";
+                }>;
+                symmetry: z.ZodEnum<{
+                    symmetrical: "symmetrical";
+                    asymmetrical: "asymmetrical";
+                    drift: "drift";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"angle-edge">;
+                height: z.ZodEnum<{
+                    medium: "medium";
+                    compact: "compact";
+                    large: "large";
+                }>;
+                slope: z.ZodEnum<{
+                    subtle: "subtle";
+                    balanced: "balanced";
+                    steep: "steep";
+                }>;
+                direction: z.ZodEnum<{
+                    reverse: "reverse";
+                    forward: "forward";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"legacy-unsupported">;
+                boundaryOptionId: z.ZodPipe<z.ZodString, z.ZodTransform<BoundaryOptionId, string>>;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare function parsePageDesignIntent(value: unknown, options?: ParsePageDesignIntentOptions): PageDesignIntentParseResult;
+export declare function normalizeLegacyPageDesignIntent<TBlockId extends DesignBlockId>(intent: LegacyPageDesignIntent<TBlockId>): PageDesignIntent<TBlockId>;
 export declare function autoDesignChoice(): PageDesignAutoChoice;
 export declare function userPinnedDesignChoice<TValue>(value: TValue): PageDesignUserPinnedChoice<TValue>;
 export declare function resolvePageDesignBlockLookChoice<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, blockId: TBlockId): PageDesignChoice<AppearancePresetId>;
-export declare function resolvePageDesignBoundaryChoice<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, previousBlockId: TBlockId, nextBlockId: TBlockId): PageDesignChoice<BoundaryOptionId>;
-export declare function buildBoundaryPin<TBlockId extends DesignBlockId>(previousBlockId: TBlockId, nextBlockId: TBlockId, choice: PageDesignUserPinnedChoice<BoundaryOptionId>): PageDesignBoundaryPin<TBlockId>;
+export declare function resolvePageDesignBoundaryChoice<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, previousBlockId: TBlockId, nextBlockId: TBlockId): PageDesignChoice<SectionBoundaryTreatment>;
+export declare function buildBoundaryPin<TBlockId extends DesignBlockId>(previousBlockId: TBlockId, nextBlockId: TBlockId, choice: PageDesignUserPinnedChoice<SectionBoundaryTreatment>): PageDesignBoundaryPin<TBlockId>;
 export declare function reducePageDesignIntentForStructureEvent<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, event: PageDesignStructureEvent<TBlockId>): PageDesignIntentUpdate<TBlockId>;
 export declare function reducePageDesignIntentForUserAction<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, action: PageDesignUserAction<TBlockId>): PageDesignIntent<TBlockId>;
 export declare function remapPageDesignIntentForDuplicate<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, input: Readonly<{

package/dist/_dts/theme-core/src/site-styles/rawStyleFields.d.ts

@@ -8,5 +8,7 @@ export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameSty
 export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare const pageDesignEditorBackgroundOverrideOwner: "page-design-editor";
 export type PageDesignEditorBackgroundOverrideOwner = typeof pageDesignEditorBackgroundOverrideOwner;
+export declare const siteChromeBackgroundOverrideOwner: "site-chrome-editor";
+export type SiteChromeBackgroundOverrideOwner = typeof siteChromeBackgroundOverrideOwner;
 export declare function isThemeV2NormalEditorRawStyleFieldName(fieldName: string): boolean;
 export declare function isThemeV2NormalEditorRawStylePath(fieldPath: string): boolean;

package/dist/_dts/theme-core/src/site-styles/runtimeCompiler.d.ts

@@ -26,6 +26,7 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _contentCardStyles?: ContainerStylesOverride;
     _heroLayoutStyles?: HeroLayoutStylesOverride;
     _cardStyles?: CardStylesOverride;
+    blockLook?: string;
     styleGroup?: string;
 }>;
 export type HeroLayoutStylesOverride = Readonly<{
@@ -34,7 +35,7 @@ export type HeroLayoutStylesOverride = Readonly<{
     contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
     typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "styleGroup"];
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "blockLook", "styleGroup"];
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;
@@ -54,6 +55,11 @@ export type CompileBlockRuntimeInput<TBlockId extends string, TPurpose extends s
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
+    sectionAdjacency?: SectionAdjacency;
+    /**
+     * @deprecated Prefer `sectionAdjacency`. Kept for isolated block callers that
+     * compile one block with an explicit following section surface.
+     */
     nextSectionSurface?: SiteStyleSurfaceIntent;
 }>;
 export type CompileBlockRuntimeIntoContentInput<TBlockId extends string, TPurpose extends string, TContent extends Record<string, unknown>> = CompileBlockRuntimeInput<TBlockId, TPurpose> & Readonly<{
@@ -65,6 +71,18 @@ export type CompiledPageRuntime<TBlockId extends string = string> = Readonly<{
         blockId: TBlockId;
     }>)[];
 }>;
+export type SectionAdjacency = Readonly<{
+    kind: 'next-section';
+    surface: SiteStyleSurfaceIntent;
+}> | Readonly<{
+    kind: 'terminal-surface';
+    surface: SiteStyleSurfaceIntent;
+}> | Readonly<{
+    kind: 'page-end';
+}>;
+export type TerminalSectionAdjacency = Extract<SectionAdjacency, Readonly<{
+    kind: 'terminal-surface' | 'page-end';
+}>>;
 export declare function defineDesignRuntimeRules<const TRules extends DesignRuntimeRules>(rules: TRules): TRules;
 export declare function defineComponentRuntimeRules<const TRules extends ComponentRuntimeRules>(rules: TRules): TRules;
 /**
@@ -94,11 +112,13 @@ export declare const defaultDesignRuntimeRules: {
         };
         readonly 'hero-image': {
             readonly background: {
+                readonly textColor?: string | null | undefined;
+                readonly headingColor?: string | null | undefined;
+                readonly linkColor?: string | null | undefined;
+                readonly supportingColor?: string | null | undefined;
                 readonly type: "image";
                 readonly opacity: 1;
                 readonly position: "center center";
-                readonly textColor: "text";
-                readonly headingColor: "text";
             };
         };
     };
@@ -211,6 +231,15 @@ export declare const defaultComponentRuntimeRules: {
                 readonly enabled: false;
             };
         };
+        readonly 'color-blocked': {
+            readonly treatment: "color-blocked";
+            readonly spacing: "spacious";
+            readonly rounded: "2xl";
+            readonly raised: false;
+            readonly border: {
+                readonly enabled: false;
+            };
+        };
     };
 };
 /** Compiles one resolved semantic block plan into legacy block runtime fields. */
@@ -229,6 +258,7 @@ export declare function compilePageRuntimeFields<TBlockId extends string, TPurpo
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
+    terminalSectionAdjacency?: TerminalSectionAdjacency;
 }>): CompiledPageRuntime<TBlockId>;
 export type CompileTokenRecipesOptions = Readonly<{
     /** Resolved button personality ID. When provided, emits `theme.buttons`. */