@riverbankcms/sdk 0.1.0

package/dist/server/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","../../src/theme/index.ts"],"names":[],"mappings":"AAAA;ACkBO,SAAS,UAAA,CAAW,KAAA,EAAgC,OAAA,EAA6B;AACtF,EAAA,MAAM,cAAA,mBAAgB,OAAA,UAAA,CAAY,OAAO,SAAA,IAAa,YAAA,EAAc,QAAA,CAAS,gBAAA,EAAkB,IAAA,GAAA;AAE/F,EAAA,GAAA,CAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAA,CAAQ,IAAA,CAAK,yDAAyD,CAAA;AACtE,IAAA,MAAA;AAAA,EACF;AAIA,EAAA,aAAA,CAAc,YAAA,CAAa,oBAAA,EAAsB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAIxE;AAiBO,SAAS,WAAA,CAAY,QAAA,EAAmC,CAAC,CAAA,EAA4B;AAI1F,EAAA,OAAO,EAAE,GAAG,QAAQ,CAAA;AACtB;AD1CA;AACE;AACA;AACF,mEAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/theme.js","sourcesContent":[null,"/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"]}

package/dist/server/theme.mjs

@@ -0,0 +1,17 @@
+// src/theme/index.ts
+function applyTheme(theme, element) {
+  const targetElement = element ?? (typeof document !== "undefined" ? document.documentElement : null);
+  if (!targetElement) {
+    console.warn("[Builder SDK] Cannot apply theme: no document available");
+    return;
+  }
+  targetElement.setAttribute("data-builder-theme", JSON.stringify(theme));
+}
+function createTheme(partial = {}) {
+  return { ...partial };
+}
+export {
+  applyTheme,
+  createTheme
+};
+//# sourceMappingURL=theme.mjs.map

package/dist/server/theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/index.ts"],"sourcesContent":["/**\n * Theme utilities for Riverbank CMS\n *\n * These utilities help you work with Builder themes in your application.\n */\n\n/**\n * Apply a Builder theme to the DOM by injecting CSS variables\n *\n * @param theme - The theme object from Riverbank CMS\n * @param element - The element to apply the theme to (default: document.documentElement)\n *\n * @example\n * ```ts\n * const site = await client.getSite({ slug: 'my-site' });\n * applyTheme(site.theme);\n * ```\n */\nexport function applyTheme(theme: Record<string, unknown>, element?: HTMLElement): void {\n  const targetElement = element ?? (typeof document !== 'undefined' ? document.documentElement : null);\n\n  if (!targetElement) {\n    console.warn('[Builder SDK] Cannot apply theme: no document available');\n    return;\n  }\n\n  // Theme application will use the theme runtime from @riverbankcms/blocks\n  // For now, we'll set a data attribute that the theme runtime can pick up\n  targetElement.setAttribute('data-builder-theme', JSON.stringify(theme));\n\n  // Note: Full CSS variable injection will be implemented once we\n  // finalize the theme transformation API from @riverbankcms/blocks\n}\n\n/**\n * Create a theme object with type-safe defaults\n *\n * @param partial - Partial theme configuration\n * @returns Complete theme object\n *\n * @example\n * ```ts\n * const customTheme = createTheme({\n *   colors: {\n *     primary: '#007bff',\n *   },\n * });\n * ```\n */\nexport function createTheme(partial: Record<string, unknown> = {}): Record<string, unknown> {\n  // For now, return the partial as-is\n  // Full theme creation with defaults will be implemented once we\n  // finalize the theme structure from @riverbankcms/blocks\n  return { ...partial };\n}\n\n/**\n * Re-export theme types from @riverbankcms/blocks when available\n */\nexport type Theme = Record<string, unknown>;\n"],"mappings":";AAkBO,SAAS,WAAW,OAAgC,SAA6B;AACtF,QAAM,gBAAgB,YAAY,OAAO,aAAa,cAAc,SAAS,kBAAkB;AAE/F,MAAI,CAAC,eAAe;AAClB,YAAQ,KAAK,yDAAyD;AACtE;AAAA,EACF;AAIA,gBAAc,aAAa,sBAAsB,KAAK,UAAU,KAAK,CAAC;AAIxE;AAiBO,SAAS,YAAY,UAAmC,CAAC,GAA4B;AAI1F,SAAO,EAAE,GAAG,QAAQ;AACtB;","names":[]}

package/dist/server/types-BCeqWtI2.d.mts

@@ -0,0 +1,333 @@
+import { SdkCustomBlock, FieldDefinition } from '@riverbankcms/blocks';
+
+/**
+ * SDK Site Configuration Types
+ *
+ * These types define the schema for SDK site configuration that can be
+ * declared in code and exposed to the dashboard via /.builder/config.
+ */
+
+/**
+ * SDK-defined theme palette.
+ *
+ * SDK sites define their own color palette with semantic token names.
+ * These tokens can then be referenced in style configurations.
+ *
+ * @example
+ * ```typescript
+ * palette: {
+ *   primary: '#6d28d9',
+ *   secondary: '#4c1d95',
+ *   accent: '#FF007F',
+ *   highlight: '#facc15',
+ * }
+ * ```
+ */
+type SdkThemePalette = Record<string, string>;
+/**
+ * SDK-defined theme configuration.
+ *
+ * This allows SDK sites to define their own theme that's used for
+ * token resolution in the editor and at render time.
+ */
+interface SdkThemeConfig {
+    /**
+     * Color palette mapping token names to CSS color values.
+     * Token names are arbitrary and defined by the SDK site.
+     */
+    palette: SdkThemePalette;
+}
+/**
+ * Allowed spacing values in section styles.
+ */
+type SectionSpacing = 'compact' | 'default' | 'spacious';
+/**
+ * Allowed container max-width values.
+ */
+type ContainerMaxWidth = 'narrow' | 'default' | 'wide' | 'full';
+/**
+ * Allowed container alignment values.
+ */
+type ContainerAlignment = 'left' | 'center' | 'right';
+/**
+ * A curated background color option for section styles.
+ *
+ * @example
+ * ```typescript
+ * sectionBackgrounds: [
+ *   { id: 'primary', label: 'Purple', token: 'primary' },
+ *   { id: 'accent', label: 'Pink', token: 'accent' },
+ * ]
+ * ```
+ */
+interface SectionBackground {
+    /** Unique identifier for this background option */
+    id: string;
+    /** Display name shown in the editor UI */
+    label: string;
+    /** Reference to a token in the theme palette */
+    token: string;
+}
+/**
+ * Configuration for which section style options are available.
+ *
+ * Each option can be:
+ * - `false`: Hide the option entirely from the editor
+ * - `true`: Show all supported values for that option
+ * - Array: Show only the specified values (for options that support arrays)
+ */
+interface SectionOptionsConfig {
+    /** Enable/disable background color selection */
+    backgroundColor?: boolean;
+    /** Enable/disable background image selection */
+    backgroundImage?: boolean;
+    /** Enable/disable background gradient selection */
+    backgroundGradient?: boolean;
+    /** Control available spacing values, or disable entirely */
+    spacing?: SectionSpacing[] | boolean;
+    /** Enable/disable text color selection */
+    textColor?: boolean;
+}
+/**
+ * Configuration for which container style options are available.
+ *
+ * Each option can be:
+ * - `false`: Hide the option entirely from the editor
+ * - `true`: Show all supported values for that option
+ * - Array: Show only the specified values
+ */
+interface ContainerOptionsConfig {
+    /** Control available max-width values, or disable entirely */
+    maxWidth?: ContainerMaxWidth[] | boolean;
+    /** Control available alignment values, or disable entirely */
+    alignment?: ContainerAlignment[] | boolean;
+}
+/**
+ * Site-level style configuration for SDK sites.
+ *
+ * This allows SDK sites to curate which styling options are available
+ * to editors in the section styles panel.
+ */
+interface SiteStyleConfig {
+    /**
+     * Curated list of background colors available in section styles.
+     * If not specified, falls back to theme colors (current behavior).
+     */
+    sectionBackgrounds?: SectionBackground[];
+    /**
+     * Which section style options are enabled.
+     * Options not listed or set to false are hidden from editors.
+     */
+    sectionOptions?: SectionOptionsConfig;
+    /**
+     * Container style constraints.
+     */
+    containerOptions?: ContainerOptionsConfig;
+}
+/**
+ * A select option for SDK-provided field options.
+ */
+interface FieldSelectOption {
+    /** The value stored when this option is selected */
+    value: string;
+    /** Display label shown in the dropdown */
+    label: string;
+}
+/**
+ * Configuration for a specific field within a block.
+ *
+ * Currently supports overriding select options, but designed
+ * for future extensions (defaultValue, required, etc.).
+ */
+interface BlockFieldConfig {
+    /** Override select options for this field */
+    options?: FieldSelectOption[];
+}
+/**
+ * Per-block field configurations.
+ *
+ * Maps block IDs to field configurations, where each field config
+ * is keyed by field ID.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   'block.embed': {
+ *     layout: {
+ *       options: [
+ *         { value: 'showcase', label: 'Showcase Grid' },
+ *         { value: 'list', label: 'Simple List' },
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+type BlockFieldOptionsMap = Record<string, Record<string, BlockFieldConfig>>;
+/**
+ * Configuration for extending a built-in block with additional fields.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   fields: [
+ *     {
+ *       id: 'layout',
+ *       type: 'select',
+ *       label: 'Layout',
+ *       defaultValue: 'default',
+ *       options: [
+ *         { value: 'default', label: 'Default' },
+ *         { value: 'wide', label: 'Wide' },
+ *       ],
+ *     },
+ *   ],
+ * }
+ * ```
+ */
+interface BlockFieldExtension {
+    /**
+     * Additional fields to append to the block's form.
+     * Uses the same field definition format as block manifests.
+     * All field types are supported.
+     *
+     * Note: If a field is marked as `required: true`, it MUST have a `defaultValue`.
+     * This ensures existing blocks without this field can still be edited.
+     */
+    fields: FieldDefinition[];
+}
+/**
+ * Map of block IDs to their field extensions.
+ * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').
+ *
+ * @example
+ * ```typescript
+ * {
+ *   'block.bodyText': {
+ *     fields: [
+ *       { id: 'layout', type: 'select', label: 'Layout', ... },
+ *     ],
+ *   },
+ *   'block.hero': {
+ *     fields: [
+ *       { id: 'videoBackground', type: 'media', label: 'Video Background', ... },
+ *     ],
+ *   },
+ * }
+ * ```
+ */
+type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
+/**
+ * Top-level SDK site configuration.
+ *
+ * This is the complete configuration that SDK sites define in their
+ * `riverbank.config.ts` file and expose via the `/.builder/config` endpoint.
+ *
+ * @example
+ * ```typescript
+ * // riverbank.config.ts
+ * import { defineConfig } from '@riverbankcms/sdk/config';
+ *
+ * export default defineConfig({
+ *   siteId: '123e4567-e89b-12d3-a456-426614174000',
+ *   theme: {
+ *     palette: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       accent: '#FF007F',
+ *       highlight: '#facc15',
+ *     },
+ *   },
+ *   styles: {
+ *     sectionBackgrounds: [
+ *       { id: 'primary', label: 'Purple', token: 'primary' },
+ *       { id: 'accent', label: 'Pink', token: 'accent' },
+ *     ],
+ *     sectionOptions: {
+ *       backgroundColor: true,
+ *       backgroundImage: false,
+ *       spacing: ['compact', 'default', 'spacious'],
+ *     },
+ *   },
+ *   blockFieldOptions: {
+ *     'block.embed': {
+ *       layout: {
+ *         options: [
+ *           { value: 'showcase', label: 'Showcase Grid' },
+ *           { value: 'list', label: 'Simple List' },
+ *         ]
+ *       }
+ *     }
+ *   },
+ * });
+ * ```
+ */
+interface RiverbankSiteConfig {
+    /** Site UUID from the dashboard - identifies which site this config belongs to */
+    siteId: string;
+    /** SDK-defined theme with color palette for token resolution */
+    theme?: SdkThemeConfig;
+    /** Style configuration for curating editor options */
+    styles?: SiteStyleConfig;
+    /**
+     * Custom blocks defined by the SDK site.
+     * These blocks appear in the block picker and are edited via CMS forms.
+     * SDK sites MUST provide blockOverrides for rendering.
+     */
+    customBlocks?: SdkCustomBlock[];
+    /**
+     * Per-block field options.
+     *
+     * Allows SDK sites to define which options are available for specific
+     * fields in specific blocks. Widgets with `ui.widget: 'sdkSelect'`
+     * will use these options when available, falling back to field defaults.
+     *
+     * @example
+     * ```typescript
+     * blockFieldOptions: {
+     *   'block.embed': {
+     *     layout: {
+     *       options: [
+     *         { value: 'showcase', label: 'Showcase Grid' },
+     *         { value: 'list', label: 'Simple List' },
+     *       ]
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    blockFieldOptions?: BlockFieldOptionsMap;
+    /**
+     * Per-block field extensions.
+     *
+     * Allows SDK sites to add custom fields to built-in block types.
+     * Extended fields appear at the end of the block's editing form
+     * and their values are accessible in `blockOverrides` via the `content` prop.
+     *
+     * Note: Extended field IDs must not conflict with existing block fields.
+     * Required fields must have a `defaultValue` to support existing blocks.
+     *
+     * @example
+     * ```typescript
+     * blockFieldExtensions: {
+     *   'block.bodyText': {
+     *     fields: [
+     *       {
+     *         id: 'layout',
+     *         type: 'select',
+     *         label: 'Layout',
+     *         defaultValue: 'default',
+     *         options: [
+     *           { value: 'default', label: 'Default' },
+     *           { value: 'wide', label: 'Wide' },
+     *         ],
+     *       },
+     *     ],
+     *   },
+     * }
+     * ```
+     */
+    blockFieldExtensions?: BlockFieldExtensionsMap;
+}
+
+export type { BlockFieldConfig as B, ContainerOptionsConfig as C, FieldSelectOption as F, RiverbankSiteConfig as R, SiteStyleConfig as S, SectionBackground as a, SectionOptionsConfig as b, SectionSpacing as c, ContainerMaxWidth as d, ContainerAlignment as e, SdkThemeConfig as f, SdkThemePalette as g, BlockFieldOptionsMap as h, BlockFieldExtension as i, BlockFieldExtensionsMap as j };

package/dist/server/types-BCeqWtI2.d.ts

@@ -0,0 +1,333 @@
+import { SdkCustomBlock, FieldDefinition } from '@riverbankcms/blocks';
+
+/**
+ * SDK Site Configuration Types
+ *
+ * These types define the schema for SDK site configuration that can be
+ * declared in code and exposed to the dashboard via /.builder/config.
+ */
+
+/**
+ * SDK-defined theme palette.
+ *
+ * SDK sites define their own color palette with semantic token names.
+ * These tokens can then be referenced in style configurations.
+ *
+ * @example
+ * ```typescript
+ * palette: {
+ *   primary: '#6d28d9',
+ *   secondary: '#4c1d95',
+ *   accent: '#FF007F',
+ *   highlight: '#facc15',
+ * }
+ * ```
+ */
+type SdkThemePalette = Record<string, string>;
+/**
+ * SDK-defined theme configuration.
+ *
+ * This allows SDK sites to define their own theme that's used for
+ * token resolution in the editor and at render time.
+ */
+interface SdkThemeConfig {
+    /**
+     * Color palette mapping token names to CSS color values.
+     * Token names are arbitrary and defined by the SDK site.
+     */
+    palette: SdkThemePalette;
+}
+/**
+ * Allowed spacing values in section styles.
+ */
+type SectionSpacing = 'compact' | 'default' | 'spacious';
+/**
+ * Allowed container max-width values.
+ */
+type ContainerMaxWidth = 'narrow' | 'default' | 'wide' | 'full';
+/**
+ * Allowed container alignment values.
+ */
+type ContainerAlignment = 'left' | 'center' | 'right';
+/**
+ * A curated background color option for section styles.
+ *
+ * @example
+ * ```typescript
+ * sectionBackgrounds: [
+ *   { id: 'primary', label: 'Purple', token: 'primary' },
+ *   { id: 'accent', label: 'Pink', token: 'accent' },
+ * ]
+ * ```
+ */
+interface SectionBackground {
+    /** Unique identifier for this background option */
+    id: string;
+    /** Display name shown in the editor UI */
+    label: string;
+    /** Reference to a token in the theme palette */
+    token: string;
+}
+/**
+ * Configuration for which section style options are available.
+ *
+ * Each option can be:
+ * - `false`: Hide the option entirely from the editor
+ * - `true`: Show all supported values for that option
+ * - Array: Show only the specified values (for options that support arrays)
+ */
+interface SectionOptionsConfig {
+    /** Enable/disable background color selection */
+    backgroundColor?: boolean;
+    /** Enable/disable background image selection */
+    backgroundImage?: boolean;
+    /** Enable/disable background gradient selection */
+    backgroundGradient?: boolean;
+    /** Control available spacing values, or disable entirely */
+    spacing?: SectionSpacing[] | boolean;
+    /** Enable/disable text color selection */
+    textColor?: boolean;
+}
+/**
+ * Configuration for which container style options are available.
+ *
+ * Each option can be:
+ * - `false`: Hide the option entirely from the editor
+ * - `true`: Show all supported values for that option
+ * - Array: Show only the specified values
+ */
+interface ContainerOptionsConfig {
+    /** Control available max-width values, or disable entirely */
+    maxWidth?: ContainerMaxWidth[] | boolean;
+    /** Control available alignment values, or disable entirely */
+    alignment?: ContainerAlignment[] | boolean;
+}
+/**
+ * Site-level style configuration for SDK sites.
+ *
+ * This allows SDK sites to curate which styling options are available
+ * to editors in the section styles panel.
+ */
+interface SiteStyleConfig {
+    /**
+     * Curated list of background colors available in section styles.
+     * If not specified, falls back to theme colors (current behavior).
+     */
+    sectionBackgrounds?: SectionBackground[];
+    /**
+     * Which section style options are enabled.
+     * Options not listed or set to false are hidden from editors.
+     */
+    sectionOptions?: SectionOptionsConfig;
+    /**
+     * Container style constraints.
+     */
+    containerOptions?: ContainerOptionsConfig;
+}
+/**
+ * A select option for SDK-provided field options.
+ */
+interface FieldSelectOption {
+    /** The value stored when this option is selected */
+    value: string;
+    /** Display label shown in the dropdown */
+    label: string;
+}
+/**
+ * Configuration for a specific field within a block.
+ *
+ * Currently supports overriding select options, but designed
+ * for future extensions (defaultValue, required, etc.).
+ */
+interface BlockFieldConfig {
+    /** Override select options for this field */
+    options?: FieldSelectOption[];
+}
+/**
+ * Per-block field configurations.
+ *
+ * Maps block IDs to field configurations, where each field config
+ * is keyed by field ID.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   'block.embed': {
+ *     layout: {
+ *       options: [
+ *         { value: 'showcase', label: 'Showcase Grid' },
+ *         { value: 'list', label: 'Simple List' },
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+type BlockFieldOptionsMap = Record<string, Record<string, BlockFieldConfig>>;
+/**
+ * Configuration for extending a built-in block with additional fields.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   fields: [
+ *     {
+ *       id: 'layout',
+ *       type: 'select',
+ *       label: 'Layout',
+ *       defaultValue: 'default',
+ *       options: [
+ *         { value: 'default', label: 'Default' },
+ *         { value: 'wide', label: 'Wide' },
+ *       ],
+ *     },
+ *   ],
+ * }
+ * ```
+ */
+interface BlockFieldExtension {
+    /**
+     * Additional fields to append to the block's form.
+     * Uses the same field definition format as block manifests.
+     * All field types are supported.
+     *
+     * Note: If a field is marked as `required: true`, it MUST have a `defaultValue`.
+     * This ensures existing blocks without this field can still be edited.
+     */
+    fields: FieldDefinition[];
+}
+/**
+ * Map of block IDs to their field extensions.
+ * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').
+ *
+ * @example
+ * ```typescript
+ * {
+ *   'block.bodyText': {
+ *     fields: [
+ *       { id: 'layout', type: 'select', label: 'Layout', ... },
+ *     ],
+ *   },
+ *   'block.hero': {
+ *     fields: [
+ *       { id: 'videoBackground', type: 'media', label: 'Video Background', ... },
+ *     ],
+ *   },
+ * }
+ * ```
+ */
+type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
+/**
+ * Top-level SDK site configuration.
+ *
+ * This is the complete configuration that SDK sites define in their
+ * `riverbank.config.ts` file and expose via the `/.builder/config` endpoint.
+ *
+ * @example
+ * ```typescript
+ * // riverbank.config.ts
+ * import { defineConfig } from '@riverbankcms/sdk/config';
+ *
+ * export default defineConfig({
+ *   siteId: '123e4567-e89b-12d3-a456-426614174000',
+ *   theme: {
+ *     palette: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       accent: '#FF007F',
+ *       highlight: '#facc15',
+ *     },
+ *   },
+ *   styles: {
+ *     sectionBackgrounds: [
+ *       { id: 'primary', label: 'Purple', token: 'primary' },
+ *       { id: 'accent', label: 'Pink', token: 'accent' },
+ *     ],
+ *     sectionOptions: {
+ *       backgroundColor: true,
+ *       backgroundImage: false,
+ *       spacing: ['compact', 'default', 'spacious'],
+ *     },
+ *   },
+ *   blockFieldOptions: {
+ *     'block.embed': {
+ *       layout: {
+ *         options: [
+ *           { value: 'showcase', label: 'Showcase Grid' },
+ *           { value: 'list', label: 'Simple List' },
+ *         ]
+ *       }
+ *     }
+ *   },
+ * });
+ * ```
+ */
+interface RiverbankSiteConfig {
+    /** Site UUID from the dashboard - identifies which site this config belongs to */
+    siteId: string;
+    /** SDK-defined theme with color palette for token resolution */
+    theme?: SdkThemeConfig;
+    /** Style configuration for curating editor options */
+    styles?: SiteStyleConfig;
+    /**
+     * Custom blocks defined by the SDK site.
+     * These blocks appear in the block picker and are edited via CMS forms.
+     * SDK sites MUST provide blockOverrides for rendering.
+     */
+    customBlocks?: SdkCustomBlock[];
+    /**
+     * Per-block field options.
+     *
+     * Allows SDK sites to define which options are available for specific
+     * fields in specific blocks. Widgets with `ui.widget: 'sdkSelect'`
+     * will use these options when available, falling back to field defaults.
+     *
+     * @example
+     * ```typescript
+     * blockFieldOptions: {
+     *   'block.embed': {
+     *     layout: {
+     *       options: [
+     *         { value: 'showcase', label: 'Showcase Grid' },
+     *         { value: 'list', label: 'Simple List' },
+     *       ]
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    blockFieldOptions?: BlockFieldOptionsMap;
+    /**
+     * Per-block field extensions.
+     *
+     * Allows SDK sites to add custom fields to built-in block types.
+     * Extended fields appear at the end of the block's editing form
+     * and their values are accessible in `blockOverrides` via the `content` prop.
+     *
+     * Note: Extended field IDs must not conflict with existing block fields.
+     * Required fields must have a `defaultValue` to support existing blocks.
+     *
+     * @example
+     * ```typescript
+     * blockFieldExtensions: {
+     *   'block.bodyText': {
+     *     fields: [
+     *       {
+     *         id: 'layout',
+     *         type: 'select',
+     *         label: 'Layout',
+     *         defaultValue: 'default',
+     *         options: [
+     *           { value: 'default', label: 'Default' },
+     *           { value: 'wide', label: 'Wide' },
+     *         ],
+     *       },
+     *     ],
+     *   },
+     * }
+     * ```
+     */
+    blockFieldExtensions?: BlockFieldExtensionsMap;
+}
+
+export type { BlockFieldConfig as B, ContainerOptionsConfig as C, FieldSelectOption as F, RiverbankSiteConfig as R, SiteStyleConfig as S, SectionBackground as a, SectionOptionsConfig as b, SectionSpacing as c, ContainerMaxWidth as d, ContainerAlignment as e, SdkThemeConfig as f, SdkThemePalette as g, BlockFieldOptionsMap as h, BlockFieldExtension as i, BlockFieldExtensionsMap as j };