@riverbankcms/sdk 0.1.0

package/dist/server/routing.mjs

@@ -0,0 +1,57 @@
+// src/routing/resolveRoute.ts
+async function resolveRoute(params) {
+  const { client, siteId, path, preview = false } = params;
+  try {
+    const pageResponse = await client.getPage({
+      siteId,
+      path,
+      preview
+    });
+    if (pageResponse) {
+      const { loadPage } = await import("./loadPage-PHQZ6XQZ.mjs");
+      const pageData = await loadPage({
+        client,
+        siteId,
+        path,
+        preview
+      });
+      return {
+        type: "page",
+        pageData
+      };
+    }
+  } catch (error) {
+    const is404 = error instanceof Error && (error.message.includes("404") || error.message.includes("Not Found") || error.message.includes("not found"));
+    if (is404) {
+      console.debug("[resolveRoute] Page not found", { path });
+    } else {
+      console.warn("[resolveRoute] Failed to fetch page", {
+        path,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return {
+    type: "not-found"
+  };
+}
+async function resolveRoutes(params) {
+  const { client, siteId, paths, preview } = params;
+  const resolutions = await Promise.all(
+    paths.map(async (path) => {
+      const resolution = await resolveRoute({
+        client,
+        siteId,
+        path,
+        preview
+      });
+      return { path, resolution };
+    })
+  );
+  return resolutions;
+}
+export {
+  resolveRoute,
+  resolveRoutes
+};
+//# sourceMappingURL=routing.mjs.map

package/dist/server/routing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routing/resolveRoute.ts"],"sourcesContent":["/**\n * Route resolution helper for dynamic page routing\n *\n * Resolves URL paths to pages, entries, redirects, or 404s.\n */\n\nimport type { RiverbankClient } from '../client/types';\nimport type { LoadPageResult } from '../rendering/helpers/loadPage';\n\nexport type RouteResolution =\n  | {\n      type: 'page';\n      pageData: LoadPageResult;\n    }\n  | {\n      type: 'redirect';\n      destination: string;\n      permanent: boolean;\n    }\n  | {\n      type: 'not-found';\n    };\n\nexport type ResolveRouteParams = {\n  /**\n   * Builder client instance\n   */\n  client: RiverbankClient;\n\n  /**\n   * Site ID\n   */\n  siteId: string;\n\n  /**\n   * URL path to resolve (e.g., '/about', '/blog/post-1')\n   */\n  path: string;\n\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * @default false\n   */\n  preview?: boolean;\n};\n\n/**\n * Resolve a URL path to page data, redirect, or 404\n *\n * This helper attempts to fetch the page at the given path and returns\n * a discriminated union indicating whether the page was found or not.\n *\n * **Note:** Redirect support is not yet implemented. The `redirect` type\n * exists in the return type for future compatibility, but this function\n * currently only returns `page` or `not-found` types.\n *\n * @example\n * ```tsx\n * import { resolveRoute } from '@riverbankcms/sdk/routing';\n * import { notFound, redirect } from 'next/navigation';\n *\n * export default async function DynamicPage({ params }) {\n *   const path = `/${params.slug?.join('/') || ''}`;\n *   const resolution = await resolveRoute({\n *     client,\n *     siteId: 'your-site-id',\n *     path,\n *   });\n *\n *   if (resolution.type === 'redirect') {\n *     redirect(resolution.destination);\n *   }\n *\n *   if (resolution.type === 'not-found') {\n *     notFound();\n *   }\n *\n *   // resolution.type === 'page'\n *   return <Page {...resolution.pageData} />;\n * }\n * ```\n */\nexport async function resolveRoute(\n  params: ResolveRouteParams\n): Promise<RouteResolution> {\n  const { client, siteId, path, preview = false } = params;\n\n  try {\n    // Attempt to fetch page data\n    const pageResponse = await client.getPage({\n      siteId,\n      path,\n      preview,\n    });\n\n    if (pageResponse) {\n      // Successfully found page - load full page data\n      const { loadPage } = await import('../rendering/helpers/loadPage');\n      const pageData = await loadPage({\n        client,\n        siteId,\n        path,\n        preview,\n      });\n\n      return {\n        type: 'page',\n        pageData,\n      };\n    }\n  } catch (error) {\n    // Distinguish between expected 404s and unexpected errors\n    const is404 = error instanceof Error &&\n      (error.message.includes('404') ||\n       error.message.includes('Not Found') ||\n       error.message.includes('not found'));\n\n    if (is404) {\n      console.debug('[resolveRoute] Page not found', { path });\n    } else {\n      // Unexpected error - log as warning for visibility\n      console.warn('[resolveRoute] Failed to fetch page', {\n        path,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  // No page found - return not-found\n  // Note: Redirect support will be added when client.getRedirect() API is available\n  return {\n    type: 'not-found',\n  };\n}\n\n/**\n * Batch resolve multiple routes in parallel\n *\n * Useful for pre-fetching multiple routes or validating a sitemap.\n *\n * @example\n * ```tsx\n * const resolutions = await resolveRoutes({\n *   client,\n *   siteId: 'your-site-id',\n *   paths: ['/', '/about', '/blog', '/contact'],\n * });\n *\n * resolutions.forEach(({ path, resolution }) => {\n *   if (resolution.type === 'page') {\n *     console.log(`${path} → Page: ${resolution.pageData.page.name}`);\n *   } else if (resolution.type === 'redirect') {\n *     console.log(`${path} → Redirect to ${resolution.destination}`);\n *   } else {\n *     console.log(`${path} → Not found`);\n *   }\n * });\n * ```\n */\nexport async function resolveRoutes(params: {\n  client: RiverbankClient;\n  siteId: string;\n  paths: string[];\n  preview?: boolean;\n}): Promise<Array<{ path: string; resolution: RouteResolution }>> {\n  const { client, siteId, paths, preview } = params;\n\n  const resolutions = await Promise.all(\n    paths.map(async (path) => {\n      const resolution = await resolveRoute({\n        client,\n        siteId,\n        path,\n        preview,\n      });\n\n      return { path, resolution };\n    })\n  );\n\n  return resolutions;\n}\n"],"mappings":";AAkFA,eAAsB,aACpB,QAC0B;AAC1B,QAAM,EAAE,QAAQ,QAAQ,MAAM,UAAU,MAAM,IAAI;AAElD,MAAI;AAEF,UAAM,eAAe,MAAM,OAAO,QAAQ;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,cAAc;AAEhB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,yBAA+B;AACjE,YAAM,WAAW,MAAM,SAAS;AAAA,QAC9B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,aAAO;AAAA,QACL,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AAEd,UAAM,QAAQ,iBAAiB,UAC5B,MAAM,QAAQ,SAAS,KAAK,KAC5B,MAAM,QAAQ,SAAS,WAAW,KAClC,MAAM,QAAQ,SAAS,WAAW;AAErC,QAAI,OAAO;AACT,cAAQ,MAAM,iCAAiC,EAAE,KAAK,CAAC;AAAA,IACzD,OAAO;AAEL,cAAQ,KAAK,uCAAuC;AAAA,QAClD;AAAA,QACA,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D,CAAC;AAAA,IACH;AAAA,EACF;AAIA,SAAO;AAAA,IACL,MAAM;AAAA,EACR;AACF;AA0BA,eAAsB,cAAc,QAK8B;AAChE,QAAM,EAAE,QAAQ,QAAQ,OAAO,QAAQ,IAAI;AAE3C,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,MAAM,IAAI,OAAO,SAAS;AACxB,YAAM,aAAa,MAAM,aAAa;AAAA,QACpC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,aAAO,EAAE,MAAM,WAAW;AAAA,IAC5B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/server/server.d.mts

@@ -0,0 +1,9 @@
+export { c as createRiverbankClient } from './index-B0yI_V6Z.mjs';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-C6gmRHLe.mjs';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-CCf15nt8.mjs';
+export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-zhlL4YSE.mjs';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.mjs';

package/dist/server/server.d.ts

@@ -0,0 +1,9 @@
+export { c as createRiverbankClient } from './index-C6M0Wfjq.js';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-C6gmRHLe.js';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-BYmVMk0V.js';
+export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-CJcbYF3J.js';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.js';

package/dist/server/server.js

@@ -0,0 +1,21 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk4Z3GPTCSjs = require('./chunk-4Z3GPTCS.js');
+
+
+
+
+var _chunkF472SMKXjs = require('./chunk-F472SMKX.js');
+
+
+var _chunkADREPXFUjs = require('./chunk-ADREPXFU.js');
+require('./chunk-YXDDFG3N.js');
+require('./chunk-QQ6U4QX6.js');
+
+
+
+
+
+
+exports.createRiverbankClient = _chunk4Z3GPTCSjs.createRiverbankClient; exports.isEntryContent = _chunkF472SMKXjs.isEntryContent; exports.isPageContent = _chunkF472SMKXjs.isPageContent; exports.loadContent = _chunkF472SMKXjs.loadContent; exports.loadPage = _chunkADREPXFUjs.loadPage;
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/server.js"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACF,2RAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/server.js"}

package/dist/server/server.mjs

@@ -0,0 +1,21 @@
+import {
+  createRiverbankClient
+} from "./chunk-3KKZVGH4.mjs";
+import {
+  isEntryContent,
+  isPageContent,
+  loadContent
+} from "./chunk-PEAXKTDU.mjs";
+import {
+  loadPage
+} from "./chunk-2RW5HAQQ.mjs";
+import "./chunk-GWBMJPLH.mjs";
+import "./chunk-W3K7LVPS.mjs";
+export {
+  createRiverbankClient,
+  isEntryContent,
+  isPageContent,
+  loadContent,
+  loadPage
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/theme-bridge.d.mts

@@ -0,0 +1,232 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/**
+ * Theme Bridge Types
+ *
+ * Simplified theme configuration for SDK sites that want to style blocks
+ * without using the full CMS theme system.
+ */
+/**
+ * Corner radius presets.
+ */
+type ThemeBridgeCorners = 'square' | 'soft' | 'rounded' | 'pill';
+/**
+ * Shadow intensity presets.
+ */
+type ThemeBridgeShadows = 'none' | 'low' | 'medium' | 'high';
+/**
+ * Spacing density presets.
+ */
+type ThemeBridgeSpacing = 'comfortable' | 'standard' | 'dense';
+/**
+ * Typography configuration.
+ */
+interface ThemeBridgeTypography {
+    /** Font family for headings (defaults to system font stack) */
+    headingFamily?: string;
+    /** Font family for body text (defaults to system font stack) */
+    bodyFamily?: string;
+    /** Heading font weight (defaults to 600) */
+    headingWeight?: number;
+    /** Body font weight (defaults to 400) */
+    bodyWeight?: number;
+}
+/**
+ * Button component configuration for opt-in CSS generation.
+ */
+interface ThemeBridgeButtonConfig {
+    /**
+     * Which button variants to generate.
+     * @default ['primary', 'secondary', 'outline', 'ghost']
+     */
+    variants?: Array<'primary' | 'secondary' | 'outline' | 'ghost'>;
+}
+/**
+ * Card component configuration for opt-in CSS generation.
+ */
+interface ThemeBridgeCardConfig {
+    /**
+     * Which card variants to generate.
+     * @default ['default']
+     */
+    variants?: Array<'default' | 'elevated' | 'outlined'>;
+}
+/**
+ * Component CSS generation options.
+ * Set to `true` to use defaults, or provide config for customization.
+ */
+interface ThemeBridgeComponents {
+    /** Generate button CSS (.button-primary, .button-secondary, etc.) */
+    buttons?: boolean | ThemeBridgeButtonConfig;
+    /** Generate card CSS (.card-default, etc.) */
+    cards?: boolean | ThemeBridgeCardConfig;
+    /** Generate input CSS (.form-input, .form-label, etc.) */
+    inputs?: boolean;
+}
+/**
+ * Complete theme bridge configuration.
+ *
+ * @example Simple usage with tokens only
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       background: '#ffffff',
+ *       text: '#1e293b',
+ *     },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ *
+ * @example With component CSS
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       white: '#ffffff',
+ *       surface: '#f8fafc',
+ *       text: '#1e293b',
+ *       border: '#e2e8f0',
+ *     },
+ *     corners: 'rounded',
+ *     components: {
+ *       buttons: true,
+ *       cards: true,
+ *       inputs: true,
+ *     },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ *
+ * @example Pass-through to existing design system
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: 'var(--brand-purple)',
+ *       secondary: 'var(--brand-navy)',
+ *       background: 'var(--ds-bg)',
+ *     },
+ *     components: { buttons: true },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ */
+interface ThemeBridgeConfig {
+    /**
+     * Color tokens as key-value pairs.
+     *
+     * Keys become CSS variable names: `--color-{key}`
+     *
+     * Values can be:
+     * - Hex colors: `'#6d28d9'` (converted to RGB: `109 40 217`)
+     * - CSS variable refs: `'var(--brand-purple)'` (passed through)
+     * - RGB values: `'109 40 217'` (used directly)
+     *
+     * Common token names used by blocks:
+     * - `primary`, `secondary` - Brand colors
+     * - `background`, `surface` - Background colors
+     * - `text`, `mutedText` - Text colors
+     * - `border` - Border color
+     * - `white` - For button text on dark backgrounds
+     * - `success`, `warning`, `danger`, `info` - Status colors
+     */
+    tokens: Record<string, string>;
+    /** Typography settings */
+    typography?: ThemeBridgeTypography;
+    /** Spacing density (defaults to 'standard') */
+    spacing?: ThemeBridgeSpacing;
+    /** Corner radius preset (defaults to 'rounded') */
+    corners?: ThemeBridgeCorners;
+    /** Shadow intensity (defaults to 'medium') */
+    shadows?: ThemeBridgeShadows;
+    /**
+     * Opt-in component CSS generation.
+     *
+     * By default, only CSS variables are generated.
+     * Enable components to generate `.button-*`, `.card-*`, `.form-*` classes.
+     */
+    components?: ThemeBridgeComponents;
+    /**
+     * CSS overrides for component classes.
+     *
+     * Keys are CSS selectors (relative to the theme scope),
+     * values are CSS declaration blocks.
+     *
+     * @example
+     * ```tsx
+     * overrides: {
+     *   '.button-primary': 'border-radius: 9999px; font-weight: 700;',
+     *   '.button-primary:hover': 'transform: translateY(-2px);',
+     * }
+     * ```
+     */
+    overrides?: Record<string, string>;
+}
+/**
+ * Generated CSS output from theme bridge.
+ */
+interface ThemeBridgeOutput {
+    /** CSS variables as inline style object */
+    cssVars: Record<string, string>;
+    /** Complete CSS string for injection */
+    css: string;
+}
+
+interface ThemeBridgeProviderProps {
+    /** Theme configuration */
+    config: ThemeBridgeConfig;
+    /** Child elements to wrap */
+    children: React.ReactNode;
+    /** Additional class name for the wrapper */
+    className?: string;
+    /** HTML element to use for wrapper (defaults to 'div') */
+    as?: keyof React.JSX.IntrinsicElements;
+}
+/**
+ * Wraps content and injects CSS variables for Builder block styling.
+ *
+ * This component generates CSS variables from a simplified theme config
+ * and injects them into a wrapper element. All Builder blocks rendered
+ * inside will pick up these variables for colors, typography, spacing, etc.
+ *
+ * Optionally generates component CSS for buttons, cards, and inputs when
+ * `config.components` is specified.
+ */
+declare function ThemeBridgeProvider({ config, children, className, as: Tag, }: ThemeBridgeProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access generated CSS variables from theme config.
+ * Useful for custom components that need theme values.
+ */
+declare function useThemeBridgeCss(config: ThemeBridgeConfig): ThemeBridgeOutput;
+
+/**
+ * CSS Variable Generator for Theme Bridge
+ *
+ * Generates the CSS variables that Builder blocks expect,
+ * from a simplified ThemeBridgeConfig.
+ *
+ * Key differences from the full CMS theme system:
+ * - No shade generation (SDK sites define their own tokens)
+ * - Supports arbitrary token names
+ * - Supports pass-through of CSS variable references
+ * - Opt-in component CSS generation using core generators from @riverbankcms/blocks
+ */
+
+/**
+ * Generate CSS variables from a ThemeBridgeConfig.
+ */
+declare function generateThemeBridgeCss(config: ThemeBridgeConfig): ThemeBridgeOutput;
+
+export { type ThemeBridgeButtonConfig, type ThemeBridgeCardConfig, type ThemeBridgeComponents, type ThemeBridgeConfig, type ThemeBridgeCorners, type ThemeBridgeOutput, ThemeBridgeProvider, type ThemeBridgeProviderProps, type ThemeBridgeShadows, type ThemeBridgeSpacing, type ThemeBridgeTypography, generateThemeBridgeCss, useThemeBridgeCss };

package/dist/server/theme-bridge.d.ts

@@ -0,0 +1,232 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/**
+ * Theme Bridge Types
+ *
+ * Simplified theme configuration for SDK sites that want to style blocks
+ * without using the full CMS theme system.
+ */
+/**
+ * Corner radius presets.
+ */
+type ThemeBridgeCorners = 'square' | 'soft' | 'rounded' | 'pill';
+/**
+ * Shadow intensity presets.
+ */
+type ThemeBridgeShadows = 'none' | 'low' | 'medium' | 'high';
+/**
+ * Spacing density presets.
+ */
+type ThemeBridgeSpacing = 'comfortable' | 'standard' | 'dense';
+/**
+ * Typography configuration.
+ */
+interface ThemeBridgeTypography {
+    /** Font family for headings (defaults to system font stack) */
+    headingFamily?: string;
+    /** Font family for body text (defaults to system font stack) */
+    bodyFamily?: string;
+    /** Heading font weight (defaults to 600) */
+    headingWeight?: number;
+    /** Body font weight (defaults to 400) */
+    bodyWeight?: number;
+}
+/**
+ * Button component configuration for opt-in CSS generation.
+ */
+interface ThemeBridgeButtonConfig {
+    /**
+     * Which button variants to generate.
+     * @default ['primary', 'secondary', 'outline', 'ghost']
+     */
+    variants?: Array<'primary' | 'secondary' | 'outline' | 'ghost'>;
+}
+/**
+ * Card component configuration for opt-in CSS generation.
+ */
+interface ThemeBridgeCardConfig {
+    /**
+     * Which card variants to generate.
+     * @default ['default']
+     */
+    variants?: Array<'default' | 'elevated' | 'outlined'>;
+}
+/**
+ * Component CSS generation options.
+ * Set to `true` to use defaults, or provide config for customization.
+ */
+interface ThemeBridgeComponents {
+    /** Generate button CSS (.button-primary, .button-secondary, etc.) */
+    buttons?: boolean | ThemeBridgeButtonConfig;
+    /** Generate card CSS (.card-default, etc.) */
+    cards?: boolean | ThemeBridgeCardConfig;
+    /** Generate input CSS (.form-input, .form-label, etc.) */
+    inputs?: boolean;
+}
+/**
+ * Complete theme bridge configuration.
+ *
+ * @example Simple usage with tokens only
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       background: '#ffffff',
+ *       text: '#1e293b',
+ *     },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ *
+ * @example With component CSS
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: '#6d28d9',
+ *       secondary: '#4c1d95',
+ *       white: '#ffffff',
+ *       surface: '#f8fafc',
+ *       text: '#1e293b',
+ *       border: '#e2e8f0',
+ *     },
+ *     corners: 'rounded',
+ *     components: {
+ *       buttons: true,
+ *       cards: true,
+ *       inputs: true,
+ *     },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ *
+ * @example Pass-through to existing design system
+ * ```tsx
+ * <ThemeBridgeProvider
+ *   config={{
+ *     tokens: {
+ *       primary: 'var(--brand-purple)',
+ *       secondary: 'var(--brand-navy)',
+ *       background: 'var(--ds-bg)',
+ *     },
+ *     components: { buttons: true },
+ *   }}
+ * >
+ *   {children}
+ * </ThemeBridgeProvider>
+ * ```
+ */
+interface ThemeBridgeConfig {
+    /**
+     * Color tokens as key-value pairs.
+     *
+     * Keys become CSS variable names: `--color-{key}`
+     *
+     * Values can be:
+     * - Hex colors: `'#6d28d9'` (converted to RGB: `109 40 217`)
+     * - CSS variable refs: `'var(--brand-purple)'` (passed through)
+     * - RGB values: `'109 40 217'` (used directly)
+     *
+     * Common token names used by blocks:
+     * - `primary`, `secondary` - Brand colors
+     * - `background`, `surface` - Background colors
+     * - `text`, `mutedText` - Text colors
+     * - `border` - Border color
+     * - `white` - For button text on dark backgrounds
+     * - `success`, `warning`, `danger`, `info` - Status colors
+     */
+    tokens: Record<string, string>;
+    /** Typography settings */
+    typography?: ThemeBridgeTypography;
+    /** Spacing density (defaults to 'standard') */
+    spacing?: ThemeBridgeSpacing;
+    /** Corner radius preset (defaults to 'rounded') */
+    corners?: ThemeBridgeCorners;
+    /** Shadow intensity (defaults to 'medium') */
+    shadows?: ThemeBridgeShadows;
+    /**
+     * Opt-in component CSS generation.
+     *
+     * By default, only CSS variables are generated.
+     * Enable components to generate `.button-*`, `.card-*`, `.form-*` classes.
+     */
+    components?: ThemeBridgeComponents;
+    /**
+     * CSS overrides for component classes.
+     *
+     * Keys are CSS selectors (relative to the theme scope),
+     * values are CSS declaration blocks.
+     *
+     * @example
+     * ```tsx
+     * overrides: {
+     *   '.button-primary': 'border-radius: 9999px; font-weight: 700;',
+     *   '.button-primary:hover': 'transform: translateY(-2px);',
+     * }
+     * ```
+     */
+    overrides?: Record<string, string>;
+}
+/**
+ * Generated CSS output from theme bridge.
+ */
+interface ThemeBridgeOutput {
+    /** CSS variables as inline style object */
+    cssVars: Record<string, string>;
+    /** Complete CSS string for injection */
+    css: string;
+}
+
+interface ThemeBridgeProviderProps {
+    /** Theme configuration */
+    config: ThemeBridgeConfig;
+    /** Child elements to wrap */
+    children: React.ReactNode;
+    /** Additional class name for the wrapper */
+    className?: string;
+    /** HTML element to use for wrapper (defaults to 'div') */
+    as?: keyof React.JSX.IntrinsicElements;
+}
+/**
+ * Wraps content and injects CSS variables for Builder block styling.
+ *
+ * This component generates CSS variables from a simplified theme config
+ * and injects them into a wrapper element. All Builder blocks rendered
+ * inside will pick up these variables for colors, typography, spacing, etc.
+ *
+ * Optionally generates component CSS for buttons, cards, and inputs when
+ * `config.components` is specified.
+ */
+declare function ThemeBridgeProvider({ config, children, className, as: Tag, }: ThemeBridgeProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access generated CSS variables from theme config.
+ * Useful for custom components that need theme values.
+ */
+declare function useThemeBridgeCss(config: ThemeBridgeConfig): ThemeBridgeOutput;
+
+/**
+ * CSS Variable Generator for Theme Bridge
+ *
+ * Generates the CSS variables that Builder blocks expect,
+ * from a simplified ThemeBridgeConfig.
+ *
+ * Key differences from the full CMS theme system:
+ * - No shade generation (SDK sites define their own tokens)
+ * - Supports arbitrary token names
+ * - Supports pass-through of CSS variable references
+ * - Opt-in component CSS generation using core generators from @riverbankcms/blocks
+ */
+
+/**
+ * Generate CSS variables from a ThemeBridgeConfig.
+ */
+declare function generateThemeBridgeCss(config: ThemeBridgeConfig): ThemeBridgeOutput;
+
+export { type ThemeBridgeButtonConfig, type ThemeBridgeCardConfig, type ThemeBridgeComponents, type ThemeBridgeConfig, type ThemeBridgeCorners, type ThemeBridgeOutput, ThemeBridgeProvider, type ThemeBridgeProviderProps, type ThemeBridgeShadows, type ThemeBridgeSpacing, type ThemeBridgeTypography, generateThemeBridgeCss, useThemeBridgeCss };