@riverbankcms/sdk 0.104.3 → 0.107.0

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

@@ -203,8 +203,32 @@ export type ImageSurfaceTreatmentKind = ImageSurfaceTreatment['kind'];
 export type TestimonialCardTreatment = 'default' | 'statement' | 'non-carded' | 'accent-quote' | 'editorial-serif-quote';
 export declare const tileTreatmentValues: readonly ["default", "quiet", "brand-depth"];
 export type TileTreatment = (typeof tileTreatmentValues)[number];
-export declare const eventListTreatmentValues: readonly ["plain", "lined-panel"];
+export declare const eventListTreatmentValues: readonly ["plain", "lined-panel", "ruled-register", "editorial-register", "dense-index"];
 export type EventListTreatment = (typeof eventListTreatmentValues)[number];
+export declare const introCompositionTreatmentValues: readonly ["editorial-statement", "portrait-bio"];
+export type IntroCompositionTreatment = (typeof introCompositionTreatmentValues)[number];
+export declare const featureCardCompositionTreatmentValues: readonly ["asymmetric-emphasis", "framed-programme"];
+export type FeatureCardCompositionTreatment = (typeof featureCardCompositionTreatmentValues)[number];
+/**
+ * A closed description of structural presentation selected by a Look.
+ * Concrete spacing, radii, colour, and shadow remain site-style concerns.
+ */
+export type BlockCompositionIntent = Readonly<{
+    kind: 'intro';
+    treatment: IntroCompositionTreatment;
+}> | Readonly<{
+    kind: 'feature-cards';
+    treatment: FeatureCardCompositionTreatment;
+}>;
+export type BlockCompositionCapability = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'intro';
+    treatments: NonEmptyReadonlyArray<IntroCompositionTreatment>;
+}> | Readonly<{
+    kind: 'feature-cards';
+    treatments: NonEmptyReadonlyArray<FeatureCardCompositionTreatment>;
+}>;
 export declare const eyebrowTreatmentValues: readonly ["plain", "accent", "pill", "accent-pill", "pill-bounce", "accent-pill-bounce"];
 export type EyebrowTreatment = (typeof eyebrowTreatmentValues)[number];
 export declare const headingDecorationFamilyValues: readonly ["none", "organic-squiggle", "short-center-rule"];
@@ -397,6 +421,7 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
     accordionIconTreatment?: AccordionIconTreatment | null;
+    composition?: BlockCompositionIntent;
 }>;
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
     appliedSectionSurface: SiteStyleSurfaceIntent;
@@ -412,6 +437,7 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedEventListTreatment: EventListTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
     appliedAccordionIconTreatment: AccordionIconTreatment | null;
+    appliedComposition: BlockCompositionIntent | null;
 }>;
 export type PageDesignState<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     schemaVersion: 1;
@@ -429,7 +455,11 @@ export type HeadingDecorationCapability = Readonly<{
     families: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
 }>;
 export type DesignedBlockDesignCapabilityInput = Readonly<{
+    /** Looks are optional composition presets, not the baseline block design. */
+    looks?: 'supported';
     sectionSurfaces: 'supported' | 'unsupported';
+    /** Rich backgrounds require an explicit block-level legibility contract. */
+    richBackgrounds?: 'supported';
     contentFrames: FrameCapability;
     itemSurfaces: 'supported' | 'unsupported';
     sectionHeights?: NonEmptyReadonlyArray<SectionHeightIntent>;
@@ -442,10 +472,15 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     headingDecorations?: NonEmptyReadonlyArray<HeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
     headingDecorationCapability?: HeadingDecorationCapability;
+    compositions?: Exclude<BlockCompositionCapability, {
+        kind: 'none';
+    }>;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
     kind: 'designed';
+    looks: 'supported' | 'not-applicable';
     sectionSurfaces: 'supported' | 'unsupported';
+    richBackgrounds?: 'supported';
     contentFrames: FrameCapability;
     itemSurfaces: 'supported' | 'unsupported';
     sectionHeights: NonEmptyReadonlyArray<SectionHeightIntent>;
@@ -458,6 +493,7 @@ export type DesignedBlockDesignCapability = Readonly<{
     headingDecorations?: NonEmptyReadonlyArray<HeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
     headingDecorationCapability: HeadingDecorationCapability;
+    compositions: BlockCompositionCapability;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
 export type NoBlockDesignCapability = Readonly<{
@@ -468,7 +504,7 @@ export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesig
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
 export declare function defineBlockDesignCapability<const TCapability extends DesignedBlockDesignCapabilityInput>(capability: NoExtraKeys<TCapability, 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-tile-treatment' | 'fallback-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-accordion-icon-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-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-accordion-icon-treatment' | 'remove-composition' | '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;
@@ -592,6 +628,17 @@ export type UnsupportedAccordionIconTreatmentIssue<TBlockId extends string = Des
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-accordion-icon-treatment'];
 }>;
+export type UnsupportedBlockCompositionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
+    kind: 'unsupported-block-composition';
+    blockId: TBlockId;
+    blockKind: string;
+    purpose: TPurpose;
+    requested: BlockCompositionIntent;
+    fallback: null;
+    policy: DesignResolutionPolicy;
+    severity: DesignIssueSeverity;
+    allowedRepairActions: readonly ['remove-composition'];
+}>;
 export type ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'image-surface-treatment-without-image-surface';
     blockId: TBlockId;
@@ -643,6 +690,7 @@ export type BlockDesignCapabilityRequest = Readonly<{
     eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
     accordionIconTreatment?: AccordionIconTreatment | null;
+    composition?: BlockCompositionIntent;
 }>;
 export type BlockDesignCapabilityFallback = Readonly<{
     sectionSurface: 'base';
@@ -660,6 +708,7 @@ export type BlockDesignCapabilityFallback = Readonly<{
     eventListTreatment: 'plain';
     eyebrowTreatment: 'plain';
     accordionIconTreatment: null;
+    composition: null;
 }>;
 export type MissingBlockDesignCapabilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'missing-block-design-capability';
@@ -706,7 +755,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> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEventListTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<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> | UnsupportedEventListTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<TBlockId, TPurpose> | UnsupportedBlockCompositionIssue<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';