@riverbankcms/sdk 0.101.0 → 0.102.0

package/dist/_dts/api/src/bookingVerticals.d.ts

@@ -5,7 +5,7 @@ export declare const BOOKING_ENGINES: readonly ["event_series", "course", "appoi
 export type BookingEngine = (typeof BOOKING_ENGINES)[number];
 export declare const VERTICAL_PRESET_AVAILABILITIES: readonly ["onboarding", "settings", "future"];
 export type VerticalPresetAvailability = (typeof VERTICAL_PRESET_AVAILABILITIES)[number];
-export declare const VERTICAL_IDS: readonly ["yoga_wellness", "fitness_pt", "dance_school", "therapist_practitioner", "beauty_spa", "consultant_coach", "training_provider", "retreat_centre", "music_school", "performing_arts_school", "community_wellbeing", "venue_event_space"];
+export declare const VERTICAL_IDS: readonly ["yoga_wellness", "fitness_pt", "dance_school", "therapist_practitioner", "beauty_spa", "consultant_coach", "training_provider", "retreat_centre", "music_school", "voice_singing", "performing_arts_school", "community_wellbeing", "venue_event_space"];
 export type VerticalId = (typeof VERTICAL_IDS)[number];
 export type EventSeriesCanonicalBehaviour = Extract<CanonicalBookingBehaviour, 'class' | 'workshop' | 'retreat' | 'performance'>;
 export declare const EVENT_SERIES_BEHAVIOURS: readonly ["class", "workshop", "retreat", "performance"];
@@ -157,6 +157,10 @@ export declare const VERTICAL_DEFINITIONS: readonly [{
     readonly id: "music_school";
     readonly label: "Music teacher or school";
     readonly description: "Lessons, classes, terms, workshops, and performances.";
+}, {
+    readonly id: "voice_singing";
+    readonly label: "Voice & Singing";
+    readonly description: "Singing lessons, choirs, voice circles, workshops, and performances.";
 }, {
     readonly id: "performing_arts_school";
     readonly label: "Theatre or performing arts school";
@@ -523,6 +527,51 @@ export declare const VERTICAL_BOOKING_PRESETS: readonly [Readonly<{
     label: string;
     pluralLabel: string;
     description: string;
+}>, Readonly<{
+    id: "voice_singing.lessons";
+    verticalId: VerticalId;
+    canonicalBehaviour: CanonicalBookingBehaviour;
+    engine: BookingEngine;
+    availability: VerticalPresetAvailability;
+    label: string;
+    pluralLabel: string;
+    description: string;
+}>, Readonly<{
+    id: "voice_singing.classes";
+    verticalId: VerticalId;
+    canonicalBehaviour: CanonicalBookingBehaviour;
+    engine: BookingEngine;
+    availability: VerticalPresetAvailability;
+    label: string;
+    pluralLabel: string;
+    description: string;
+}>, Readonly<{
+    id: "voice_singing.terms";
+    verticalId: VerticalId;
+    canonicalBehaviour: CanonicalBookingBehaviour;
+    engine: BookingEngine;
+    availability: VerticalPresetAvailability;
+    label: string;
+    pluralLabel: string;
+    description: string;
+}>, Readonly<{
+    id: "voice_singing.workshops";
+    verticalId: VerticalId;
+    canonicalBehaviour: CanonicalBookingBehaviour;
+    engine: BookingEngine;
+    availability: VerticalPresetAvailability;
+    label: string;
+    pluralLabel: string;
+    description: string;
+}>, Readonly<{
+    id: "voice_singing.performances";
+    verticalId: VerticalId;
+    canonicalBehaviour: CanonicalBookingBehaviour;
+    engine: BookingEngine;
+    availability: VerticalPresetAvailability;
+    label: string;
+    pluralLabel: string;
+    description: string;
 }>, Readonly<{
     id: "performing_arts_school.classes";
     verticalId: VerticalId;
@@ -633,6 +682,9 @@ export declare const LEGACY_VERTICAL_QUERY_MAP: {
     readonly therapist: "therapist_practitioner";
     readonly therapists: "therapist_practitioner";
     readonly 'beauty-spa': "beauty_spa";
+    readonly 'voice-singing': "voice_singing";
+    readonly singing: "voice_singing";
+    readonly choir: "voice_singing";
     readonly other: "community_wellbeing";
 };
 export declare function parseVerticalId(value: unknown): VerticalId | null;

package/dist/_dts/api/src/siteRuntimeEndpoints.d.ts

@@ -39,6 +39,7 @@ export type ApplySiteStyleSelectionBody = Readonly<{
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;
     typographyHeadingFontOverride?: string | null;
+    customTypography?: Theme['typography'] | null;
     headerLookId: HeaderLookId | null;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;

package/dist/_dts/blocks/src/bindings/index.d.ts

@@ -7,7 +7,7 @@
 export type { BindingSource, BindingDescriptor, BindingInput, BindingMap, BindingContext, BindingPath, BindingTransformName, KnownBindingTransformName, FieldBindingDescriptor, MetaBindingDescriptor, LiteralBindingDescriptor, TransformBindingDescriptor, FallbackBindingDescriptor, } from './types';
 export { TRANSFORMS, BINDING_SOURCES } from './types';
 export { asDesignBlockId, asContentTemplateDesignBlockId, asLayoutVariantKey, buildPageDesignEditorReadModel, compileContentTemplateRuntimeFields, parsePageDesignIntent, surfaceResolutionContextFromTheme, designRuntimeRulesForTheme, type DesignBlockId, parseContentTemplateDesignIntent, type CompiledBlockRuntimeFields, type LayoutVariantKey, type PageDesignEditorBlockInput, type PageDesignIntent, type SurfaceResolutionContext, applyBlockContentVariantPolicy, deriveSiteStyleBlockPolicy, } from '../../../theme-core/src/site-styles/index';
-export { applyCompiledRuntimeFieldsToContent, buildEditorModelRuntimeFieldsByBlockId, } from '../../../theme-core/src/site-styles/previewCompiler';
+export { applyCompiledRuntimeFieldsToContent, buildEditorModelRuntimeFieldsByBlockId, retargetCompiledRuntimeFieldsForContentAdjacency, } from '../../../theme-core/src/site-styles/previewCompiler';
 export { blockDesignMetadataMapFromDefinitions } from '../system/designCapabilities';
 export { systemBlockDefinitions } from '../system/blocks';
 import type { BindingContext, BindingDescriptor, BindingInput, BindingMap, BindingPath, FieldBindingDescriptor, FallbackBindingDescriptor, KnownBindingTransformName, LiteralBindingDescriptor, MetaBindingDescriptor, TransformBindingDescriptor } from './types';

package/dist/_dts/blocks/src/system/runtime/nodes/layout.d.ts

@@ -9,6 +9,7 @@ type NodeMetadataProps = {
     blockKind?: string;
     blockContent?: unknown;
     fragmentRegistry?: unknown;
+    previewAuthoring?: unknown;
 };
 type SectionNodeProps = React.ComponentProps<typeof Section> & NodeMetadataProps;
 type StackNodeProps = React.ComponentProps<typeof StackPrimitive> & NodeMetadataProps;

package/dist/_dts/content-editor/src/index.d.ts

@@ -22,6 +22,7 @@ export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, EditorPr
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
 export { PreviewInlineTextEditor } from './primitives/PreviewInlineTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
+export { recordsEqual as editorValuesEqual } from './ui/stores/utils';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
 export * from './ai/overlayHelpers';

package/dist/_dts/core/src/branded.d.ts

@@ -255,11 +255,15 @@ export declare const parseNavigationItemId: (value: unknown) => Result<Navigatio
 export declare const parsePassId: (value: unknown) => Result<PassId, BrandedIdParseError>;
 export declare const parseMembershipId: (value: unknown) => Result<MembershipId, BrandedIdParseError>;
 export declare const parseCourseId: (value: unknown) => Result<CourseId, BrandedIdParseError>;
+export declare const parseFormId: (value: unknown) => Result<FormId, BrandedIdParseError>;
 export declare const parseAppointmentId: (value: unknown) => Result<AppointmentId, BrandedIdParseError>;
+export declare const parseAppointmentServiceId: (value: unknown) => Result<AppointmentServiceId, BrandedIdParseError>;
+export declare const parseAppointmentResourceId: (value: unknown) => Result<AppointmentResourceId, BrandedIdParseError>;
 export declare const parseAppointmentReservationId: (value: unknown) => Result<AppointmentReservationId, BrandedIdParseError>;
 export declare const parseAppointmentReservationRunId: (value: unknown) => Result<AppointmentReservationRunId, BrandedIdParseError>;
 export declare const parseAttendeeId: (value: unknown) => Result<AttendeeId, BrandedIdParseError>;
 export declare const parseCustomerId: (value: unknown) => Result<CustomerId, BrandedIdParseError>;
+export declare const parseCustomerPassId: (value: unknown) => Result<CustomerPassId, BrandedIdParseError>;
 export declare const parseCustomerMembershipId: (value: unknown) => Result<CustomerMembershipId, BrandedIdParseError>;
 export declare const parseEventSeriesId: (value: unknown) => Result<EventSeriesId, BrandedIdParseError>;
 export {};

package/dist/_dts/core/src/person-records.d.ts

@@ -1,5 +1,10 @@
+import { type Result } from './result';
 export declare const RECORD_ENTRY_KINDS: readonly ["person_note", "prep_note", "session_note", "follow_up_note", "booking_questions_snapshot", "correction_note"];
 export type RecordEntryKind = (typeof RECORD_ENTRY_KINDS)[number];
 export declare const PERSON_RECORD_NOTE_KINDS: readonly ["person_note", "prep_note", "session_note", "follow_up_note", "correction_note"];
 export type PersonRecordNoteKind = (typeof PERSON_RECORD_NOTE_KINDS)[number];
-export declare function parseRecordEntryKind(value: string): RecordEntryKind | null;
+export type RecordEntryKindParseError = Readonly<{
+    kind: 'unsupported_record_entry_kind';
+    value: string;
+}>;
+export declare function parseRecordEntryKind(value: string): Result<RecordEntryKind, RecordEntryKindParseError>;

package/dist/_dts/media-core/src/identifiers.d.ts

@@ -1,5 +1,18 @@
+import { type Brand, type Result } from '../../core/src/index';
+export type MediaIdentifier = Brand<string, 'MediaIdentifier'>;
+export type MediaIdentifierParseError = Readonly<{
+    kind: 'not_string';
+}> | Readonly<{
+    kind: 'empty_identifier';
+}> | Readonly<{
+    kind: 'empty_after_normalization';
+    value: string;
+}>;
 export declare function stripFileExtension(filename: string): string;
 export declare function slugifyMediaIdentifier(value: string): string;
 export declare function buildMediaIdentifierFromFilename(filename: string): string;
-export declare function resolveMediaIdentifier(base: string, existing: Set<string>): string;
+export declare function parseMediaIdentifier(value: unknown): Result<MediaIdentifier, MediaIdentifierParseError>;
+export declare function parseOptionalMediaIdentifier(value: unknown): Result<MediaIdentifier | undefined, MediaIdentifierParseError>;
+export declare function unsafeAsMediaIdentifier(value: string): MediaIdentifier;
+export declare function resolveMediaIdentifier(base: string, existing: Set<string>): MediaIdentifier;
 export declare const MEDIA_IDENTIFIER_FALLBACK = "media";

package/dist/_dts/preview-next/src/client/blocks/composer/mergeDrafts.d.ts

@@ -4,4 +4,4 @@ import type { DraftSnapshot, EditorDraftInspectorStore, EnrichedBlock } from './
 import { type PreviewProjection } from '../previewProjection';
 import { type LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
 export declare function getDraftSnapshots(uiStore: EditorDraftInspectorStore): Map<EditorBlockId, DraftSnapshot>;
-export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay): EnrichedBlock;
+export declare function mergeBlockWithDraft(block: BlockItem, draftMap: Map<EditorBlockId, DraftSnapshot>, index: number, projections?: readonly PreviewProjection[], linkedEntryOverlays?: LinkedEntryRenderOverlay, nextBlock?: BlockItem | null): EnrichedBlock;

package/dist/_dts/preview-next/src/client/blocks/previewProjection/applyPreviewProjections.d.ts

@@ -3,5 +3,7 @@ import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from './types';
 export declare function applyPreviewStructureProjections(blockItems: readonly BlockItem[], projections: readonly PreviewProjection[]): BlockItem[];
 export declare function applyPreviewContentFieldProjections(blockId: EditorBlockId, content: CanonicalBlockContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
-export declare function applyPreviewRuntimeContentProjections(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[]): CanonicalBlockContent | PreviewRenderContent | null;
+export declare function applyPreviewRuntimeContentProjections(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projections: readonly PreviewProjection[], adjacency?: Readonly<{
+    nextContent: Record<string, unknown> | null | undefined;
+}>): CanonicalBlockContent | PreviewRenderContent | null;
 export declare function blockHasPreviewContentFieldProjection(blockId: EditorBlockId, projections: readonly PreviewProjection[]): boolean;

package/dist/_dts/preview-next/src/client/blocks/previewProjection/runtimeContentDecoration.d.ts

@@ -1,5 +1,5 @@
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
-import { type DesignRuntimeRules, type PageDesignEditorReadModel, type SurfaceResolutionContext } from '../../../../../theme-core/src/site-styles/previewCompiler';
+import { type DesignRuntimeRules, type PageDesignEditorReadModel, type RuntimeContentAdjacency, type SurfaceResolutionContext } from '../../../../../theme-core/src/site-styles/previewCompiler';
 import type { CanonicalBlockContent, PreviewRenderContent, RuntimeContentDecorationProjection } from './types';
 export declare function runtimeContentDecorationProjectionFromEditorModel(editorModel: PageDesignEditorReadModel, surfaceResolutionContext: SurfaceResolutionContext, designRules?: DesignRuntimeRules): RuntimeContentDecorationProjection;
-export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection): PreviewRenderContent;
+export declare function applyRuntimeContentDecorationProjection(block: BlockItem, content: CanonicalBlockContent | PreviewRenderContent | null, projection: RuntimeContentDecorationProjection, adjacency?: Pick<RuntimeContentAdjacency, 'nextContent'>): PreviewRenderContent;

package/dist/_dts/preview-next/src/client/preview/PreviewChromeLayer.d.ts

@@ -8,8 +8,9 @@ export declare function PreviewChromeLayerProvider({ children, }: {
     children: ReactNode;
 }): React.JSX.Element;
 export declare function usePreviewChromeLayerOptional(): PreviewChromeLayerContextValue | null;
-export declare function PreviewChromeFloatingControl({ anchorSelector, placement, fallbackClassName, fallbackStyle, portalClassName, forceVisible, children, }: {
+export declare function PreviewChromeFloatingControl({ anchorSelector, anchorTargetSelector, placement, fallbackClassName, fallbackStyle, portalClassName, forceVisible, children, }: {
     anchorSelector: string;
+    anchorTargetSelector?: string;
     placement: PreviewChromeFloatingPlacement | ((anchorBox: PreviewChromeAnchorBox | null) => PreviewChromeFloatingPlacement);
     fallbackClassName: string;
     fallbackStyle?: CSSProperties;

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.state.d.ts

@@ -11,6 +11,7 @@
  * picking and converge on apply-success.
  */
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
+import type { Theme } from '../../../../blocks/src/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
 import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
@@ -37,6 +38,33 @@ export type StyleConfiguratorNotice = Readonly<{
 }> | Readonly<{
     kind: 'palette-overrides-restored';
 }>;
+type ThemeTypography = Theme['typography'];
+type BodyTypography = ThemeTypography['body'];
+type HeadingTypography = ThemeTypography['headings']['default'];
+export type TypographySelectionSnapshot = Readonly<{
+    kind: 'preset';
+    presetId: TypographyPresetId | null;
+    bodyFontOverride: string | null;
+    headingFontOverride: string | null;
+}> | Readonly<{
+    kind: 'custom';
+    typography: ThemeTypography;
+}>;
+export type TypographySelectionFlatFields = Readonly<{
+    typographyPresetId: TypographyPresetId | null;
+    typographyBodyFontOverride: string | null;
+    typographyHeadingFontOverride: string | null;
+}>;
+export type TypographyDraftPatch = Readonly<{
+    kind: 'heading';
+    patch: Partial<HeadingTypography>;
+}> | Readonly<{
+    kind: 'body';
+    patch: Partial<BodyTypography>;
+}> | Readonly<{
+    kind: 'scale';
+    scale: ThemeTypography['scale'];
+}>;
 export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
     selectionVersion: number;
@@ -48,9 +76,7 @@ export type SelectionSnapshot = Readonly<{
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
-    typographyPresetId: TypographyPresetId | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
+    typographySelection: TypographySelectionSnapshot;
 }>;
 type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
 type StyleConfiguratorTargetKey = 'design:site-style';
@@ -95,9 +121,9 @@ export declare function previewHeaderLayout(state: StyleConfiguratorState, heade
 export declare function previewHeaderStyle(state: StyleConfiguratorState, headerStyleId: HeaderStyleId): StyleConfiguratorState;
 export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
 export declare function previewTypographyPreset(state: StyleConfiguratorState, typographyPresetId: TypographyPresetId): StyleConfiguratorState;
-export declare function setTypographyBodyFontOverride(state: StyleConfiguratorState, typographyBodyFontOverride: string | null): StyleConfiguratorState;
-export declare function setTypographyHeadingFontOverride(state: StyleConfiguratorState, typographyHeadingFontOverride: string | null): StyleConfiguratorState;
-export declare function clearTypographyFontOverrides(state: StyleConfiguratorState): StyleConfiguratorState;
+export declare function setCustomTypography(state: StyleConfiguratorState, typography: ThemeTypography): StyleConfiguratorState;
+export declare function applyTypographyDraftPatch(state: StyleConfiguratorState, currentTypography: ThemeTypography, patch: TypographyDraftPatch): StyleConfiguratorState;
+export declare function resetTypographyToSaved(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
 export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
 /**
@@ -112,7 +138,8 @@ export declare function setPaletteOverrides(state: StyleConfiguratorState, palet
  * under the previous palette ID and any draft for the new palette is restored.
  */
 export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
-    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typographyPresetId' | 'typographyBodyFontOverride' | 'typographyHeadingFontOverride'>;
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId'> & TypographySelectionFlatFields;
+    typographySelection?: TypographySelectionSnapshot;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
@@ -129,5 +156,14 @@ export declare function dismissNotices(state: StyleConfiguratorState): StyleConf
  */
 export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
 export declare function selectionSnapshotsEqual(a: SelectionSnapshot, b: SelectionSnapshot): boolean;
+export declare function typographySelectionSnapshotFromFlat(input: Readonly<{
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
+    theme?: Theme | null;
+}>): TypographySelectionSnapshot;
+export declare function typographySelectionFlatFields(selection: TypographySelectionSnapshot): TypographySelectionFlatFields;
+export declare function customTypographyForSelection(selection: TypographySelectionSnapshot): ThemeTypography | null;
+export declare function typographySelectionsEqual(a: TypographySelectionSnapshot, b: TypographySelectionSnapshot): boolean;
 export declare function paletteOverridesEqual(a: PaletteOverrides | null, b: PaletteOverrides | null): boolean;
 export {};

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -2,15 +2,14 @@ import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
 import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
-import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import { type CuratedSiteStyle, type CompiledTypographySelection, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+import type { TypographySelectionSnapshot } from './StyleConfigurator.state';
 export type SiteStylePreviewSelection = Readonly<{
     siteStyleId: SiteStyleId;
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
+    typographySelection?: TypographySelectionSnapshot;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
     headerLookId: HeaderLookId | null;
@@ -25,6 +24,7 @@ export type SiteStylePreviewPlan = Readonly<{
     resolvedSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
         paletteVariantId: PaletteVariantId;
+        typographySelection: CompiledTypographySelection['resolvedSelection'];
         typographyPresetId: TypographyPresetId | null;
         typographyBodyFontOverride: string | null;
         typographyHeadingFontOverride: string | null;

package/dist/_dts/preview-next/src/client/preview/styleConfiguratorApplyPayload.d.ts

@@ -1,5 +1,5 @@
 import type { APIEndpoints } from '../../../../api/src/index';
-import type { SelectionSnapshot } from './StyleConfigurator.state';
+import { type SelectionSnapshot } from './StyleConfigurator.state';
 export type ApplySiteStyleSelectionBody = NonNullable<APIEndpoints['applySiteStyleSelection']['body']>;
 export declare function buildApplySiteStyleSelectionBody(input: Readonly<{
     base: SelectionSnapshot;

package/dist/_dts/preview-next/src/client/preview/typographySelectionInput.d.ts

@@ -1,11 +1,13 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { TypographyPresetId, TypographySelection } from '../../../../theme-core/src/site-styles/previewCompiler';
-type TypographySelectionSnapshot = Readonly<{
+import type { TypographySelectionSnapshot } from './StyleConfigurator.state';
+type TypographySelectionInputSnapshot = Readonly<{
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;
     typographyHeadingFontOverride?: string | null;
+    typographySelection?: TypographySelectionSnapshot;
 }>;
-export declare function typographySelectionInputForSnapshot(snapshot: TypographySelectionSnapshot, theme: Theme | null | undefined): Readonly<{
+export declare function typographySelectionInputForSnapshot(snapshot: TypographySelectionInputSnapshot, theme: Theme | null | undefined): Readonly<{
     typographySelection?: TypographySelection;
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.101.0";
+export declare const SDK_VERSION = "0.102.0";

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

@@ -291,8 +291,9 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
         _sectionStyles: "_sectionStyles";
         _containerStyles: "_containerStyles";
         _cardStyles: "_cardStyles";
+        _transitionStyles: "_transitionStyles";
         styleGroup: "styleGroup";
-    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
+    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_transitionStyles" | "styleGroup")[]>>;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"theme-v2">;
         source: z.ZodEnum<{
@@ -486,8 +487,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             _sectionStyles: "_sectionStyles";
             _containerStyles: "_containerStyles";
             _cardStyles: "_cardStyles";
+            _transitionStyles: "_transitionStyles";
             styleGroup: "styleGroup";
-        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
+        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_transitionStyles" | "styleGroup")[]>>;
         authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"theme-v2">;
             source: z.ZodEnum<{

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

@@ -281,12 +281,12 @@ export declare const headerStyleCatalog: readonly [{
     readonly moods: readonly ["calm", "professional", "editorial"];
 }, {
     readonly id: HeaderStyleId;
-    readonly label: "Fine Line";
-    readonly description: "Light surface with a crisp lower rule and underline hover.";
+    readonly label: "Seamless";
+    readonly description: "Borderless surface with underline hover for a quieter page transition.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "underline-grow";
-    readonly surface: "bordered";
-    readonly defaultDepth: "line";
+    readonly surface: "neutral";
+    readonly defaultDepth: "none";
     readonly navTypography: "plain";
     readonly moods: readonly ["calm", "professional", "editorial"];
 }, {

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

@@ -23,7 +23,7 @@ export { buildPageDesignEditorReadModel, boundaryOptions, pageFlowPresets, type
 export { autoDesignChoice, reducePageDesignIntentForUserAction, resolvePageDesignBlockLookChoice, resolvePageDesignBoundaryChoice, userPinnedDesignChoice, type PageDesignChoice, type PageDesignIntent, type PageDesignUserAction, } from './pageDesignIntent';
 export { repairDesignIssue, resolveBlockDesignPlan } from './resolver';
 export { cycleableOptionsFromResolved, deriveDesignCustomizationScope, recommendedDesignOption, type CycleableDesignOption, type CycleableOptions, type DesignCustomizationAuthority, type DesignCustomizationScope, type DesignCustomizationSurface, type DesignCustomizationUnsupportedReason, type DesignOptionIssue, type ResolvedDesignOption, } from './previewCustomization';
-export { compileBlockRuntimeFields, compilePageRuntimeFields, compileTokenRecipes, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
+export { compileBlockRuntimeFields, compilePageRuntimeFields, compileTokenRecipes, compileTransitionRuntime, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
 export { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
 export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteVariantForSiteStyle, defaultTypographyPresetForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
 export { asTypographyPresetId, compileTypographySelection, evaluateTypographyFontSlot, findTypographyPreset, parsePersistedTypographyPresetId, typographyPresetIdValues, typographyPresets, type CompiledTypographySelection, type GoogleFontCategory, type KnownTypographyPresetId, type KnownTypographyPresetIdValue, type TypographyFontCapability, type TypographyFontSlot, type TypographyFontSlotFit, type TypographyFontSlotPolicy, type TypographyPreset, type TypographyPresetId, type TypographyPresetResolutionWarning, type TypographySelection, } from './typographyPresets';
@@ -125,4 +125,9 @@ export declare function compileEditorModelRuntimeFieldsForBlock<TBlockId extends
     blockId: TBlockId;
 }>): CompiledBlockRuntimeFields | null;
 export declare function applyCompiledRuntimeFieldsToContent<TContent extends Record<string, unknown>>(content: TContent, fields: CompiledBlockRuntimeFields | null | undefined): Record<string, unknown>;
+export type RuntimeContentAdjacency = Readonly<{
+    currentContent: Record<string, unknown> | null | undefined;
+    nextContent: Record<string, unknown> | null | undefined;
+}>;
+export declare function retargetCompiledRuntimeFieldsForContentAdjacency(fields: CompiledBlockRuntimeFields | null | undefined, adjacency: RuntimeContentAdjacency): CompiledBlockRuntimeFields | null | undefined;
 export declare function restoreCompiledRuntimeFieldsFromContent<TCurrentContent extends Record<string, unknown>, TPreviousContent extends Record<string, unknown>>(currentContent: TCurrentContent, previousContent: TPreviousContent): Record<string, unknown>;

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

@@ -1,11 +1,11 @@
-export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup"];
+export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup"];
 export type ThemeV2RuntimeStyleFieldName = typeof themeV2RuntimeStyleFieldNames[number];
 export declare const themeV2BlockSpecificRawStyleFieldNames: readonly ["_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export type ThemeV2BlockSpecificRawStyleFieldName = typeof themeV2BlockSpecificRawStyleFieldNames[number];
 export type ThemeV2NormalEditorRawStyleFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
 export type ThemeV2CompilerOwnedFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
-export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
-export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare const pageDesignEditorBackgroundOverrideOwner: "page-design-editor";
 export type PageDesignEditorBackgroundOverrideOwner = typeof pageDesignEditorBackgroundOverrideOwner;
 export declare const siteChromeBackgroundOverrideOwner: "site-chrome-editor";

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

@@ -4,6 +4,7 @@ import { type ButtonPersonalityId } from '../buttons/personalities';
 import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 import { type ContentFrameIntent, type EyebrowTreatment, type FlushFrameTreatment, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
+import type { ThemeColorToken } from '../tokens';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type SectionPaddingX = 'normal' | 'none';
 type SectionForegroundRuntimeTokens = Pick<NonNullable<SectionSurfaceRuntimeRule['background']>, 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor'>;
@@ -29,16 +30,33 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _contentCardStyles?: ContainerStylesOverride;
     _heroLayoutStyles?: HeroLayoutStylesOverride;
     _cardStyles?: CardStylesOverride;
+    _transitionStyles?: CompiledTransitionRuntime;
     blockLook?: string;
     styleGroup?: string;
 }>;
+export type CompiledTransitionEndpoint = Readonly<{
+    kind: 'surface';
+    surface: SiteStyleSurfaceIntent;
+}> | Readonly<{
+    kind: 'color-token';
+    token: ThemeColorToken;
+}>;
+export type CompiledTransitionRuntime = Readonly<{
+    treatment: SiteStyleSectionTransitionIntent;
+    from: CompiledTransitionEndpoint;
+    to: CompiledTransitionEndpoint;
+    cssVars: Readonly<{
+        from: string;
+        to: string;
+    }>;
+}>;
 export type HeroLayoutStylesOverride = Readonly<{
     contentAlignment?: 'left' | 'center' | 'right';
     verticalAlignment?: 'top' | 'center' | 'bottom';
     contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
     typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "blockLook", "styleGroup"];
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "_transitionStyles", "blockLook", "styleGroup"];
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;
@@ -249,6 +267,11 @@ export declare const defaultComponentRuntimeRules: {
 export declare function compileBlockRuntimeFields<TBlockId extends string, TPurpose extends string>(input: CompileBlockRuntimeInput<TBlockId, TPurpose>): CompiledBlockRuntime & Readonly<{
     blockId: TBlockId;
 }>;
+export declare function compileTransitionRuntime(input: Readonly<{
+    treatment: SiteStyleSectionTransitionIntent;
+    from: CompiledTransitionEndpoint;
+    to: CompiledTransitionEndpoint;
+}>): CompiledTransitionRuntime;
 /**
  * Compiles block runtime fields and writes them into content only when Theme V2
  * owns that block's runtime-style fields.