@riverbankcms/sdk 0.76.0 → 0.77.1

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

@@ -192,6 +192,44 @@ export declare const tileTreatmentValues: readonly ["default", "quiet", "brand-d
 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 declare const headingDecorationFamilyValues: readonly ["none", "organic-squiggle", "short-center-rule"];
+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 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];
+export declare const accordionIconColorTokenValues: readonly ["text", "muted", "primary", "secondary", "accent", "current"];
+export type AccordionIconColorToken = (typeof accordionIconColorTokenValues)[number];
+export declare const accordionIconMotionValues: readonly ["none", "rotate", "swap"];
+export type AccordionIconMotion = (typeof accordionIconMotionValues)[number];
+export type AccordionIconTreatment = Readonly<{
+    iconSet: AccordionIconSet;
+    colorToken: AccordionIconColorToken;
+    openColorToken?: AccordionIconColorToken;
+    motion: AccordionIconMotion;
+}>;
 export type GeneratedMediaCompositionIntent = Extract<MediaCompositionIntent, 'none' | 'supporting' | 'dominant'>;
 export type UserMediaCompositionIntent = MediaCompositionIntent;
 export type AdvancedMediaCompositionIntent = MediaCompositionIntent | AdvancedDetachedDesignValue;
@@ -346,6 +384,8 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     testimonialCardTreatment?: TestimonialCardTreatment;
     tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
+    headingDecoration?: HeadingDecoration;
+    accordionIconTreatment?: AccordionIconTreatment | null;
 }>;
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
     appliedSectionSurface: SiteStyleSurfaceIntent;
@@ -359,6 +399,8 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedTestimonialCardTreatment: TestimonialCardTreatment;
     appliedTileTreatment: TileTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
+    appliedHeadingDecoration: HeadingDecoration;
+    appliedAccordionIconTreatment: AccordionIconTreatment | null;
 }>;
 export type PageDesignState<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     schemaVersion: 1;
@@ -379,6 +421,8 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     testimonialCardTreatments?: NonEmptyReadonlyArray<TestimonialCardTreatment>;
     tileTreatments?: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
+    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+    accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
     kind: 'designed';
@@ -391,6 +435,8 @@ export type DesignedBlockDesignCapability = Readonly<{
     testimonialCardTreatments: NonEmptyReadonlyArray<TestimonialCardTreatment>;
     tileTreatments: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
+    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+    accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
 export type NoBlockDesignCapability = Readonly<{
@@ -401,7 +447,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-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 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' | '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 UnsupportedSectionSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-section-surface';
     blockId: TBlockId;
@@ -503,6 +549,28 @@ 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;
+    blockKind: string;
+    purpose: TPurpose;
+    requested: AccordionIconTreatment;
+    fallback: null;
+    policy: DesignResolutionPolicy;
+    severity: DesignIssueSeverity;
+    allowedRepairActions: readonly ['fallback-accordion-icon-treatment'];
+}>;
 export type ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'image-surface-treatment-without-image-surface';
     blockId: TBlockId;
@@ -550,6 +618,8 @@ export type BlockDesignCapabilityRequest = Readonly<{
     testimonialCardTreatment?: TestimonialCardTreatment;
     tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
+    headingDecoration?: HeadingDecoration;
+    accordionIconTreatment?: AccordionIconTreatment | null;
 }>;
 export type BlockDesignCapabilityFallback = Readonly<{
     sectionSurface: 'base';
@@ -565,6 +635,8 @@ export type BlockDesignCapabilityFallback = Readonly<{
     testimonialCardTreatment: 'default';
     tileTreatment: 'default';
     eyebrowTreatment: 'plain';
+    headingDecoration: NoHeadingDecoration;
+    accordionIconTreatment: null;
 }>;
 export type MissingBlockDesignCapabilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'missing-block-design-capability';
@@ -611,7 +683,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> | 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> | 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 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

@@ -0,0 +1,189 @@
+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 type KnownTypographyPresetIdValue = typeof typographyPresetIdValues[number];
+export type KnownTypographyPresetId = TypographyPresetId & KnownTypographyPresetIdValue;
+export type TypographyFontSlot = 'body' | 'heading';
+export type GoogleFontCategory = 'serif' | 'sans-serif' | 'display' | 'handwriting' | 'monospace';
+export type TypographyFontCapability = Readonly<{
+    source: 'google' | 'uploaded' | 'unknown';
+    family: string;
+    category: GoogleFontCategory | 'unknown';
+    variants: readonly string[];
+    variableWeightRange?: Readonly<{
+        min: number;
+        max: number;
+    }> | null;
+}>;
+export type TypographyFontSlotPolicy = Readonly<{
+    recommendedCategories: readonly GoogleFontCategory[];
+    allowedCategories: readonly GoogleFontCategory[];
+    requiresItalicForBody?: boolean;
+    requiresBoldForBody?: boolean;
+}>;
+export type TypographyFontSlotFit = Readonly<{
+    kind: 'recommended';
+    reason: string;
+}> | Readonly<{
+    kind: 'compatible';
+    reason: string;
+}> | Readonly<{
+    kind: 'limited';
+    reason: string;
+}> | Readonly<{
+    kind: 'risky';
+    reason: string;
+}> | Readonly<{
+    kind: 'unknown';
+    reason: string;
+}>;
+export type TypographyPreset = 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 type TypographySelection = Readonly<{
+    kind: 'preset';
+    presetId: TypographyPresetId | null;
+    bodyFontOverride: string | null;
+    headingFontOverride: string | null;
+}> | Readonly<{
+    kind: 'custom';
+    typography: Theme['typography'];
+}>;
+export type CompiledTypographySelection = Readonly<{
+    themeTypography: Theme['typography'];
+    heroTypography?: NonNullable<NonNullable<Theme['hero']>['typography']>;
+    resolvedSelection: Readonly<{
+        kind: 'preset';
+        presetId: KnownTypographyPresetId;
+        bodyFontOverride: string | null;
+        headingFontOverride: string | null;
+    }> | Readonly<{
+        kind: 'custom';
+    }>;
+}>;
+export type TypographyPresetResolutionWarning = Readonly<{
+    kind: 'rejected-typography-preset';
+    requested: string;
+    fellBackTo: KnownTypographyPresetId;
+    reason: 'unknown' | 'not-curated-for-style';
+}>;
+export declare function asTypographyPresetId(value: KnownTypographyPresetIdValue): KnownTypographyPresetId;
+export declare function asTypographyPresetId(value: string): TypographyPresetId;
+export declare const typographyPresets: readonly [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"]>;
+}>, 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"]>;
+}>, 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"]>;
+}>, 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"]>;
+}>, 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"]>;
+}>, 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>;
+export declare function compileTypographySelection(input: Readonly<{
+    selection: TypographySelection | null | undefined;
+    defaultPresetId: KnownTypographyPresetId;
+}>): CompiledTypographySelection;
+export declare function applyTypographyFontOverrides(typography: Theme['typography'], bodyFontOverride: string | null, headingFontOverride: string | null): Theme['typography'];
+export declare function evaluateTypographyFontSlot(input: Readonly<{
+    slot: TypographyFontSlot;
+    policy: TypographyFontSlotPolicy;
+    capability: TypographyFontCapability;
+}>): TypographyFontSlotFit;