@riverbankcms/sdk 0.2.0 → 0.2.1

package/dist/server/{chunk-SW7LE4M3.js → chunk-XLVL5WPH.js}

@@ -1,10 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkQQ6U4QX6js = require('./chunk-QQ6U4QX6.js');
+var _chunkHOY77YBFjs = require('./chunk-HOY77YBF.js');
+
+
+
+
+var _chunkEGTDJ4PLjs = require('./chunk-EGTDJ4PL.js');
 
 // src/config/validation.ts
 var _zod = require('zod');
-var _blocks = require('@riverbankcms/blocks');
 var sdkThemePaletteSchema = _zod.z.record(_zod.z.string(), _zod.z.string());
 var sdkThemeConfigSchema = _zod.z.object({
   palette: sdkThemePaletteSchema
@@ -43,7 +47,7 @@ var siteStyleConfigSchema = _zod.z.object({
   sectionOptions: sectionOptionsSchema,
   containerOptions: containerOptionsSchema
 }).optional();
-var sdkLoaderEndpointSchema = _zod.z.enum(_chunkQQ6U4QX6js.SUPPORTED_LOADER_ENDPOINTS);
+var sdkLoaderEndpointSchema = _zod.z.enum(_chunkHOY77YBFjs.SUPPORTED_LOADER_ENDPOINTS);
 var loaderParamBindingSchema = _zod.z.object({
   $bind: _zod.z.object({
     from: _zod.z.string().min(1, "Binding path is required"),
@@ -82,7 +86,7 @@ var blockFieldOptionsSchema = _zod.z.record(
   )
 ).optional();
 var blockFieldExtensionSchema = _zod.z.object({
-  fields: _blocks.fieldSchema.array().min(1, "At least one field is required")
+  fields: _chunkEGTDJ4PLjs.fieldSchema.array().min(1, "At least one field is required")
 }).refine(
   (data) => {
     return data.fields.every((field) => {
@@ -104,7 +108,7 @@ function validateFieldIdConflicts(blockFieldExtensions) {
   if (!blockFieldExtensions) return [];
   const conflicts = [];
   for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {
-    const definition = _blocks.getBlockDefinition.call(void 0, blockId);
+    const definition = _chunkEGTDJ4PLjs.getBlockDefinition.call(void 0, blockId);
     if (!definition) {
       conflicts.push({
         blockId,
@@ -150,11 +154,11 @@ var sdkCustomBlockSchema = _zod.z.object({
   title: _zod.z.string().min(1, "Title is required"),
   titleSource: _zod.z.string().optional(),
   description: _zod.z.string().optional(),
-  category: _blocks.blockCategoryEnum,
+  category: _chunkEGTDJ4PLjs.blockCategoryEnum,
   icon: _zod.z.string().optional(),
   tags: _zod.z.array(_zod.z.string()).optional(),
   // Reuse the exact field schema from @riverbankcms/blocks - all field types supported
-  fields: _blocks.fieldSchema.array().min(1, "Custom blocks must have at least one field"),
+  fields: _chunkEGTDJ4PLjs.fieldSchema.array().min(1, "Custom blocks must have at least one field"),
   // Data loaders for CMS endpoints
   dataLoaders: sdkDataLoadersSchema
 }).refine(
@@ -208,4 +212,4 @@ var riverbankSiteConfigSchema = _zod.z.object({
 
 
 exports.sdkThemePaletteSchema = sdkThemePaletteSchema; exports.sdkThemeConfigSchema = sdkThemeConfigSchema; exports.sectionBackgroundSchema = sectionBackgroundSchema; exports.sectionSpacingSchema = sectionSpacingSchema; exports.containerMaxWidthSchema = containerMaxWidthSchema; exports.containerAlignmentSchema = containerAlignmentSchema; exports.sectionOptionsSchema = sectionOptionsSchema; exports.containerOptionsSchema = containerOptionsSchema; exports.siteStyleConfigSchema = siteStyleConfigSchema; exports.sdkLoaderEndpointSchema = sdkLoaderEndpointSchema; exports.loaderParamBindingSchema = loaderParamBindingSchema; exports.loaderParamValueSchema = loaderParamValueSchema; exports.sdkConfigLoaderSchema = sdkConfigLoaderSchema; exports.sdkDataLoadersSchema = sdkDataLoadersSchema; exports.fieldSelectOptionSchema = fieldSelectOptionSchema; exports.blockFieldConfigSchema = blockFieldConfigSchema; exports.blockFieldOptionsSchema = blockFieldOptionsSchema; exports.blockFieldExtensionSchema = blockFieldExtensionSchema; exports.blockFieldExtensionsSchema = blockFieldExtensionsSchema; exports.validateFieldIdConflicts = validateFieldIdConflicts; exports.sdkCustomBlockSchema = sdkCustomBlockSchema; exports.riverbankSiteConfigSchema = riverbankSiteConfigSchema;
-//# sourceMappingURL=chunk-SW7LE4M3.js.map
+//# sourceMappingURL=chunk-XLVL5WPH.js.map

package/dist/server/chunk-XLVL5WPH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-XLVL5WPH.js","../../src/config/validation.ts"],"names":[],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-XLVL5WPH.js","sourcesContent":[null,"/**\n * Zod validation schemas for SDK site configuration.\n *\n * These schemas are used to validate configuration fetched from\n * SDK sites before storing in the database.\n */\n\nimport { z } from 'zod';\nimport { blockCategoryEnum, fieldSchema, getBlockDefinition, type SdkCustomBlock, type FieldDefinition } from '@riverbankcms/blocks';\nimport type { RiverbankSiteConfig, BlockFieldOptionsMap, BlockFieldExtensionsMap, BlockFieldExtension } from './types';\n\n/**\n * Schema for SDK theme palette.\n * Maps token names to CSS color values.\n */\nexport const sdkThemePaletteSchema = z.record(z.string(), z.string());\n\n/**\n * Schema for SDK theme configuration.\n */\nexport const sdkThemeConfigSchema = z.object({\n  palette: sdkThemePaletteSchema,\n});\n\n/**\n * Schema for section background color options.\n */\nexport const sectionBackgroundSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  token: z.string(), // Reference to theme palette token\n});\n\n/**\n * Schema for section spacing values.\n */\nexport const sectionSpacingSchema = z.enum(['compact', 'default', 'spacious']);\n\n/**\n * Schema for container max-width values.\n */\nexport const containerMaxWidthSchema = z.enum(['narrow', 'default', 'wide', 'full']);\n\n/**\n * Schema for container alignment values.\n */\nexport const containerAlignmentSchema = z.enum(['left', 'center', 'right']);\n\n/**\n * Schema for section options configuration.\n */\nexport const sectionOptionsSchema = z.object({\n  backgroundColor: z.boolean().optional(),\n  backgroundImage: z.boolean().optional(),\n  backgroundGradient: z.boolean().optional(),\n  spacing: z.union([\n    z.array(sectionSpacingSchema),\n    z.boolean(),\n  ]).optional(),\n  textColor: z.boolean().optional(),\n}).optional();\n\n/**\n * Schema for container options configuration.\n */\nexport const containerOptionsSchema = z.object({\n  maxWidth: z.union([\n    z.array(containerMaxWidthSchema),\n    z.boolean(),\n  ]).optional(),\n  alignment: z.union([\n    z.array(containerAlignmentSchema),\n    z.boolean(),\n  ]).optional(),\n}).optional();\n\n/**\n * Schema for site style configuration.\n */\nexport const siteStyleConfigSchema = z.object({\n  sectionBackgrounds: z.array(sectionBackgroundSchema).optional(),\n  sectionOptions: sectionOptionsSchema,\n  containerOptions: containerOptionsSchema,\n}).optional();\n\n// ============================================================================\n// Data Loader Schemas\n// ============================================================================\n\nimport { SUPPORTED_LOADER_ENDPOINTS } from '../data/prefetchBlockData';\n\n/**\n * Whitelisted endpoints for SDK data loaders.\n *\n * These are the only CMS endpoints that can be called from config-based loaders.\n * This ensures SDK sites can only access safe, read-only public endpoints.\n *\n * Derived from SUPPORTED_LOADER_ENDPOINTS - the single source of truth.\n */\nexport const sdkLoaderEndpointSchema = z.enum(SUPPORTED_LOADER_ENDPOINTS);\n\n/**\n * A binding expression for dynamic loader params.\n *\n * @example\n * ```typescript\n * { $bind: { from: 'content.categoryId' } }\n * { $bind: { from: '$root.siteId' } }\n * { $bind: { from: 'content.limit', fallback: '10' } }\n * ```\n */\nexport const loaderParamBindingSchema = z.object({\n  $bind: z.object({\n    from: z.string().min(1, \"Binding path is required\"),\n    fallback: z.string().optional(),\n  }),\n});\n\n/**\n * A loader param value can be static or a binding expression.\n */\nexport const loaderParamValueSchema = z.union([\n  z.string(),\n  z.number(),\n  z.boolean(),\n  loaderParamBindingSchema,\n]);\n\n/**\n * Schema for config-based data loader.\n *\n * Config loaders execute server-side during loadPage() and are\n * restricted to whitelisted CMS endpoints.\n */\nexport const sdkConfigLoaderSchema = z.object({\n  endpoint: sdkLoaderEndpointSchema,\n  params: z.record(z.string(), loaderParamValueSchema),\n  mode: z.enum(['server', 'client']).default('server'),\n});\n\n/**\n * Schema for the dataLoaders field on custom blocks.\n * Validates the loader configuration and limits the number of loaders.\n */\nexport const sdkDataLoadersSchema = z.record(z.string(), sdkConfigLoaderSchema)\n  .refine(\n    (loaders) => Object.keys(loaders).length <= 5,\n    { message: \"Maximum 5 data loaders per block\" }\n  )\n  .optional();\n\n// ============================================================================\n// Custom Block Schema\n// ============================================================================\n\n/**\n * Schema for field select option.\n */\nexport const fieldSelectOptionSchema = z.object({\n  value: z.string().min(1, \"Option value is required\"),\n  label: z.string().min(1, \"Option label is required\"),\n});\n\n/**\n * Schema for per-field configuration within a block.\n */\nexport const blockFieldConfigSchema = z.object({\n  options: z.array(fieldSelectOptionSchema).min(1, \"At least one option is required\").optional(),\n});\n\n/**\n * Schema for per-block field options.\n *\n * Block IDs must be either 'block.*' (system blocks) or 'custom.*' (custom blocks).\n * Field IDs can be any valid identifier string.\n */\nexport const blockFieldOptionsSchema: z.ZodType<BlockFieldOptionsMap> = z.record(\n  z.string().regex(/^(block\\.|custom\\.)[a-z][a-z0-9-]*$/, {\n    message: \"Block ID must be 'block.*' or 'custom.*' format\",\n  }),\n  z.record(\n    z.string().min(1, \"Field ID is required\"),\n    blockFieldConfigSchema\n  )\n).optional() as z.ZodType<BlockFieldOptionsMap>;\n\n// ============================================================================\n// Block Field Extensions Schema\n// ============================================================================\n\n/**\n * Schema for block field extension configuration.\n *\n * Validates additional fields to be appended to a built-in block.\n * Includes refinement to ensure required fields have defaultValue.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const blockFieldExtensionSchema: z.ZodType<BlockFieldExtension> = z.object({\n  fields: fieldSchema.array().min(1, \"At least one field is required\"),\n}).refine(\n  (data) => {\n    // All required fields must have a defaultValue\n    return data.fields.every((field: FieldDefinition) => {\n      if (!field.required) return true;\n      return field.defaultValue !== undefined;\n    });\n  },\n  {\n    message: \"Required fields must have a defaultValue to support existing blocks\",\n  }\n) as z.ZodType<BlockFieldExtension>;\n\n/**\n * Schema for block field extensions map.\n *\n * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').\n * Custom blocks ('custom.*') should define their fields directly, not via extensions.\n */\nexport const blockFieldExtensionsSchema: z.ZodType<BlockFieldExtensionsMap | undefined> = z.record(\n  z.string().regex(/^block\\.[a-z][a-zA-Z0-9]*$/, {\n    message: \"Block ID must be 'block.*' format (system blocks only)\",\n  }),\n  blockFieldExtensionSchema\n).optional() as z.ZodType<BlockFieldExtensionsMap | undefined>;\n\n/**\n * Validates that extended field IDs don't conflict with existing block fields.\n *\n * This validation should be called during config push to provide clear error messages.\n * Returns an array of conflict errors, or empty array if valid.\n *\n * @example\n * ```typescript\n * const conflicts = validateFieldIdConflicts(config.blockFieldExtensions);\n * if (conflicts.length > 0) {\n *   throw new Error(conflicts.map(c => c.message).join('\\n'));\n * }\n * ```\n */\nexport function validateFieldIdConflicts(\n  blockFieldExtensions?: BlockFieldExtensionsMap | null\n): { blockId: string; fieldId: string; message: string }[] {\n  if (!blockFieldExtensions) return [];\n\n  const conflicts: { blockId: string; fieldId: string; message: string }[] = [];\n\n  for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {\n    const definition = getBlockDefinition(blockId);\n    if (!definition) {\n      conflicts.push({\n        blockId,\n        fieldId: '',\n        message: `Unknown block type: ${blockId}`,\n      });\n      continue;\n    }\n\n    // Get all existing field IDs from the block manifest\n    const existingFieldIds = new Set<string>();\n    const collectFieldIds = (fields: FieldDefinition[] | undefined) => {\n      if (!fields) return;\n      for (const field of fields) {\n        existingFieldIds.add(field.id);\n        // Also collect nested field IDs from groups, modals, repeaters, tab groups\n        if (field.type === 'group' || field.type === 'modal') {\n          collectFieldIds(field.schema?.fields);\n        } else if (field.type === 'repeater' && field.schema?.fields) {\n          collectFieldIds(field.schema.fields);\n        } else if (field.type === 'tabGroup') {\n          for (const tab of field.tabs ?? []) {\n            collectFieldIds(tab.fields);\n          }\n        }\n      }\n    };\n    collectFieldIds(definition.manifest.fields);\n\n    // Check for conflicts\n    for (const field of extension.fields) {\n      if (existingFieldIds.has(field.id)) {\n        conflicts.push({\n          blockId,\n          fieldId: field.id,\n          message: `Field ID \"${field.id}\" conflicts with existing field in ${blockId}`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Schema for SDK custom block definitions.\n *\n * Validates custom blocks defined in riverbank.config.ts.\n * Reuses fieldSchema from @riverbankcms/blocks for field validation.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const sdkCustomBlockSchema: z.ZodType<SdkCustomBlock> = z.object({\n  // Block ID must start with 'custom.'\n  id: z.string()\n    .min(8) // 'custom.' + at least 1 char\n    .regex(/^custom\\.[a-z][a-z0-9-]*$/, {\n      message: \"Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens\",\n    }),\n  title: z.string().min(1, \"Title is required\"),\n  titleSource: z.string().optional(),\n  description: z.string().optional(),\n  category: blockCategoryEnum,\n  icon: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  // Reuse the exact field schema from @riverbankcms/blocks - all field types supported\n  fields: fieldSchema.array().min(1, \"Custom blocks must have at least one field\"),\n  // Data loaders for CMS endpoints\n  dataLoaders: sdkDataLoadersSchema,\n}).refine(\n  // Validate titleSource references a valid field if provided\n  (data) => {\n    if (!data.titleSource) return true;\n    return data.fields.some(f => f.id === data.titleSource);\n  },\n  {\n    message: \"titleSource must reference a valid field ID\",\n    path: [\"titleSource\"],\n  }\n) as z.ZodType<SdkCustomBlock>;\n\n/**\n * Schema for the complete SDK site configuration.\n *\n * Use this schema to validate configuration fetched from SDK sites\n * before storing in the database.\n *\n * @example\n * ```typescript\n * import { riverbankSiteConfigSchema } from '@riverbankcms/sdk/config/validation';\n *\n * const rawConfig = await response.json();\n * const config = riverbankSiteConfigSchema.parse(rawConfig);\n * ```\n */\nexport const riverbankSiteConfigSchema: z.ZodType<RiverbankSiteConfig> = z.object({\n  siteId: z.string().uuid(),\n  theme: sdkThemeConfigSchema.optional(),\n  styles: siteStyleConfigSchema,\n  customBlocks: z.array(sdkCustomBlockSchema)\n    .max(20, \"Maximum 20 custom blocks per site\")\n    .refine(\n      // Ensure unique block IDs\n      (blocks) => {\n        const ids = blocks.map(b => b.id);\n        return ids.length === new Set(ids).size;\n      },\n      { message: \"Block IDs must be unique\" }\n    )\n    .optional(),\n  blockFieldOptions: blockFieldOptionsSchema,\n  blockFieldExtensions: blockFieldExtensionsSchema,\n}).strict() as z.ZodType<RiverbankSiteConfig>;\n\n/**\n * Type inferred from the validation schema.\n * This should match the RiverbankSiteConfig type from ./types.ts\n */\nexport type ValidatedRiverbankSiteConfig = z.infer<typeof riverbankSiteConfigSchema>;\n\n/**\n * Type for a validated SDK custom block.\n */\nexport type ValidatedSdkCustomBlock = z.infer<typeof sdkCustomBlockSchema>;\n\n// ============================================================================\n// Compile-time type assertions\n//\n// These assertions ensure the Zod schemas stay in sync with the TypeScript types.\n// If the schema output diverges from the expected type, TypeScript will error here.\n// ============================================================================\n\n/** Asserts sdkCustomBlockSchema output matches SdkCustomBlock */\ntype _AssertSdkCustomBlockSchema = z.infer<typeof sdkCustomBlockSchema> extends SdkCustomBlock\n  ? SdkCustomBlock extends z.infer<typeof sdkCustomBlockSchema>\n    ? true\n    : never\n  : never;\n\n/** Asserts riverbankSiteConfigSchema output matches RiverbankSiteConfig */\ntype _AssertRiverbankSiteConfigSchema = z.infer<typeof riverbankSiteConfigSchema> extends RiverbankSiteConfig\n  ? RiverbankSiteConfig extends z.infer<typeof riverbankSiteConfigSchema>\n    ? true\n    : never\n  : never;\n\n// These assignments will fail to compile if the types don't match\nconst _checkSdkCustomBlock: _AssertSdkCustomBlockSchema = true;\nconst _checkRiverbankSiteConfig: _AssertRiverbankSiteConfigSchema = true;\n\n// Prevent unused variable warnings\nvoid _checkSdkCustomBlock;\nvoid _checkRiverbankSiteConfig;\n"]}

package/dist/server/components-BzdA6NAc.d.mts

@@ -0,0 +1,305 @@
+import { T as ThemeTokens } from './loadPage-pg4HimlK.mjs';
+import './Layout-DK_9OOgb.mjs';
+import { T as Theme, H as HydratedTheme, g as ExpandedPalette } from './types-C0G9IxWO.mjs';
+import './schema-Bpy9N5ZI.mjs';
+import z, { z as z$1 } from 'zod';
+import * as React from 'react';
+import React__default from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const mediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    assetId: z.ZodOptional<z.ZodString>;
+    src: z.ZodOptional<z.ZodString>;
+    alt: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    storageBucket: z.ZodOptional<z.ZodString>;
+    storagePath: z.ZodOptional<z.ZodString>;
+    transform: z.ZodOptional<z.ZodObject<{
+        rect: z.ZodOptional<z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+        hotspot: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Media = z.infer<typeof mediaSchema>;
+
+/**
+ * Gradient configuration types and schemas
+ */
+
+/**
+ * Gradient configuration
+ */
+declare const gradientConfigSchema: z$1.ZodObject<{
+    type: z$1.ZodEnum<{
+        linear: "linear";
+        radial: "radial";
+    }>;
+    angle: z$1.ZodOptional<z$1.ZodNumber>;
+    position: z$1.ZodOptional<z$1.ZodString>;
+    stops: z$1.ZodArray<z$1.ZodObject<{
+        color: z$1.ZodString;
+        position: z$1.ZodNumber;
+    }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
+type GradientConfig = z$1.infer<typeof gradientConfigSchema>;
+
+type HeroCta = {
+    label: string;
+    href: string;
+    variant?: 'primary' | 'secondary' | 'outline';
+    iconLeft?: Media | null;
+    iconRight?: Media | null;
+};
+type HeroCtaInput = Partial<HeroCta>;
+type HeroContent = {
+    eyebrow?: string;
+    headline: string;
+    subheadline?: string;
+    _sectionStyles?: {
+        background?: {
+            type: 'color' | 'gradient' | 'image';
+            color?: string | null;
+            gradient?: GradientConfig | null;
+            image?: HeroMedia | null;
+            textColor?: string | null;
+        } | null;
+        spacing?: string | null;
+    } | null;
+    ctas?: HeroCtaInput[];
+};
+type HeroMedia = Media;
+
+/**
+ * Build Zod validation schema for rich text fields
+ *
+ * @param options - Optional configuration
+ * @param options.required - If true, validates that content is not empty
+ * @param options.label - Field label for error messages (defaults to 'This field')
+ * @returns Zod schema for rich text validation
+ *
+ * @example
+ * // Basic usage
+ * const schema = buildRichTextSchema()
+ *
+ * @example
+ * // Required field with custom label
+ * const schema = buildRichTextSchema({ required: true, label: 'Description' })
+ */
+/**
+ * TypeScript type for a TipTap document node
+ *
+ * Use this type for rich text content fields in block definitions.
+ * Defined explicitly (rather than inferred) because recursive Zod schemas
+ * require `z.ZodType<any>` which loses type information.
+ */
+type TipTapNode = {
+    type: string;
+    content?: TipTapNode[];
+    text?: string;
+    attrs?: Record<string, unknown>;
+    marks?: Array<{
+        type: string;
+        attrs?: Record<string, unknown>;
+    }>;
+};
+
+type BodyTextAlignment = "left" | "center";
+type BodyTextContent = {
+    heading?: string | null;
+    body: TipTapNode;
+    alignment?: BodyTextAlignment | null;
+};
+
+type ThemeCssVars = Record<string, string | number>;
+type ThemeRuntime = {
+    hydrated: HydratedTheme;
+    cssVars: ThemeCssVars;
+    tokens: ThemeTokens;
+    paletteTokens: ExpandedPalette;
+    buttonCss?: string;
+    headerCss?: string;
+    cardCss?: string;
+    accordionCss?: string;
+    inputCss?: string;
+    layoutCss?: string;
+    statusCss?: string;
+    progressCss?: string;
+};
+declare function buildThemeRuntime(theme: Theme, options?: {
+    themeId?: string;
+}): ThemeRuntime;
+
+declare function RichText$1({ as: Comp, className, doc, path }: RichTextPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type RichTextPrimitiveProps = {
+    as?: React__default.ElementType;
+    className?: string;
+    path?: string;
+    doc?: TipTapNode | null;
+    variant?: RichTextVariant;
+    blockData?: Record<string, unknown> | null;
+};
+type RichTextVariant = "full" | "inline" | "limited" | "media";
+declare const RichText: typeof RichText$1;
+
+type ResolveImageUrlOptions = {
+    /**
+     * Preview API key for accessing unpublished images.
+     * When provided, appended as ?preview_key=xxx to the image URL.
+     */
+    previewKey?: string | null;
+};
+declare function resolveImageUrl(value: Media, options?: ResolveImageUrlOptions): string | undefined;
+
+/**
+ * Helper utilities for resolving background data in custom block components.
+ *
+ * These helpers allow custom block overrides to apply section backgrounds
+ * (color, gradient, image) with full theme token support, matching the
+ * behavior of the default declarative block system.
+ */
+
+/**
+ * Raw background data from CMS content fields.
+ * This is the shape of `_sectionStyles.background`, `_containerStyles.background`, etc.
+ */
+type BackgroundInput = {
+    /** Color token name (e.g., "primary") or raw hex value */
+    color?: string | null;
+    /** CSS gradient string */
+    gradient?: string | null;
+    /** Background image media object */
+    image?: Media | null;
+    /** Image sizing mode: 'fill' (cover), 'fit' (contain), 'original', 'custom' */
+    objectFit?: string | null;
+    /** Image position: preset keyword or custom CSS value */
+    position?: string | null;
+    /** Image scale value (e.g., "150%", "200px") - only for 'custom'/'original' modes */
+    scale?: string | null;
+    /** Background opacity (0-100) */
+    opacity?: number | null;
+    /** Whether background should overflow container bounds */
+    overflow?: boolean | null;
+};
+/**
+ * Resolved background ready for rendering.
+ * Token names are converted to actual hex values.
+ */
+type ResolvedBackground = {
+    /** Resolved background color (hex value or null) */
+    color: string | null;
+    /** CSS gradient string */
+    gradient: string | null;
+    /** Opacity value (0-1) */
+    opacity: number | null;
+    /** Whether background should overflow */
+    overflow: boolean;
+    /** Resolved image data */
+    image: {
+        /** Image URL */
+        url: string;
+        /** Alt text */
+        alt: string;
+        /** Original width */
+        width?: number;
+        /** Original height */
+        height?: number;
+    } | null;
+    /** Inline styles for the image element */
+    imageStyle: React.CSSProperties;
+    /** CSS classes for the image element */
+    imageClassName: string;
+};
+/**
+ * Resolves background data from CMS content to render-ready values.
+ *
+ * This helper converts raw background field data (with token names like "primary")
+ * into resolved values (with actual hex colors from the theme palette).
+ *
+ * @param background - Raw background data from content (e.g., content._sectionStyles?.background)
+ * @param theme - Theme tokens containing the palette for token resolution
+ * @returns Resolved background with all values ready for rendering
+ *
+ * @example
+ * ```tsx
+ * import { resolveBackground } from '@riverbankcms/blocks';
+ * // or from SDK: import { resolveBackground } from '@riverbankcms/sdk/rendering';
+ *
+ * function CustomBlock({ content, theme }: CustomBlockProps) {
+ *   const bg = resolveBackground(content._sectionStyles?.background, theme);
+ *
+ *   return (
+ *     <section
+ *       className="relative"
+ *       style={{ backgroundColor: bg.color ?? undefined }}
+ *     >
+ *       {bg.image && (
+ *         <img
+ *           src={bg.image.url}
+ *           alt={bg.image.alt}
+ *           className={bg.imageClassName}
+ *           style={bg.imageStyle}
+ *         />
+ *       )}
+ *       {content.heading}
+ *     </section>
+ *   );
+ * }
+ * ```
+ */
+declare function resolveBackground(background: BackgroundInput | null | undefined, theme?: ThemeTokens): ResolvedBackground;
+type SectionBackgroundProps = {
+    /** Raw background data from content (e.g., content._sectionStyles?.background) */
+    background: BackgroundInput | null | undefined;
+    /** Theme tokens for resolving color tokens to hex values */
+    theme?: ThemeTokens;
+    /**
+     * Additional className applied to background layers.
+     *
+     * **Note**: This className is applied to BOTH the color/gradient layer AND the
+     * image layer when both exist. If you need different classes for each layer,
+     * use the `resolveBackground()` helper directly for more control.
+     */
+    className?: string;
+};
+/**
+ * Renders a complete background layer (color, gradient, and/or image).
+ *
+ * This component handles all the complexity of rendering backgrounds from
+ * CMS content, including theme token resolution, image positioning, and opacity.
+ *
+ * Use this component in custom block overrides to easily apply section backgrounds.
+ *
+ * @example
+ * ```tsx
+ * import { SectionBackground } from '@riverbankcms/blocks';
+ * // or from SDK: import { SectionBackground } from '@riverbankcms/sdk/rendering';
+ *
+ * function CustomBlock({ content, theme }: CustomBlockProps) {
+ *   return (
+ *     <section className="relative py-16">
+ *       <SectionBackground
+ *         background={content._sectionStyles?.background}
+ *         theme={theme}
+ *       />
+ *       <div className="container mx-auto relative z-10">
+ *         {content.heading}
+ *       </div>
+ *     </section>
+ *   );
+ * }
+ * ```
+ */
+declare function SectionBackground({ background, theme, className, }: SectionBackgroundProps): React.ReactElement | null;
+
+export { type BodyTextContent as B, type GradientConfig as G, type HeroContent as H, type Media as M, RichText as R, SectionBackground as S, type TipTapNode as T, type HeroMedia as a, buildThemeRuntime as b, type RichTextPrimitiveProps as c, resolveBackground as d, type BackgroundInput as e, type ResolvedBackground as f, type SectionBackgroundProps as g, resolveImageUrl as r };