@riverbankcms/sdk 0.60.16 → 0.62.4

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

@@ -1,5 +1,5 @@
 import type { Theme } from '../schema';
-type Brand<T, TBrand extends string> = T & {
+export type Brand<T, TBrand extends string> = T & {
     readonly __brand: TBrand;
 };
 export type DesignBlockId = Brand<string, 'DesignBlockId'>;
@@ -87,7 +87,7 @@ export type ContentVersionOwner = Readonly<{
 export type DesignResolutionPolicy = 'generated' | 'user' | 'admin' | 'sdk';
 export type DesignIssueSeverity = 'blocking' | 'repairable' | 'advisory';
 export declare function designIssueSeverityForPolicy(policy: DesignResolutionPolicy): DesignIssueSeverity;
-export type SiteStyleSurfaceIntent = 'base' | 'muted-band' | 'accent-band' | 'hero-image';
+export type SiteStyleSurfaceIntent = 'base' | 'muted-band' | 'accent-band' | 'brand-depth-band' | 'hero-image';
 export type SiteStyleItemSurfaceIntent = 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial';
 export type SiteStyleSectionTransitionIntent = 'none' | 'soft-fade-short' | 'soft-fade-long' | 'wave-edge' | 'angle-edge';
 export type SiteStyleEmphasis = 'low' | 'medium' | 'high';
@@ -188,6 +188,8 @@ export type ImageSurfaceTreatment = Readonly<{
 }>;
 export type ImageSurfaceTreatmentKind = ImageSurfaceTreatment['kind'];
 export type TestimonialCardTreatment = 'default' | 'accent-quote';
+export declare const tileTreatmentValues: readonly ["default", "quiet", "brand-depth"];
+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 type GeneratedMediaCompositionIntent = Extract<MediaCompositionIntent, 'none' | 'supporting' | 'dominant'>;
@@ -342,6 +344,7 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
+    tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
 }>;
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
@@ -354,6 +357,7 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedImageSurfaceTreatment: ImageSurfaceTreatment;
     appliedImageSurfaceMotion: ImageSurfaceMotion;
     appliedTestimonialCardTreatment: TestimonialCardTreatment;
+    appliedTileTreatment: TileTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
 }>;
 export type PageDesignState<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -373,6 +377,7 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     imageSurfaceTreatments?: NonEmptyReadonlyArray<ImageSurfaceTreatmentKind>;
     imageSurfaceMotions?: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments?: NonEmptyReadonlyArray<TestimonialCardTreatment>;
+    tileTreatments?: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
@@ -384,6 +389,7 @@ export type DesignedBlockDesignCapability = Readonly<{
     imageSurfaceTreatments: NonEmptyReadonlyArray<ImageSurfaceTreatmentKind>;
     imageSurfaceMotions: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments: NonEmptyReadonlyArray<TestimonialCardTreatment>;
+    tileTreatments: NonEmptyReadonlyArray<TileTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
@@ -395,7 +401,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-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' | '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;
@@ -475,6 +481,17 @@ export type UnsupportedTestimonialCardTreatmentIssue<TBlockId extends string = D
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-testimonial-card-treatment'];
 }>;
+export type UnsupportedTileTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
+    kind: 'unsupported-tile-treatment';
+    blockId: TBlockId;
+    blockKind: string;
+    purpose: TPurpose;
+    requested: TileTreatment;
+    fallback: 'default';
+    policy: DesignResolutionPolicy;
+    severity: DesignIssueSeverity;
+    allowedRepairActions: readonly ['fallback-tile-treatment'];
+}>;
 export type UnsupportedEyebrowTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-eyebrow-treatment';
     blockId: TBlockId;
@@ -531,6 +548,7 @@ export type BlockDesignCapabilityRequest = Readonly<{
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
+    tileTreatment?: TileTreatment;
     eyebrowTreatment?: EyebrowTreatment;
 }>;
 export type BlockDesignCapabilityFallback = Readonly<{
@@ -545,6 +563,7 @@ export type BlockDesignCapabilityFallback = Readonly<{
     }>;
     imageSurfaceMotion: 'static';
     testimonialCardTreatment: 'default';
+    tileTreatment: 'default';
     eyebrowTreatment: 'plain';
 }>;
 export type MissingBlockDesignCapabilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
@@ -592,7 +611,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> | 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> | 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';
@@ -616,4 +635,3 @@ export type SiteStyleSwitchResult<TBlockId extends string = DesignBlockId, TPurp
     incompatibleBlockIds: readonly TBlockId[];
     fallbackBlockIds: readonly TBlockId[];
 }>;
-export {};

package/dist/_dts/theme-core/src/siteChrome.d.ts

@@ -0,0 +1,53 @@
+import React, { type ReactNode } from "react";
+import type { Theme } from "./schema";
+export type SiteTopShellBehavior = "normal-flow" | "shared-sticky-shell" | "banner-above-overlay-header";
+export type SiteTopShellPlan = Readonly<{
+    behavior: "normal-flow";
+    contentStartsUnderHeader: boolean;
+    requiresHeaderOffset: false;
+}> | Readonly<{
+    behavior: "shared-sticky-shell";
+    contentStartsUnderHeader: false;
+    requiresHeaderOffset: false;
+}> | Readonly<{
+    behavior: "banner-above-overlay-header";
+    contentStartsUnderHeader: true;
+    requiresHeaderOffset: true;
+}>;
+export type SiteChromeLayoutNodes = Readonly<{
+    headerNode: ReactNode;
+    bannerNode?: ReactNode;
+    bannerShellBehavior?: SiteTopShellBehavior;
+    footerNode: ReactNode;
+}>;
+type HeaderPositioning = NonNullable<Theme["header"]>["positioning"];
+export type SiteDocumentLayoutMode = "normal-flow" | "header-overlay";
+export type SiteDocumentPlan = Readonly<{
+    topShell: SiteTopShellPlan;
+    layoutMode: SiteDocumentLayoutMode;
+}>;
+export type SiteDocumentPlanInput = Readonly<{
+    headerPositioning: HeaderPositioning;
+    headerVariant?: Theme["header"]["variant"] | null;
+    hasVisibleBanner: boolean;
+}>;
+export type SiteDocumentLayoutProps = Omit<SiteChromeLayoutNodes, "bannerShellBehavior"> & Readonly<{
+    plan: SiteDocumentPlan;
+    children: ReactNode;
+    as?: "div" | "main";
+    role?: string;
+    className?: string | null;
+    minHeightClassName?: string | null;
+    contentClassName?: string | null;
+    style?: React.CSSProperties;
+}>;
+export declare function getStandaloneHeaderShellClassName(theme: Theme): string | null;
+export declare function renderSiteTopChrome({ headerNode, bannerNode, bannerShellBehavior, }: Pick<SiteChromeLayoutNodes, "headerNode" | "bannerNode" | "bannerShellBehavior">): ReactNode;
+export declare function planSiteDocument(input: SiteDocumentPlanInput): SiteDocumentPlan;
+export declare function SiteDocumentLayout({ plan, headerNode, bannerNode, footerNode, children, as: Root, role, className, minHeightClassName, contentClassName, style, }: SiteDocumentLayoutProps): React.ReactElement;
+export declare function planSiteTopShell(input: Readonly<{
+    headerPositioning: HeaderPositioning;
+    headerVariant?: Theme["header"]["variant"] | null;
+    hasVisibleBanner: boolean;
+}>): SiteTopShellPlan;
+export {};

package/dist/_dts/theme-core/src/tokens/colorTokenParts.d.ts

@@ -0,0 +1,13 @@
+export type ColorTokenParts = {
+    readonly kind: 'token';
+    readonly token: string;
+    readonly opacityPercent: number | null;
+} | {
+    readonly kind: 'raw';
+    readonly value: string;
+} | {
+    readonly kind: 'invalid';
+    readonly token: string;
+};
+export declare function parseOpacityPercent(source: string): number | null;
+export declare function parseColorTokenParts(source: string): ColorTokenParts;

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

@@ -1,3 +1,5 @@
 export * from "./tokens";
 export * from "./blockColorTokens";
+export * from "./themeColorTokens";
+export * from "./colorTokenParts";
 export { TokenResolver } from "./resolver";

package/dist/_dts/theme-core/src/tokens/themeColorTokens.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+/**
+ * Known palette role token names. This is the low-level source of truth for
+ * palette roles used by palette variants, Theme V2 schemas, and runtime color
+ * reference parsing.
+ */
+export declare const PALETTE_TOKEN_NAMES: readonly ["primary", "primaryForeground", "secondary", "accent", "success", "warning", "destructive", "background", "surface", "surfaceAlt", "muted", "text", "border"];
+export type PaletteTokenName = (typeof PALETTE_TOKEN_NAMES)[number];
+export declare const paletteTokenNameSchema: z.ZodEnum<{
+    success: "success";
+    text: "text";
+    surface: "surface";
+    warning: "warning";
+    border: "border";
+    background: "background";
+    primary: "primary";
+    secondary: "secondary";
+    primaryForeground: "primaryForeground";
+    accent: "accent";
+    destructive: "destructive";
+    surfaceAlt: "surfaceAlt";
+    muted: "muted";
+}>;
+export type ThemeColorToken = string & {
+    readonly __brand: 'ThemeColorToken';
+};
+export declare function isThemeColorToken(value: unknown): value is ThemeColorToken;
+export declare function parseThemeColorToken(value: unknown): ThemeColorToken | null;
+export declare const themeColorTokenSchema: z.ZodString;

package/dist/_dts/theme-core/src/utils/tokenOrColor.d.ts

@@ -1,10 +1,36 @@
+import { z } from 'zod';
+import { type ThemeColorToken } from '../tokens/themeColorTokens';
 export type TokenOrColor = string;
+/**
+ * Runtime color-reference fields intentionally accept any string, including
+ * the legacy empty-string "no color" sentinel. Semantic validation needs
+ * palette context and happens in `parseThemeColorReference`.
+ */
+export declare const tokenOrCssColorValueSchema: z.ZodString;
+export type PaletteContextColorToken = string & {
+    readonly __brand: 'PaletteContextColorToken';
+};
+export type ThemeColorReference = {
+    kind: 'theme-token';
+    token: ThemeColorToken;
+} | {
+    kind: 'palette-context-token';
+    token: PaletteContextColorToken;
+} | {
+    kind: 'literal-css';
+    value: string;
+};
+export type ThemeColorReferenceContext = {
+    palette?: Readonly<Record<string, string>>;
+};
 type ParsedToken = {
     role: string;
     shade: number | null;
 };
 export declare function isCssColorLiteral(value: string): boolean;
 export declare function parseThemeToken(token: string): ParsedToken;
-export declare function resolveTokenOrCssColorValue(input: TokenOrColor): string;
+export declare function parseThemeColorReference(input: TokenOrColor, context?: ThemeColorReferenceContext): ThemeColorReference;
+export declare function resolveThemeColorReferenceValue(input: TokenOrColor, context?: ThemeColorReferenceContext): string;
+export declare function resolveTokenOrCssColorValue(input: TokenOrColor, context?: ThemeColorReferenceContext): string;
 export declare function resolveOnColorForThemeToken(token: string): string | null;
 export {};