@riverbankcms/sdk 0.143.0 → 0.145.0

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

@@ -2,8 +2,8 @@ import { type CardStylesOverride, type ContainerStylesOverride, type SectionStyl
 import { type ExpandedPalette } from '../palette/expandPalette';
 import { type ButtonStyleSelection } from '../buttons/styles';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
-import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
-import { type SectionBoundaryRuntimeMetrics } from './sectionTransitions';
+import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBlockId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
+import { type PageRuntimeJoin } from './joinTreatment';
 import { type ThemeColorToken } from '../tokens';
 import { type GradientPresetId } from '../gradients';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
@@ -39,7 +39,6 @@ export type DesignRuntimeRules = Readonly<{
     sectionSurfaces: Readonly<Record<SiteStyleSurfaceIntent, SectionSurfaceRuntimeRule>>;
     defaultEyebrowTreatment?: EyebrowTreatment;
     heroLegibility: Readonly<Record<Exclude<NonNullable<ResolvedBlockDesignPlan['appliedHeroLegibility']>, 'none'>, NonNullable<ImageSectionBackgroundOverride['overlay']>>>;
-    transitionClassName: (transition: SiteStyleSectionTransitionIntent, fromSurface: SiteStyleSurfaceIntent, toSurface: SiteStyleSurfaceIntent) => string | null;
 }>;
 export type ComponentRuntimeRules = Readonly<{
     panelFrames: Readonly<Record<PanelFrameTreatment, ContainerStylesOverride>>;
@@ -52,40 +51,8 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _contentCardStyles?: ContainerStylesOverride;
     _heroLayoutStyles?: HeroLayoutStylesOverride;
     _cardStyles?: CardStylesOverride;
-    _transitionStyles?: CompiledTransitionRuntime;
     blockLook?: string;
     blockComposition?: BlockCompositionIntent;
-    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 CompiledBoundaryRuntime<TBlockId extends string = string> = Readonly<{
-    boundaryId: DesignBoundaryId | string;
-    previousBlockId: TBlockId;
-    nextBlockId: TBlockId;
-    treatment: SiteStyleSectionTransitionIntent;
-    metrics: SectionBoundaryRuntimeMetrics;
-    from: CompiledTransitionEndpoint;
-    to: CompiledTransitionEndpoint;
-    cssVars: Readonly<{
-        from: string;
-        to: string;
-    }>;
-    styleGroup: string;
 }>;
 export type HeroLayoutStylesOverride = Readonly<{
     contentAlignment?: 'left' | 'center' | 'right';
@@ -93,7 +60,11 @@ export type HeroLayoutStylesOverride = Readonly<{
     contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
     typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "_transitionStyles", "blockLook", "blockComposition", "styleGroup"];
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "blockLook", "blockComposition"];
+/**
+ * Removes every compiler-owned field, plus a stale transition `styleGroup`.
+ * An authored `styleGroup` is content and survives.
+ */
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;
@@ -113,12 +84,6 @@ export type CompileBlockRuntimeInput<TBlockId extends string, TPurpose extends s
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
-    sectionAdjacency?: SectionAdjacency;
-    /**
-     * @deprecated Prefer `sectionAdjacency`. Kept for isolated block callers that
-     * compile one block with an explicit following section surface.
-     */
-    nextSectionSurface?: SiteStyleSurfaceIntent;
 }>;
 export type CompileBlockRuntimeIntoContentInput<TBlockId extends string, TPurpose extends string, TContent extends Record<string, unknown>> = CompileBlockRuntimeInput<TBlockId, TPurpose> & Readonly<{
     content: TContent;
@@ -128,25 +93,13 @@ export type CompiledPageRuntime<TBlockId extends string = string> = Readonly<{
     blocks: readonly (CompiledBlockRuntime & Readonly<{
         blockId: TBlockId;
     }>)[];
-    boundaries: readonly CompiledBoundaryRuntime<TBlockId>[];
+    joins: readonly PageRuntimeJoin<TBlockId>[];
 }>;
-export type SectionAdjacency = Readonly<{
-    kind: 'next-section';
-    surface: SiteStyleSurfaceIntent;
-}> | Readonly<{
-    kind: 'terminal-surface';
-    surface: SiteStyleSurfaceIntent;
-}> | Readonly<{
-    kind: 'page-end';
-}>;
-export type TerminalSectionAdjacency = Extract<SectionAdjacency, Readonly<{
-    kind: 'terminal-surface' | 'page-end';
-}>>;
 export declare function defineDesignRuntimeRules<const TRules extends DesignRuntimeRules>(rules: TRules): TRules;
 export declare function defineComponentRuntimeRules<const TRules extends ComponentRuntimeRules>(rules: TRules): TRules;
 /**
  * Default design rules translate semantic page-level choices into the current
- * runtime's section background and transition style-group vocabulary.
+ * runtime's section background vocabulary.
  */
 export declare const defaultDesignRuntimeRules: {
     readonly sectionSurfaces: {
@@ -193,7 +146,6 @@ export declare const defaultDesignRuntimeRules: {
             readonly opacity: 0.88;
         };
     };
-    readonly transitionClassName: (transition: SiteStyleSectionTransitionIntent, fromSurface: SiteStyleSurfaceIntent, toSurface: SiteStyleSurfaceIntent) => string | null;
 };
 /**
  * Default component rules translate frame and item-surface semantics into the
@@ -245,33 +197,27 @@ 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;
-export declare function compileBoundaryRuntime<TBlockId extends string>(input: Readonly<{
-    boundaryId: DesignBoundaryId | string;
-    previousBlockId: TBlockId;
-    nextBlockId: TBlockId;
-    treatment: SiteStyleSectionTransitionIntent;
-    fromSurface: SiteStyleSurfaceIntent;
-    toSurface: SiteStyleSurfaceIntent;
-    rules?: DesignRuntimeRules;
-}>): CompiledBoundaryRuntime<TBlockId> | null;
 /**
  * Compiles block runtime fields and writes them into content only when Theme V2
  * owns that block's runtime-style fields.
  */
 export declare function compileBlockRuntimeFieldsIntoContent<TBlockId extends string, TPurpose extends string, TContent extends Record<string, unknown>>(input: CompileBlockRuntimeIntoContentInput<TBlockId, TPurpose, TContent>): RuntimeStyleWriteResultForFields<TContent, CompiledBlockRuntimeFields>;
-/** Compiles a resolved page plan into legacy runtime fields for each resolved block. */
-export declare function compilePageRuntimeFields<TBlockId extends string, TPurpose extends string>(input: Readonly<{
+/**
+ * Compiles a resolved page plan into legacy runtime fields for each resolved
+ * block, plus the public runtime joins between them.
+ *
+ * Joins come from `resolveJoinTreatment`; plans no longer carry a treatment.
+ * Only joins whose two blocks were compiled are kept, and they leave as intent
+ * only: the blocks renderer composes each one from final content after
+ * omission, including whether it draws at all (issue 1422).
+ */
+export declare function compilePageRuntimeFields<TBlockId extends DesignBlockId, TPurpose extends string>(input: Readonly<{
     resolved: ResolvedPageDesignPlan<TBlockId, TPurpose>;
+    joins: readonly PageRuntimeJoin<TBlockId>[];
     surfaceResolutionContext: SurfaceResolutionContext;
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
-    terminalSectionAdjacency?: TerminalSectionAdjacency;
 }>): CompiledPageRuntime<TBlockId>;
 type PaletteCompileOptions = Readonly<{
     /** A complete concrete palette supplied by the theme/editor boundary. */

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

@@ -0,0 +1,95 @@
+import { type ThemeColorToken } from '../tokens/themeColorTokens';
+import type { DecorativeTransitionIntent } from './transitionCatalogue';
+import { type FrameKind } from './types';
+/**
+ * What one side of a join offers a boundary to paint with. Only theme tokens
+ * paint: media, gradients and literal colours cannot be matched by a flat
+ * shape, so they are unpainted and the boundary draws inside the other side.
+ */
+export type BoundaryEndpoint = Readonly<{
+    kind: 'paint';
+    token: ThemeColorToken;
+}> | Readonly<{
+    kind: 'unpainted';
+    reason: 'media' | 'gradient' | 'literal-color';
+}>;
+export type BoundaryComposition = Readonly<{
+    kind: 'paint-to-paint';
+    from: ThemeColorToken;
+    to: ThemeColorToken;
+}> | Readonly<{
+    kind: 'unpainted-to-paint';
+    to: ThemeColorToken;
+}> | Readonly<{
+    kind: 'paint-to-unpainted';
+    from: ThemeColorToken;
+}>;
+/**
+ * What composition needs to know about one side of a join, read from the
+ * content that finally renders: what the section paints with and the frame it
+ * draws.
+ */
+export type SectionFacts = Readonly<{
+    endpoint: BoundaryEndpoint;
+    frame: FrameKind;
+}>;
+export type BoundaryNotShownReason = 'both-unpainted' | 'flush-panel';
+export type BoundaryOutcome = Readonly<{
+    kind: 'shown';
+    composition: BoundaryComposition;
+}> | Readonly<{
+    kind: 'not-shown';
+    reason: BoundaryNotShownReason;
+}>;
+/**
+ * `centred` straddles the join; `previous` sits inside the previous section,
+ * anchored to its bottom; `next` sits inside the next section, anchored to its
+ * top and mirrored vertically.
+ */
+export type BoundaryPlacement = 'centred' | 'previous' | 'next';
+export type BoundaryLayout = Readonly<{
+    placement: BoundaryPlacement;
+    /**
+     * Extra section padding the boundary needs, as CSS lengths. `before` is
+     * reserved inside the previous section (above the join) and `after` inside
+     * the next section (below it). Null means no reserve on that side.
+     */
+    reserves: Readonly<{
+        before: string | null;
+        after: string | null;
+    }>;
+    paint: Readonly<{
+        band: ThemeColorToken | null;
+        shape: ThemeColorToken;
+    }>;
+}>;
+/**
+ * Classifies a section from its final render content. `_sectionStyles`
+ * already holds the effective background (Look default, page-design override
+ * and block-authored media merged by `resolveSectionBackground`), so this only
+ * reads it and never re-decides precedence. A missing or unparseable
+ * background is the page background, as it is for the renderer.
+ */
+export declare function boundaryEndpointForSectionContent(content: Record<string, unknown>): BoundaryEndpoint;
+/**
+ * Reads both facts from final render content in one place. `_frameStyles` is
+ * the compiled frame; content without one (no page design, an SDK block)
+ * draws a plain frame.
+ */
+export declare function sectionFactsForContent(content: Record<string, unknown>): SectionFacts;
+/**
+ * The frame rule: a flush panel owns the edge it runs to, so no break is
+ * drawn next to one. The single home for this rule; the generated
+ * pipeline's budget and the site-style lab ask it with their plan frames.
+ */
+export declare function frameNotShownReason(previous: FrameKind, next: FrameKind): Extract<BoundaryNotShownReason, 'flush-panel'> | null;
+/**
+ * Decides whether and how a join draws. The frame rule wins before paint is
+ * considered; two unpainted sides show nothing.
+ */
+export declare function composeBoundary(previous: SectionFacts, next: SectionFacts): BoundaryOutcome;
+/**
+ * Placement, reserves and paint for a shown boundary, derived from the
+ * composition and the catalogue's metrics for the treatment.
+ */
+export declare function boundaryLayout(intent: DecorativeTransitionIntent, composition: BoundaryComposition): BoundaryLayout;