@riverbankcms/sdk 0.79.0 → 0.81.0

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

@@ -2,6 +2,17 @@ import type { Theme } from '../schema';
 export type Brand<T, TBrand extends string> = T & {
     readonly __brand: TBrand;
 };
+export type NoExtraKeys<TActual, TExpected> = TActual & {
+    readonly [K in Exclude<keyof TActual, keyof TExpected>]: never;
+};
+export type ExactCatalog<TEntries extends readonly unknown[], TExpected> = {
+    readonly [K in keyof TEntries]: TEntries[K] extends TExpected ? NoExtraKeys<TEntries[K], TExpected> : never;
+};
+/**
+ * Defines a literal-preserving catalog while rejecting top-level extra keys on
+ * each entry: `defineExactCatalog<Entry>()([{ ... }])`.
+ */
+export declare function defineExactCatalog<TExpected>(): <const TEntries extends readonly TExpected[]>(entries: ExactCatalog<TEntries, TExpected>) => TEntries;
 export type DesignBlockId = Brand<string, 'DesignBlockId'>;
 export type DesignPageId = Brand<string, 'DesignPageId'>;
 export type DesignEntryId = Brand<string, 'DesignEntryId'>;
@@ -88,8 +99,8 @@ 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' | '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 SiteStyleItemSurfaceIntent = 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial' | 'color-blocked';
+export type SiteStyleSectionTransitionIntent = 'none' | 'soft-fade-short' | 'soft-fade-long' | 'soft-fade-expansive' | 'wave-edge' | 'wave-edge-balanced' | 'wave-edge-gentle' | 'wave-edge-bold' | 'wave-edge-drift' | 'angle-edge' | 'angle-edge-subtle' | 'angle-edge-steep';
 export type SiteStyleEmphasis = 'low' | 'medium' | 'high';
 export type SectionHeightIntent = 'default' | 'banner' | 'hero' | 'immersive';
 export type FrameKind = 'plain' | 'panel' | 'flush-panel';
@@ -189,7 +200,7 @@ export type ImageSurfaceTreatment = Readonly<{
     intensity?: ImageSurfaceTreatmentIntensity;
 }>;
 export type ImageSurfaceTreatmentKind = ImageSurfaceTreatment['kind'];
-export type TestimonialCardTreatment = 'default' | 'accent-quote';
+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"];
@@ -200,27 +211,20 @@ export declare const headingDecorationFamilyValues: readonly ["none", "organic-s
 export type HeadingDecorationFamily = (typeof headingDecorationFamilyValues)[number];
 export type VisibleHeadingDecorationFamily = Exclude<HeadingDecorationFamily, 'none'>;
 export declare const visibleHeadingDecorationFamilyValues: readonly ["organic-squiggle", "short-center-rule"];
-export declare const headingDecorationPlacementValues: readonly ["none", "after-heading", "between-heading-and-body", "under-centered-heading"];
-export type HeadingDecorationPlacement = (typeof headingDecorationPlacementValues)[number];
-export type VisibleHeadingDecorationPlacement = Exclude<HeadingDecorationPlacement, 'none'>;
-export declare const visibleHeadingDecorationPlacementValues: readonly ["after-heading", "between-heading-and-body", "under-centered-heading"];
-export declare const headingDecorationOverrideValues: readonly ["site-default", "on", "off"];
+export declare const headingDecorationOverrideValues: readonly ["site-default", "off"];
 export type HeadingDecorationOverride = (typeof headingDecorationOverrideValues)[number];
 export declare const headingDecorationColorTokenValues: readonly ["text", "primary", "secondary", "accent", "border", "muted"];
 export type HeadingDecorationColorToken = (typeof headingDecorationColorTokenValues)[number];
 export type NoHeadingDecoration = Readonly<{
     family: 'none';
-    placement: 'none';
 }>;
 export type VisibleHeadingDecoration = Readonly<{
     family: VisibleHeadingDecorationFamily;
-    placement: VisibleHeadingDecorationPlacement;
     colorToken?: HeadingDecorationColorToken;
 }>;
 export type HeadingDecoration = NoHeadingDecoration | VisibleHeadingDecoration;
 export declare const noHeadingDecoration: {
     readonly family: "none";
-    readonly placement: "none";
 };
 export declare const accordionIconSetValues: readonly ["plus", "chevron", "caret", "minimal-cross"];
 export type AccordionIconSet = (typeof accordionIconSetValues)[number];
@@ -255,7 +259,7 @@ export type GeneratedFlushPanelFrameIntent = Readonly<{
 export type GeneratedContentFrameIntent = PlainFrameIntent | GeneratedPanelFrameIntent | GeneratedFlushPanelFrameIntent;
 export type UserContentFrameIntent = ContentFrameIntent;
 export type AdvancedContentFrameIntent = ContentFrameIntent | AdvancedDetachedDesignValue;
-export type GeneratedItemSurfaceIntent = Extract<SiteStyleItemSurfaceIntent, 'none' | 'default' | 'flat' | 'outlined' | 'raised'>;
+export type GeneratedItemSurfaceIntent = Extract<SiteStyleItemSurfaceIntent, 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial' | 'color-blocked'>;
 export type UserItemSurfaceIntent = SiteStyleItemSurfaceIntent;
 export type AdvancedItemSurfaceIntent = SiteStyleItemSurfaceIntent | AdvancedDetachedDesignValue;
 export type GeneratedSectionTransitionIntent = Extract<SiteStyleSectionTransitionIntent, 'none' | 'soft-fade-short' | 'soft-fade-long'>;
@@ -376,6 +380,7 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     blockId: TBlockId;
     blockKind: string;
     purpose: TPurpose;
+    appearancePresetId?: AppearancePresetId;
     sectionSurface: SiteStyleSurfaceIntent;
     contentFrame: ContentFrameIntent;
     itemSurface: SiteStyleItemSurfaceIntent;
@@ -391,7 +396,6 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     tileTreatment?: TileTreatment;
     eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
-    headingDecoration?: HeadingDecoration;
     accordionIconTreatment?: AccordionIconTreatment | null;
 }>;
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
@@ -407,7 +411,6 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedTileTreatment: TileTreatment;
     appliedEventListTreatment: EventListTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
-    appliedHeadingDecoration: HeadingDecoration;
     appliedAccordionIconTreatment: AccordionIconTreatment | null;
 }>;
 export type PageDesignState<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -419,6 +422,12 @@ export type ResolvedPageDesignPlan<TBlockId extends string = DesignBlockId, TPur
     blocks: readonly ResolvedBlockDesignPlan<TBlockId, TPurpose>[];
     issues: readonly DesignResolutionIssue<TBlockId, TPurpose>[];
 }>;
+export type HeadingDecorationCapability = Readonly<{
+    kind: 'unsupported';
+}> | Readonly<{
+    kind: 'supported';
+    families: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+}>;
 export type DesignedBlockDesignCapabilityInput = Readonly<{
     sectionSurfaces: 'supported' | 'unsupported';
     contentFrames: FrameCapability;
@@ -430,8 +439,8 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     tileTreatments?: NonEmptyReadonlyArray<TileTreatment>;
     eventListTreatments?: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
-    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
+    headingDecorationCapability?: HeadingDecorationCapability;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
     kind: 'designed';
@@ -445,8 +454,8 @@ export type DesignedBlockDesignCapability = Readonly<{
     tileTreatments: NonEmptyReadonlyArray<TileTreatment>;
     eventListTreatments: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
-    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
+    headingDecorationCapability: HeadingDecorationCapability;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
 export type NoBlockDesignCapability = Readonly<{
@@ -455,9 +464,9 @@ export type NoBlockDesignCapability = Readonly<{
 }>;
 export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesignCapability;
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
-export declare function defineBlockDesignCapability(capability: DesignedBlockDesignCapabilityInput): DesignedBlockDesignCapability;
+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-heading-decoration' | '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-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;
@@ -570,17 +579,6 @@ export type UnsupportedEyebrowTreatmentIssue<TBlockId extends string = DesignBlo
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-eyebrow-treatment'];
 }>;
-export type UnsupportedHeadingDecorationIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
-    kind: 'unsupported-heading-decoration';
-    blockId: TBlockId;
-    blockKind: string;
-    purpose: TPurpose;
-    requested: HeadingDecoration;
-    fallback: NoHeadingDecoration;
-    policy: DesignResolutionPolicy;
-    severity: DesignIssueSeverity;
-    allowedRepairActions: readonly ['fallback-heading-decoration'];
-}>;
 export type UnsupportedAccordionIconTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-accordion-icon-treatment';
     blockId: TBlockId;
@@ -642,7 +640,6 @@ export type BlockDesignCapabilityRequest = Readonly<{
     tileTreatment?: TileTreatment;
     eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
-    headingDecoration?: HeadingDecoration;
     accordionIconTreatment?: AccordionIconTreatment | null;
 }>;
 export type BlockDesignCapabilityFallback = Readonly<{
@@ -660,7 +657,6 @@ export type BlockDesignCapabilityFallback = Readonly<{
     tileTreatment: 'default';
     eventListTreatment: 'plain';
     eyebrowTreatment: 'plain';
-    headingDecoration: NoHeadingDecoration;
     accordionIconTreatment: null;
 }>;
 export type MissingBlockDesignCapabilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -708,7 +704,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> | UnsupportedHeadingDecorationIssue<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> | 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/site-styles/typographyPresets.d.ts

@@ -2,7 +2,7 @@ import type { Theme } from '../schema';
 import type { Brand, NonEmptyReadonlyArray } from './types';
 import type { PersistedIdParseResult } from './persistedIdParseResult';
 export type TypographyPresetId = Brand<string, 'TypographyPresetId'>;
-export declare const typographyPresetIdValues: readonly ["typography-preset:modern-sans", "typography-preset:warm-rounded", "typography-preset:editorial-serif", "typography-preset:classic-serif", "typography-preset:luxe-contrast", "typography-preset:bold-display"];
+export declare const typographyPresetIdValues: readonly ["typography-preset:modern-sans", "typography-preset:warm-rounded", "typography-preset:editorial-serif", "typography-preset:classic-serif", "typography-preset:luxe-contrast", "typography-preset:bold-display", "typography-preset:original-joy"];
 export type KnownTypographyPresetIdValue = typeof typographyPresetIdValues[number];
 export type KnownTypographyPresetId = TypographyPresetId & KnownTypographyPresetIdValue;
 export type TypographyFontSlot = 'body' | 'heading';
@@ -174,6 +174,21 @@ export declare const typographyPresets: readonly [Readonly<{
     slotPolicies: Readonly<Record<TypographyFontSlot, TypographyFontSlotPolicy>>;
     typography: Theme["typography"];
     heroTypography?: NonNullable<NonNullable<Theme["hero"]>["typography"]>;
+}>, Readonly<{
+    id: KnownTypographyPresetId;
+    name: string;
+    description: string;
+    defaultFonts: Readonly<{
+        body: string;
+        heading: string;
+    }>;
+    recommendedFonts: Readonly<{
+        body: NonEmptyReadonlyArray<string>;
+        heading: NonEmptyReadonlyArray<string>;
+    }>;
+    slotPolicies: Readonly<Record<TypographyFontSlot, TypographyFontSlotPolicy>>;
+    typography: Theme["typography"];
+    heroTypography?: NonNullable<NonNullable<Theme["hero"]>["typography"]>;
 }>];
 export declare function findTypographyPreset(id: TypographyPresetId): TypographyPreset | undefined;
 export declare function parsePersistedTypographyPresetId(value: string | null | undefined): PersistedIdParseResult<KnownTypographyPresetId>;