@riverbankcms/sdk 0.129.1 → 0.130.2

package/dist/_dts/theme-core/src/header/legacyHeaderVariant.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * The header variants the system actually renders.
+ *
+ * Each one has a layout row in the site-header block and a paint target in
+ * `paintTargets.ts`. This is the canonical list: the block transform's variant
+ * class allowlist and the AI theme generator's enum both derive from it, so
+ * they cannot drift.
+ */
+export declare const headerVariantValues: readonly ["classic", "centered", "floating"];
+export declare const headerVariantSchema: z.ZodEnum<{
+    classic: "classic";
+    centered: "centered";
+    floating: "floating";
+}>;
+export type HeaderVariant = z.infer<typeof headerVariantSchema>;
+/**
+ * Header variant spellings that were once authorable but no longer name a
+ * layout of their own, and the variant they read as now.
+ *
+ * `transparent` was an overlay header with no CSS of its own: everything it
+ * did (transparent root background, overlay content flow) is what `floating`
+ * already does, and it had zero persisted usage in production or locally when
+ * it was retired. It survives here as a one-boundary alias so a theme authored
+ * against the old vocabulary still parses.
+ *
+ * This matters because the theme schema is strict and has no per-field
+ * `.catch()`: an out-of-enum variant fails `themeSchema.safeParse` for the
+ * *whole* theme, which silently swaps the site's theme for
+ * `modernMinimalTheme`. Aliasing here keeps that from happening.
+ */
+export declare const legacyHeaderVariants: {
+    readonly transparent: "floating";
+};
+export type LegacyHeaderVariantValue = keyof typeof legacyHeaderVariants;
+/**
+ * The header variant boundary for themes that go through `themeSchema`:
+ * canonical variants pass through, legacy spellings normalize to the variant
+ * they meant, everything else fails the parse.
+ *
+ * Deliberately an enum plus a transform rather than a `z.preprocess`, so the
+ * schema's *input* type stays an accurate union (the legacy spelling is still
+ * accepted on the wire) instead of widening to `unknown`. `SdkThemeWire` in
+ * `@riverbankcms/api` is `z.input<typeof themeSchema>`, so a widened input here
+ * would leak straight into a public type.
+ *
+ * Not every read of a persisted theme goes through the schema:
+ * `resolveRuntimeTheme` in
+ * `apps/dashboard/src/server/services/sites/runtimeSiteResponse.ts` returns the
+ * raw database JSON asserted as `Theme` with no parse, so a theme still
+ * carrying a legacy spelling reaches the theme editor un-aliased. That gap
+ * predates this alias and is harmless while persisted usage is zero.
+ */
+export declare const headerVariantWithLegacyAliasSchema: z.ZodPipe<z.ZodEnum<{
+    classic: "classic";
+    centered: "centered";
+    floating: "floating";
+    transparent: "transparent";
+}>, z.ZodTransform<"classic" | "centered" | "floating", "classic" | "centered" | "floating" | "transparent">>;

package/dist/_dts/theme-core/src/header/paintTargets.d.ts

@@ -1,4 +1,4 @@
-type HeaderLayoutVariant = 'classic' | 'centered' | 'transparent' | 'floating';
+import type { HeaderVariant } from './legacyHeaderVariant';
 type ElementBoxPaintTarget = Readonly<{
     kind: 'element-box';
     selector: string;
@@ -26,6 +26,6 @@ type ViewportBandPaintTarget = Readonly<{
 }>;
 export type HeaderPaintTarget = ElementBoxPaintTarget | ViewportBandPaintTarget;
 /** Resolve the element that owns the visible header surface for each layout. */
-export declare function getHeaderPaintTargets(variant: HeaderLayoutVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
+export declare function getHeaderPaintTargets(variant: HeaderVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
 export declare function renderHeaderPaintTargetRules(targets: readonly HeaderPaintTarget[], rules: readonly string[]): string;
 export {};

package/dist/_dts/theme-core/src/header/scrollTreatment.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { HeaderVariant } from './legacyHeaderVariant';
 export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"contrast-glass">;
     backgroundTone: z.ZodEnum<{
@@ -7,5 +8,5 @@ export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminat
     }>;
 }, z.core.$strip>], "kind">>;
 export type HeaderScrollTreatment = z.infer<typeof headerScrollTreatmentSchema>;
-export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating'): string;
-export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating', surfaceRules?: readonly string[]): string;
+export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: HeaderVariant): string;
+export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: HeaderVariant, surfaceRules?: readonly string[]): string;