@riverbankcms/sdk 0.80.0 → 0.81.0

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/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`. */