@riverbankcms/sdk 0.144.0 → 0.146.0

package/dist/_dts/theme-core/src/inputs/checkable.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Checkbox and radio CSS shared by the full theme generator and the SDK
+ * theme bridge, so both render the same customer-facing controls.
+ *
+ * Emits:
+ * - .form-checkbox / .form-radio: the controls themselves. The tick and dot
+ *   are drawn with ::before so their colour comes from theme tokens rather
+ *   than a baked-in SVG.
+ * - .form-check: a label row holding a control and its text. The control
+ *   lines up with the first line of text, so long labels wrap cleanly.
+ * - .form-check--tile: a bordered, fully clickable panel for agreements
+ *   (booking consent, consent fields) that tints when ticked.
+ */
+export type CheckableCorners = 'square' | 'soft' | 'rounded' | 'pill';
+export type CheckableCssInput = Readonly<{
+    /** Scoped root selector, e.g. `:where([data-theme-scope="x"])`. */
+    root: string;
+    /** Resolved CSS border width, e.g. `1px`. */
+    borderWidth: string;
+    /** Resolved CSS colour for the unchecked border. */
+    borderColor: string;
+    /** Resolved CSS colour for the unchecked fill. */
+    background: string;
+    /** Input corner style; checkboxes and tiles scale their radius from it. */
+    corners: CheckableCorners;
+    /**
+     * Theme colour token for the checked fill, tile tint and focus outline.
+     * Any opacity suffix is dropped (`primary/70` fills with solid primary):
+     * the tick's on-token only contrasts with the solid colour.
+     */
+    accentToken: string;
+    /** Resolved CSS colour for an invalid agreement tile. */
+    errorColor: string;
+}>;
+/**
+ * Colour for the tick/dot drawn on top of the accent fill. Uses the palette's
+ * matching "on" token where there is one, falling back to white.
+ */
+/** The accent at full strength: `primary/70` becomes `primary`. */
+export declare function solidAccentToken(accentToken: string): string;
+export declare function checkableMarkColor(accentToken: string): string;
+export declare function generateCheckableCss(input: CheckableCssInput): string;

package/dist/_dts/theme-core/src/inputs/inputGroup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Input group: a field and an action (usually a themed button) sharing one
+ * input-styled shell, e.g. the newsletter email + Sign up row.
+ *
+ * The shell `.form-input-group` takes the theme's `.form-input` rules (the
+ * generators add it to that selector list, plus focus and error), so it
+ * follows the site's input background, border, corners and shadow. This file
+ * only adds the layout overrides and the borderless inner field.
+ */
+export declare const INPUT_GROUP_SELECTOR = ".form-input-group";
+/** Shell focus ring follows the field only, not the button beside it. */
+export declare const INPUT_GROUP_FOCUS_SELECTOR = ".form-input-group:has(> .form-input-group-field:focus-visible)";
+export declare const INPUT_GROUP_ERROR_SELECTOR = ".form-input-group:has(> .form-input-group-field[aria-invalid=\"true\"])";
+/**
+ * @param root - scoped root selector
+ * @param padding - the theme's input padding shorthand (`block inline`), so the
+ *   inner field's text sits where a plain input's text would.
+ */
+export declare function generateInputGroupCss(root: string, padding: string): string;

package/dist/_dts/theme-core/src/layout/boundaryCss.d.ts

@@ -0,0 +1,3 @@
+import { type WaveMaskId } from '../site-styles/transitionCatalogue';
+export declare function waveMaskDataUrl(mask: WaveMaskId): string;
+export declare function generateBoundaryCss(selector: string): string;

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

@@ -33,6 +33,14 @@ export type CompositionBudgetValidationInput<TBlockId extends string = DesignBlo
     policy: DesignResolutionPolicy;
     budget: CompositionBudget;
     resolved: ResolvedPageDesignPlan<TBlockId, TPurpose>;
+    /**
+     * The page's resolved joins. A join counts towards the transition mix when
+     * the frame rule lets it draw; one next to a flush panel doesn't.
+     */
+    joins: readonly Readonly<{
+        previousBlockId: TBlockId;
+        nextBlockId: TBlockId;
+    }>[];
     blockContexts?: readonly BlockCompositionContext<TBlockId>[];
 }>;
 export declare function maxCompositionItemsWithinRatio(totalItems: number, allowedRatio: number): number;

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

@@ -1,6 +1,7 @@
 import type { BlockDesignMetadata } from './blockFlow';
 import { type PageDesignEditorIssue } from './pageDesignEditorModel';
-import type { CompiledBlockRuntimeFields, CompiledBoundaryRuntime, SurfaceResolutionContext } from './runtimeCompiler';
+import type { CompiledBlockRuntimeFields, SurfaceResolutionContext } from './runtimeCompiler';
+import type { PageRuntimeJoin } from './joinTreatment';
 import { type ContentTemplateBlockScope, type ContentTemplateDesignBlockId, type ContentTemplateDesignIntent } from './contentTemplateDesignIntent';
 import type { BlockDesignCapability, LayoutVariantKey } from './types';
 export type ContentTemplateRuntimeBlockInput = Readonly<{
@@ -18,7 +19,7 @@ export type CompiledContentTemplateRuntimeBlock = Readonly<{
 }>;
 export type CompiledContentTemplateRuntime = Readonly<{
     blocks: readonly CompiledContentTemplateRuntimeBlock[];
-    boundaries: readonly CompiledBoundaryRuntime<ContentTemplateDesignBlockId>[];
+    joins: readonly PageRuntimeJoin<ContentTemplateDesignBlockId>[];
     fieldsByBlockId: ReadonlyMap<ContentTemplateDesignBlockId, CompiledBlockRuntimeFields>;
     issues: readonly PageDesignEditorIssue<ContentTemplateDesignBlockId>[];
 }>;

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

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

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

@@ -3,6 +3,7 @@ import type { ThemeV2StyleAuthority } from './designState';
 import { type PageDesignIntent } from './pageDesignIntent';
 import { type HeaderOpeningSectionRepair } from './headerOpeningSection';
 import type { HeaderOpeningSectionContext } from './headerLayoutStyles';
+import { type JoinIntent } from './joinTreatment';
 import { type CompiledPageRuntime } from './runtimeCompiler';
 import { type BlockDesignCapabilityMap, type BlockDesignPlan, type DesignBlockId, type DesignRepairResult, type DesignResolutionIssue, type GeneratedPageDesignIntent, type ResolvedPageDesignPlan, type SiteStyleId } from './types';
 import type { CuratedSiteStyle } from './curatedSiteStyles';
@@ -44,6 +45,8 @@ export type GeneratedDesignPipelineSuccess<TBlockId extends DesignBlockId = Desi
     intent: GeneratedPageDesignIntent<TBlockId>;
     plan: readonly BlockDesignPlan<TBlockId>[];
     resolved: ResolvedPageDesignPlan<TBlockId>;
+    /** The page's resolved joins, in block order; see `resolveJoinTreatment`. */
+    joins: readonly JoinIntent<TBlockId>[];
     headerOpeningSectionContext: HeaderOpeningSectionContext;
     headerOpeningSectionRepairs: readonly HeaderOpeningSectionRepair[];
     repairs: readonly DesignRepairResult<TBlockId>[];

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

@@ -23,6 +23,7 @@ export { compareCompiledHeaders, type CompiledHeaderComparison, type HeaderField
 export { compileHeaderForCuratedSelection, recompileSiteChromeHeader, recompileSiteChromeHeaderFromPersistedIntent, type CuratedHeaderSelectionRepair, type CompiledCuratedHeader, type HeaderInteractionPaletteRequest, type RecompileSiteChromeHeaderInput, type RecompiledSiteChromeHeader, } from './headerRecompile';
 export * from './headerOpeningForeground';
 export * from './headerOpeningSection';
+export * from './joinTreatment';
 export * from './lookResolution';
 export * from './lookOptionGroups';
 export * from './logoBranding';
@@ -42,6 +43,7 @@ export * from './resolver';
 export * from './runtimeCompiler';
 export * from './runtimeBackgroundResolution';
 export * from './sectionTransitions';
+export * from './sectionBoundaryComposition';
 export * from './siteChromeBackgrounds';
 export * from './siteChromeNavPreferences';
 export * from './siteStyleThemeCompiler';
@@ -49,6 +51,7 @@ export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';
 export * from './styleTags';
 export * from './tokenRecipes';
+export * from './transitionCatalogue';
 export * from './siteStyleTypography';
 export * from './themeParity';
 export * from './types';

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

@@ -0,0 +1,132 @@
+import { type PageDesignDecisions } from './pageDesignIntent';
+import type { PageDesignEditorIssue } from './pageDesignEditorModel';
+import { type SectionBoundaryTreatment } from './sectionTransitions';
+import type { DecorativeTransitionIntent } from './transitionCatalogue';
+import { type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type GeneratedPageDesignBlockIntent, type PageFlowPresetId, type SiteStyleId } from './types';
+/**
+ * Where a page-design join's default treatment came from. Derived at read
+ * time and never persisted (issue 1422).
+ */
+export type PageDesignDefaultJoinSource = Readonly<{
+    kind: 'site-style-default';
+    siteStyleId: SiteStyleId;
+}> | Readonly<{
+    kind: 'page-flow-default';
+    /** Null when the page's preset id is unknown and the first option applies. */
+    pageFlowPresetId: PageFlowPresetId | null;
+}>;
+export type PageDesignJoinSource = Readonly<{
+    kind: 'user-pinned';
+}> | PageDesignDefaultJoinSource;
+export type GeneratedJoinSource = Readonly<{
+    kind: 'generated';
+    origin: 'boundary-intent' | 'block-design' | 'automatic';
+}>;
+/**
+ * Where a join's treatment came from. Only `user-pinned` is a stored choice.
+ */
+export type JoinTreatmentSource = PageDesignJoinSource | GeneratedJoinSource;
+/**
+ * One source's opinion about a join, in the persisted vocabulary. Adapters
+ * translate their inputs into these; they never decide support or fallback.
+ */
+export type JoinTreatmentCandidate<TSource extends JoinTreatmentSource = JoinTreatmentSource> = Readonly<{
+    source: TSource;
+    treatment: SectionBoundaryTreatment;
+}>;
+/**
+ * A resolved break between two adjacent blocks: which treatment, and where it
+ * came from. Whether it draws is composition's call (`composeBoundary`), made
+ * from the content that finally renders. Joins that resolve to `none` are
+ * absent rather than carried with a `none` treatment.
+ */
+export type JoinIntent<TBlockId extends DesignBlockId = DesignBlockId, TSource extends JoinTreatmentSource = JoinTreatmentSource> = Readonly<{
+    boundaryId: DesignBoundaryId;
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    treatment: DecorativeTransitionIntent;
+    source: TSource;
+}>;
+/**
+ * The public, intent-only form of a join sent to renderers. The boundary id is
+ * derivable from the two block ids (`makeBoundaryId`), and the source stays
+ * internal. The renderer decides whether each join draws, from final content.
+ */
+export type PageRuntimeJoin<TBlockId extends string = string> = Readonly<{
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    treatment: DecorativeTransitionIntent;
+}>;
+/** Narrows any join (a resolved intent included) to its public, intent-only form. */
+export declare function toPageRuntimeJoin<TBlockId extends string>(join: PageRuntimeJoin<TBlockId>): PageRuntimeJoin<TBlockId>;
+export type JoinIssue = Extract<PageDesignEditorIssue, Readonly<{
+    kind: 'pinned-boundary-option-unavailable';
+}>>;
+/**
+ * What became of the user's pin, if the candidates carried one. The editor
+ * shows a pin by this status; the unavailable-pin issue is built from it.
+ */
+export type JoinPinStatus = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'supported';
+}> | Readonly<{
+    kind: 'unsupported';
+    /** The pin's own option id, or the option the join fell back to. */
+    optionId: BoundaryOptionId;
+}>;
+export type JoinTreatmentResolution<TBlockId extends DesignBlockId = DesignBlockId, TSource extends JoinTreatmentSource = JoinTreatmentSource> = Readonly<{
+    join: JoinIntent<TBlockId, TSource> | null;
+    /**
+     * The source of the winning candidate, kept even when that candidate was
+     * `none` and so yields no join. Null only when no candidate was usable.
+     */
+    selectedSource: TSource | null;
+    pin: JoinPinStatus;
+    issues: readonly JoinIssue[];
+}>;
+/**
+ * The single rule set for which treatment a join gets. Candidates arrive in
+ * priority order; the first supported one wins.
+ *
+ * - `none` ends the search and yields no join.
+ * - An unsupported candidate (a legacy option id, or a structured treatment the
+ *   catalogue lacks) falls through to the next one. When it was the user's
+ *   pin, the pin is reported unsupported and the existing
+ *   `pinned-boundary-option-unavailable` issue is raised.
+ */
+export declare function resolveJoinTreatment<TBlockId extends DesignBlockId, TSource extends JoinTreatmentSource>(input: Readonly<{
+    candidates: readonly JoinTreatmentCandidate<TSource>[];
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+}>): JoinTreatmentResolution<TBlockId, TSource>;
+/**
+ * The page-design defaults for a join, in priority order: the site style's
+ * default break after the previous block, then the page-flow default, which
+ * is always last.
+ */
+export declare function pageDesignDefaultJoinCandidates(input: Readonly<{
+    siteStyleId: SiteStyleId;
+    pageFlowPresetId: PageDesignDecisions['pageFlowPresetId'];
+    previousBlockKind: string;
+}>): readonly JoinTreatmentCandidate<PageDesignDefaultJoinSource>[];
+/** The last-resort page-design default, also the source of a fully unsupported join. */
+export declare function pageFlowDefaultJoinCandidate(pageFlowPresetId: PageDesignDecisions['pageFlowPresetId']): JoinTreatmentCandidate<Extract<PageDesignDefaultJoinSource, {
+    kind: 'page-flow-default';
+}>>;
+/**
+ * Page-design source adapter. Priority: the user's pin, then the defaults.
+ * The pin is offered even when unsupported so the rule function can report it.
+ */
+export declare function joinCandidatesFromPageDesign<TBlockId extends DesignBlockId>(intent: PageDesignDecisions<TBlockId>, siteStyleId: SiteStyleId, previous: Readonly<{
+    blockId: TBlockId;
+    blockKind: string;
+}>, next: Readonly<{
+    blockId: TBlockId;
+}>): readonly JoinTreatmentCandidate<PageDesignJoinSource>[];
+/**
+ * Generated-design source adapter. Mirrors today's materialisation: the
+ * boundary intent's explicit choice, then the block design's explicit choice,
+ * then the automatic default of no break.
+ */
+export declare function joinCandidatesFromGeneratedIntent(block: GeneratedPageDesignBlockIntent): readonly JoinTreatmentCandidate<GeneratedJoinSource>[];

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

@@ -0,0 +1,31 @@
+import { type PageDesignChoice, type PageDesignDecisions } from './pageDesignIntent';
+import type { PageDesignEditorBlock, PageDesignEditorBoundary, PageDesignEditorIssue, PageDesignEditorReadModel } from './pageDesignEditorModel';
+import { type SectionBoundaryTreatment } from './sectionTransitions';
+import { type DesignBlockId, type SiteStyleId } from './types';
+/**
+ * The editor's boundary read models. Each join's treatment, and where it came
+ * from, is decided by `resolveJoinTreatment`; this module only projects that
+ * resolution onto what the editor shows (issue 1422).
+ */
+type BoundaryReadModelResult<TBlockId extends DesignBlockId> = Readonly<{
+    boundary: PageDesignEditorBoundary<TBlockId>;
+    issues: readonly PageDesignEditorIssue<TBlockId>[];
+}>;
+export declare function buildBoundaryReadModels<TBlockId extends DesignBlockId>(input: Readonly<{
+    siteStyleId: SiteStyleId;
+    intent: PageDesignDecisions<TBlockId>;
+    blocks: readonly PageDesignEditorBlock<TBlockId>[];
+}>): readonly BoundaryReadModelResult<TBlockId>[];
+/**
+ * Re-resolves one boundary of an editor model for a changed break choice,
+ * through the same rules the model was built with. The preview uses it for
+ * optimistic updates, so a reset lands on whichever default the rules pick
+ * (site style or Page Flow). Null when either block is not in the model.
+ */
+export declare function resolvePageDesignEditorBoundaryForChoice<TBlockId extends DesignBlockId>(input: Readonly<{
+    editorModel: Pick<PageDesignEditorReadModel<TBlockId>, 'siteStyleId' | 'pageFlow' | 'blocks'>;
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    choice: PageDesignChoice<SectionBoundaryTreatment>;
+}>): PageDesignEditorBoundary<TBlockId> | null;
+export {};

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

@@ -2,17 +2,14 @@ import { type PageDesignEditorBackgroundSupport } from './pageDesignEditorCapabi
 import type { BlockDesignMetadata } from './blockFlow';
 import { type PageDesignDecisions } from './pageDesignIntent';
 import { type AppearancePresetId, type BlockDesignCapability, type CardRoleCapability, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId } from './types';
-import { type BoundaryOption } from './sectionTransitions';
+import type { BoundaryOption } from './sectionTransitions';
+import { type PageFlowPreset } from './pageFlowPresets';
+import type { PageDesignDefaultJoinSource } from './joinTreatment';
 import type { PageDesignEditorBlockContentRevision, PageDesignEditorLayoutOption, PageDesignEditorLookOption, PageDesignEditorLooksForLayout } from './pageDesignEditorOptions';
 export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
+export { resolvePageDesignEditorBoundaryForChoice } from './pageDesignEditorBoundaries';
+export { pageFlowPresets, type PageFlowBoundaryStrategy, type PageFlowPreset, } from './pageFlowPresets';
 export type { PageDesignEditorBlockContentRevision, PageDesignEditorLayoutOption, PageDesignEditorLookOption, PageDesignEditorLooksForLayout, } from './pageDesignEditorOptions';
-export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
-export type PageFlowPreset = Readonly<{
-    id: PageFlowPresetId;
-    label: string;
-    boundaryStrategy: PageFlowBoundaryStrategy;
-    defaultBoundaryOptionId: BoundaryOptionId;
-}>;
 export type PageDesignEditorBlockInput<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     blockId: TBlockId;
     blockKind: string;
@@ -35,7 +32,9 @@ export declare function autoEditorChoice<TValue>(effectiveValue: TValue | null):
 export declare function userPinnedEditorChoice<TValue>(value: TValue, input?: Readonly<{
     status?: 'supported' | 'unsupported';
     effectiveValue?: TValue | null;
-}>): PageDesignEditorChoice<TValue>;
+}>): Extract<PageDesignEditorChoice<TValue>, Readonly<{
+    kind: 'user-pinned';
+}>>;
 export type PageDesignEditorSelection<TValue> = Readonly<{
     kind: 'selected';
     value: TValue;
@@ -79,11 +78,35 @@ export declare const backgroundImagePromotedFieldPath: "_sectionStyles.backgroun
  */
 export declare const normalEditorCuratedPromotedFieldPaths: readonly ["_sectionStyles.background.image"];
 export type NormalEditorCuratedPromotedFieldPath = (typeof normalEditorCuratedPromotedFieldPaths)[number];
+/**
+ * Where an `auto` break comes from. A site-style default and a page-flow
+ * default are both defaults, not user choices, but the editor labels them
+ * differently.
+ */
+export type PageDesignEditorBoundaryDefaultSource = PageDesignDefaultJoinSource;
+/**
+ * A break choice as the editor shows it. It is assignable to
+ * `PageDesignEditorChoice<BoundaryOptionId>`; `auto` additionally says which
+ * default applies.
+ */
+export type PageDesignEditorBoundaryChoice = Readonly<{
+    kind: 'auto';
+    source: PageDesignEditorBoundaryDefaultSource;
+    effectiveValue: BoundaryOptionId | null;
+}> | Extract<PageDesignEditorChoice<BoundaryOptionId>, Readonly<{
+    kind: 'user-pinned';
+}>>;
 export type PageDesignEditorBoundary<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     boundaryId: DesignBoundaryId;
     previousBlockId: TBlockId;
     nextBlockId: TBlockId;
-    breakChoice: PageDesignEditorChoice<BoundaryOptionId>;
+    breakChoice: PageDesignEditorBoundaryChoice;
+    /**
+     * `breakChoice.effectiveValue` is the one effective break, decided by
+     * `resolveJoinTreatment`; the render compiler derives the join's treatment
+     * from it. Whether the break draws is decided by the renderer from final
+     * content.
+     */
     availableBreaks: readonly BoundaryOption[];
 }>;
 export type PageDesignEditorIssue<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
@@ -126,25 +149,6 @@ export type PageDesignEditorReadModel<TBlockId extends DesignBlockId = DesignBlo
     boundaries: readonly PageDesignEditorBoundary<TBlockId>[];
     issues: readonly PageDesignEditorIssue<TBlockId>[];
 }>;
-/**
- * Must remain non-empty; downstream code indexes `[0]` as the documented default.
- */
-export declare const pageFlowPresets: readonly [{
-    readonly id: PageFlowPresetId;
-    readonly label: "Quiet";
-    readonly boundaryStrategy: "quiet";
-    readonly defaultBoundaryOptionId: BoundaryOptionId;
-}, {
-    readonly id: PageFlowPresetId;
-    readonly label: "Balanced";
-    readonly boundaryStrategy: "balanced";
-    readonly defaultBoundaryOptionId: BoundaryOptionId;
-}, {
-    readonly id: PageFlowPresetId;
-    readonly label: "Expressive";
-    readonly boundaryStrategy: "expressive";
-    readonly defaultBoundaryOptionId: BoundaryOptionId;
-}];
 export declare function buildPageDesignEditorReadModel<TBlockId extends DesignBlockId>(input: Readonly<{
     siteStyleId: SiteStyleId;
     intent: PageDesignDecisions<TBlockId>;

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

@@ -176,9 +176,9 @@ export declare const pageDesignBoundaryTreatmentSchema: z.ZodDiscriminatedUnion<
         double: "double";
     }>;
     symmetry: z.ZodEnum<{
+        drift: "drift";
         symmetrical: "symmetrical";
         asymmetrical: "asymmetrical";
-        drift: "drift";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"angle-edge">;
@@ -234,9 +234,9 @@ export declare const pageDesignUserPinnedBoundaryTreatmentChoiceSchema: z.ZodObj
             double: "double";
         }>;
         symmetry: z.ZodEnum<{
+            drift: "drift";
             symmetrical: "symmetrical";
             asymmetrical: "asymmetrical";
-            drift: "drift";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"angle-edge">;
@@ -305,9 +305,9 @@ export declare const pageDesignBoundaryPinSchema: z.ZodObject<{
                 double: "double";
             }>;
             symmetry: z.ZodEnum<{
+                drift: "drift";
                 symmetrical: "symmetrical";
                 asymmetrical: "asymmetrical";
-                drift: "drift";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"angle-edge">;
@@ -417,9 +417,9 @@ export declare const pageDesignIntentV2Schema: z.ZodObject<{
                     double: "double";
                 }>;
                 symmetry: z.ZodEnum<{
+                    drift: "drift";
                     symmetrical: "symmetrical";
                     asymmetrical: "asymmetrical";
-                    drift: "drift";
                 }>;
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"angle-edge">;

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

@@ -0,0 +1,36 @@
+import { type BoundaryOptionId, type PageFlowPresetId } from './types';
+export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
+export type PageFlowPreset = Readonly<{
+    id: PageFlowPresetId;
+    label: string;
+    boundaryStrategy: PageFlowBoundaryStrategy;
+    defaultBoundaryOptionId: BoundaryOptionId;
+}>;
+/**
+ * Must remain non-empty; downstream code indexes `[0]` as the documented default.
+ */
+export declare const pageFlowPresets: readonly [{
+    readonly id: PageFlowPresetId;
+    readonly label: "Quiet";
+    readonly boundaryStrategy: "quiet";
+    readonly defaultBoundaryOptionId: BoundaryOptionId;
+}, {
+    readonly id: PageFlowPresetId;
+    readonly label: "Balanced";
+    readonly boundaryStrategy: "balanced";
+    readonly defaultBoundaryOptionId: BoundaryOptionId;
+}, {
+    readonly id: PageFlowPresetId;
+    readonly label: "Expressive";
+    readonly boundaryStrategy: "expressive";
+    readonly defaultBoundaryOptionId: BoundaryOptionId;
+}];
+/**
+ * The break a join gets when nothing more specific applies. An unknown preset
+ * id (a stale or policy-owned one) falls back to the first boundary option,
+ * and `preset` is null so callers can tell the two apart.
+ */
+export declare function pageFlowDefaultBoundary(pageFlowPresetId: PageFlowPresetId): Readonly<{
+    preset: PageFlowPreset | null;
+    boundaryOptionId: BoundaryOptionId;
+}>;

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

@@ -5,7 +5,7 @@ import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId } from './footerLooks';
 import type { SiteThemeCompilationPlan } from './compilationPlan';
 import type { HeaderLayoutStyleSelection } from './headerLayoutStyles';
-import { type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
+import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';
 import { type CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
 import type { SelectionFallbackWarning } from './selectionFallbackWarning';
@@ -20,13 +20,14 @@ export type { CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
  * enforced by `previewCompiler.client-boundary.test.ts`.
  */
 export { defineBlockDesignMetadata, type BlockDesignMetadata, type BlockDesignMetadataInput, type BlockDesignMetadataMap, type BlockFlowBoundaryPreference, type BlockFlowContract, type BlockFlowSurfaceBehavior, type BlockFlowWeight, type BlockLayoutBoundaryBias, type BlockLayoutDesignProfile, type BlockLayoutDesignProfileInput, type BlockLayoutFamily, type BlockLayoutVisualWeight, type PageFlowRole, } from './blockFlow';
-export { buildPageDesignEditorReadModel, boundaryOptions, pageFlowPresets, type BoundaryOption, type PageDesignEditorBlock, type PageDesignEditorBoundary, type PageDesignEditorChoice, type PageDesignEditorIssue, type PageDesignEditorReadModel, type PageDesignEditorSelection, type PageFlowPreset, } from './pageDesignEditorModel';
+export { buildPageDesignEditorReadModel, boundaryOptions, pageFlowPresets, type BoundaryOption, type PageDesignEditorBlock, type PageDesignEditorBoundary, type PageDesignEditorBoundaryChoice, type PageDesignEditorBoundaryDefaultSource, type PageDesignEditorChoice, type PageDesignEditorIssue, type PageDesignEditorReadModel, type PageDesignEditorSelection, type PageFlowPreset, } from './pageDesignEditorModel';
 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, compileBoundaryRuntime, compilePageRuntimeFields, compileTokenRecipes, compileTransitionRuntime, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
+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 { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
 export { curatedSiteStyles, defaultButtonStyleSelectionForSiteStyle, defaultPaletteForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
+export { toPageRuntimeJoin, type PageRuntimeJoin, } from './joinTreatment';
 export { asDesignBlockId, asSiteStyleId, makeBoundaryId, type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type ResolvedPageDesignPlan, type SiteStyleId, } from './types';
 export declare const previewCustomizePurpose: "preview-customize";
 /**
@@ -99,15 +100,8 @@ export type CompileEditorModelRuntimeInput<TBlockId extends DesignBlockId = Desi
  */
 export declare function compileEditorModelRuntime<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): CompiledPageRuntime<TBlockId>;
 export declare function buildEditorModelRuntimeFieldsByBlockId<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): ReadonlyMap<TBlockId, CompiledBlockRuntimeFields>;
-export declare function buildEditorModelRuntimeBoundaries<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): readonly CompiledBoundaryRuntime<TBlockId>[];
 export declare function compileEditorModelRuntimeFieldsForBlock<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId> & Readonly<{
     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 retargetCompiledBoundaryRuntimeForContentAdjacency<TBlockId extends string>(boundary: CompiledBoundaryRuntime<TBlockId>, adjacency: RuntimeContentAdjacency): CompiledBoundaryRuntime<TBlockId>;
 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,14 +1,27 @@
-export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup"];
+export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles"];
 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;
+/**
+ * `styleGroup` is authored content (a theme's style-group select, or an SDK
+ * site's own value), not compiler output, so it is neither a runtime field
+ * nor compiler-owned. Normal editors still never show it directly.
+ */
+export type ThemeV2NormalEditorRawStyleFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName | 'styleGroup';
 export type ThemeV2CompilerOwnedFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
-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 themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles", "styleGroup"];
+export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare const pageDesignEditorBackgroundOverrideOwner: "page-design-editor";
 export type PageDesignEditorBackgroundOverrideOwner = typeof pageDesignEditorBackgroundOverrideOwner;
 export declare const siteChromeBackgroundOverrideOwner: "site-chrome-editor";
 export type SiteChromeBackgroundOverrideOwner = typeof siteChromeBackgroundOverrideOwner;
 export declare function isThemeV2NormalEditorRawStyleFieldName(fieldName: string): boolean;
 export declare function isThemeV2NormalEditorRawStylePath(fieldPath: string): boolean;
+/**
+ * A `styleGroup` in the retired `site-style-transition-*` namespace is residue
+ * from the old per-block transition path (issue 1422). Any other value is
+ * authored and must survive.
+ */
+export declare function isStaleTransitionStyleGroup(value: unknown): boolean;
+/** Drops a stale transition `styleGroup`, leaving authored values untouched. */
+export declare function stripStaleTransitionStyleGroup(content: Readonly<Record<string, unknown>>): Record<string, unknown>;