@riverbankcms/sdk 0.60.16 → 0.62.2

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

@@ -87,7 +87,7 @@ export type ContentVersionOwner = Readonly<{
 export type DesignResolutionPolicy = 'generated' | 'user' | 'admin' | 'sdk';
 export type DesignIssueSeverity = 'blocking' | 'repairable' | 'advisory';
 export declare function designIssueSeverityForPolicy(policy: DesignResolutionPolicy): DesignIssueSeverity;
-export type SiteStyleSurfaceIntent = 'base' | 'muted-band' | 'accent-band' | 'hero-image';
+export type SiteStyleSurfaceIntent = 'base' | 'muted-band' | 'accent-band' | 'brand-depth-band' | 'hero-image';
 export type SiteStyleItemSurfaceIntent = 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial';
 export type SiteStyleSectionTransitionIntent = 'none' | 'soft-fade-short' | 'soft-fade-long' | 'wave-edge' | 'angle-edge';
 export type SiteStyleEmphasis = 'low' | 'medium' | 'high';
@@ -188,6 +188,8 @@ export type ImageSurfaceTreatment = Readonly<{
 }>;
 export type ImageSurfaceTreatmentKind = ImageSurfaceTreatment['kind'];
 export type TestimonialCardTreatment = 'default' | 'accent-quote';
+export declare const tileTreatmentValues: readonly ["default", "quiet", "brand-depth"];
+export type TileTreatment = (typeof tileTreatmentValues)[number];
 export declare const eyebrowTreatmentValues: readonly ["plain", "pill", "accent-pill", "pill-bounce", "accent-pill-bounce"];
 export type EyebrowTreatment = (typeof eyebrowTreatmentValues)[number];
 export type GeneratedMediaCompositionIntent = Extract<MediaCompositionIntent, 'none' | 'supporting' | 'dominant'>;
@@ -342,6 +344,7 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
+    tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
 }>;
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
@@ -354,6 +357,7 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedImageSurfaceTreatment: ImageSurfaceTreatment;
     appliedImageSurfaceMotion: ImageSurfaceMotion;
     appliedTestimonialCardTreatment: TestimonialCardTreatment;
+    appliedTileTreatment: TileTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
 }>;
 export type PageDesignState<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -373,6 +377,7 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     imageSurfaceTreatments?: NonEmptyReadonlyArray<ImageSurfaceTreatmentKind>;
     imageSurfaceMotions?: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments?: NonEmptyReadonlyArray<TestimonialCardTreatment>;
+    tileTreatments?: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
@@ -384,6 +389,7 @@ export type DesignedBlockDesignCapability = Readonly<{
     imageSurfaceTreatments: NonEmptyReadonlyArray<ImageSurfaceTreatmentKind>;
     imageSurfaceMotions: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments: NonEmptyReadonlyArray<TestimonialCardTreatment>;
+    tileTreatments: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
@@ -395,7 +401,7 @@ export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesig
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
 export declare function defineBlockDesignCapability(capability: DesignedBlockDesignCapabilityInput): DesignedBlockDesignCapability;
 export declare function defineNoBlockDesignCapability(reason: UnsupportedBlockDesignCapabilityReason): NoBlockDesignCapability;
-export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-item-surface' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-testimonial-card-treatment' | 'fallback-eyebrow-treatment' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
+export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-item-surface' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-testimonial-card-treatment' | 'fallback-tile-treatment' | 'fallback-eyebrow-treatment' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
 export type UnsupportedSectionSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-section-surface';
     blockId: TBlockId;
@@ -475,6 +481,17 @@ export type UnsupportedTestimonialCardTreatmentIssue<TBlockId extends string = D
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-testimonial-card-treatment'];
 }>;
+export type UnsupportedTileTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
+    kind: 'unsupported-tile-treatment';
+    blockId: TBlockId;
+    blockKind: string;
+    purpose: TPurpose;
+    requested: TileTreatment;
+    fallback: 'default';
+    policy: DesignResolutionPolicy;
+    severity: DesignIssueSeverity;
+    allowedRepairActions: readonly ['fallback-tile-treatment'];
+}>;
 export type UnsupportedEyebrowTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-eyebrow-treatment';
     blockId: TBlockId;
@@ -531,6 +548,7 @@ export type BlockDesignCapabilityRequest = Readonly<{
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
+    tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
 }>;
 export type BlockDesignCapabilityFallback = Readonly<{
@@ -545,6 +563,7 @@ export type BlockDesignCapabilityFallback = Readonly<{
     }>;
     imageSurfaceMotion: 'static';
     testimonialCardTreatment: 'default';
+    tileTreatment: 'default';
     eyebrowTreatment: 'plain';
 }>;
 export type MissingBlockDesignCapabilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -592,7 +611,7 @@ export type HeroImageWithoutLegibilityIssue<TBlockId extends string = DesignBloc
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-hero-legibility'];
 }>;
-export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedItemSurfaceIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTestimonialCardTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | RemovedTransitionForFlushFrameIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
+export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedItemSurfaceIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTestimonialCardTreatmentIssue<TBlockId, TPurpose> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | RemovedTransitionForFlushFrameIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
 export type DesignRepairResultForIssue<TIssue extends DesignResolutionIssue<string, string>> = {
     [TKind in TIssue['kind']]: Readonly<{
         kind: TKind extends 'removed-transition-for-flush-frame' ? 'repaired' : 'fallbackApplied';

package/dist/_dts/theme-core/src/siteChrome.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from "react";
+import type { Theme } from "./schema";
+export type SiteTopShellBehavior = "normal-flow" | "shared-sticky-shell";
+export type SiteChromeLayoutNodes = Readonly<{
+    headerNode: ReactNode;
+    bannerNode?: ReactNode;
+    bannerShellBehavior?: SiteTopShellBehavior;
+    footerNode: ReactNode;
+}>;
+export declare function getStandaloneHeaderShellClassName(theme: Theme): string | null;
+export declare function renderSiteTopChrome({ headerNode, bannerNode, bannerShellBehavior, }: Pick<SiteChromeLayoutNodes, "headerNode" | "bannerNode" | "bannerShellBehavior">): ReactNode;