@riverbankcms/sdk 0.22.0 → 0.25.0

package/README.md

@@ -882,6 +882,21 @@ Override the header variant from your code:
 </Layout>
 ```
 
+### Opting Out of Theme Styling (Headless)
+
+If your SDK site brings its own global styles and you don't want the SDK to inject theme CSS variables, disable the theme scope wrapper:
+
+```tsx
+<Layout
+  siteData={siteData}
+  useThemeScope={false}
+  header={(data) => <CustomHeader {...data} />}
+  footer={() => <GlobalFooter />}
+>
+  <main>Fully custom styling</main>
+</Layout>
+```
+
 ### Fully Custom Headers
 
 Create your own header while using CMS navigation data:

package/dist/_dts/blocks/src/system/defineBlock.d.ts

@@ -54,8 +54,8 @@ export type BlockConfig = {
     includeContainerStyles?: boolean;
     /** Block description */
     description?: string;
-    /** Field ID to use as block title in lists (e.g., 'headline') */
-    titleSource?: string;
+    /** Field ID(s) to use as block title in lists (e.g., 'headline', or ['navLabel','title']) */
+    titleSource?: string | string[];
     /** Search/filter tags */
     tags?: string[];
     /** Icon name (Lucide icon) */

package/dist/_dts/blocks/src/system/fragments/utils/toRepeaterSchema.d.ts

@@ -22,6 +22,7 @@ export declare function fragmentsToRepeaterField(id: string, label: string, frag
     minItems?: number;
     maxItems?: number;
     itemLabel?: string;
+    itemLabelSource?: string;
     description?: string;
     allowConversion?: boolean;
     commonFields?: FieldDefinition[];

package/dist/_dts/blocks/src/system/manifest/fieldPath.d.ts

@@ -25,5 +25,5 @@ export type ResolvedBlockTitle = {
  */
 export declare function resolveBlockTitle(manifest: {
     title?: string;
-    titleSource?: string;
+    titleSource?: string | string[];
 } | null | undefined, blockContent: unknown, blockKind: string): ResolvedBlockTitle;

package/dist/_dts/blocks/src/system/manifest/schema.d.ts

@@ -3337,7 +3337,7 @@ export declare const manifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
     title: z.ZodString;
-    titleSource: z.ZodOptional<z.ZodString>;
+    titleSource: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     description: z.ZodOptional<z.ZodString>;
     component: z.ZodString;
     fields: z.ZodDefault<z.ZodArray<FieldSchemaUnion>>;
@@ -3507,8 +3507,8 @@ export interface SdkCustomBlock {
     id: `custom.${string}`;
     /** Display title in block picker */
     title: string;
-    /** Field ID to use as block title in lists (must match a field id) */
-    titleSource?: string;
+    /** Field ID(s) to use as block title in lists (must match field id(s)) */
+    titleSource?: string | string[];
     /** Description shown in block picker */
     description?: string;
     /** Category for block picker organization */

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -1396,8 +1396,8 @@ export type Database = {
                     paused_at: string | null;
                     site_id: string;
                     status: string;
-                    stripe_customer_id: string | null;
-                    stripe_subscription_id: string | null;
+                    stripe_customer_id: string;
+                    stripe_subscription_id: string;
                     updated_at: string;
                 };
                 Insert: {
@@ -1414,8 +1414,8 @@ export type Database = {
                     paused_at?: string | null;
                     site_id: string;
                     status: string;
-                    stripe_customer_id?: string | null;
-                    stripe_subscription_id?: string | null;
+                    stripe_customer_id: string;
+                    stripe_subscription_id: string;
                     updated_at?: string;
                 };
                 Update: {
@@ -1432,8 +1432,8 @@ export type Database = {
                     paused_at?: string | null;
                     site_id?: string;
                     status?: string;
-                    stripe_customer_id?: string | null;
-                    stripe_subscription_id?: string | null;
+                    stripe_customer_id?: string;
+                    stripe_subscription_id?: string;
                     updated_at?: string;
                 };
                 Relationships: [
@@ -8195,6 +8195,12 @@ export type Database = {
                 };
                 Returns: boolean;
             };
+            check_insert_policy: {
+                Args: {
+                    test_user_id: string;
+                };
+                Returns: boolean;
+            };
             checkout_course_atomic: {
                 Args: {
                     p_course_id: string;
@@ -8289,6 +8295,10 @@ export type Database = {
                     isSetofReturn: false;
                 };
             };
+            current_role_debug: {
+                Args: never;
+                Returns: string;
+            };
             enroll_in_course_atomic: {
                 Args: {
                     p_course_id: string;
@@ -8313,6 +8323,10 @@ export type Database = {
                     count: number;
                 }[];
             };
+            get_auth_uid_debug: {
+                Args: never;
+                Returns: string;
+            };
             get_auth_user_id_by_email: {
                 Args: {
                     p_email: string;

package/dist/_dts/sdk/src/components.d.ts

@@ -24,7 +24,7 @@
 export { Page } from './rendering/components/Page';
 export type { PageProps } from './rendering/components/Page';
 export { Layout } from './rendering/components/Layout';
-export type { LayoutProps, HeaderData } from './rendering/components/Layout';
+export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
 export { PageRenderer, buildThemeRuntime, RichText, resolveImageUrl, ImagePresets } from '@riverbankcms/blocks';
 export type { ImageOptions } from '@riverbankcms/blocks';
 export type { PageOutline, RouteMap, Theme, ThemeTokens, BlockOverrides, BlockOverrideComponent, SystemBlockComponentProps, HeroContent, BodyTextContent, RichTextPrimitiveProps, TipTapNode, } from '@riverbankcms/blocks';

package/dist/_dts/sdk/src/manifest/prompt/examples/types.d.ts

@@ -13,7 +13,7 @@ interface ConversionExampleOutput {
     blocks: Array<{
         id: string;
         title: string;
-        titleSource?: string;
+        titleSource?: string | string[];
         description?: string;
         category: string;
         icon?: string;

package/dist/_dts/sdk/src/manifest/validation/output-schema.d.ts

@@ -261,7 +261,7 @@ export type LlmNodeDefinition = z.infer<typeof llmNodeSchema>;
 export interface LlmCustomBlock {
     id: `custom.${string}`;
     title: string;
-    titleSource: string | null;
+    titleSource: string | string[] | null;
     description: string | null;
     category: BlockCategory;
     icon: string | null;

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -3,7 +3,7 @@
  *
  * Renders site header and footer around content. Fetches site data if not provided.
  */
-import { buildMenu, buildLogo } from '../../navigation';
+import { buildMenu, buildFooterMenu, buildLogo } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 export type HeaderData = {
     menu: ReturnType<typeof buildMenu>;
@@ -14,6 +14,7 @@ export type HeaderData = {
 };
 export type FooterData = {
     menu: ReturnType<typeof buildMenu>;
+    footerMenu: ReturnType<typeof buildFooterMenu>;
     logo: ReturnType<typeof buildLogo>;
     site: SiteResponse['site'];
     theme: SiteResponse['theme'];
@@ -38,6 +39,16 @@ export type LayoutProps = {
     hasPortalSession?: boolean;
     /** Render stage for internal links and block transforms. */
     previewStage?: 'published' | 'preview';
+    /**
+     * Wrap layout content in ThemeScope to inject theme CSS variables and styles.
+     * Enable this to use built-in theme styling from the CMS.
+     * Disable if you're bringing your own styles and want to avoid SDK-injected theme variables.
+     *
+     * Note: Disabling this while using the default header/footer (blocks) may result in unstyled output.
+     *
+     * @default true
+     */
+    useThemeScope?: boolean;
 };
 /**
  * Layout component that wraps content with site header and footer.
@@ -58,4 +69,4 @@ export type LayoutProps = {
  * </Layout>
  * ```
  */
-export declare function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header, footer, headerVariant, hasPortalSession, previewStage, }: LayoutProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header, footer, headerVariant, hasPortalSession, previewStage, useThemeScope, }: LayoutProps): Promise<import("react/jsx-runtime").JSX.Element>;

package/dist/_dts/sdk/src/rendering/server.d.ts

@@ -5,7 +5,7 @@
 export { Page } from './components/Page.server';
 export type { PageProps } from './components/Page.server';
 export { Layout } from './components/Layout';
-export type { LayoutProps, HeaderData } from './components/Layout';
+export type { LayoutProps, HeaderData, FooterData } from './components/Layout';
 export { Block } from './components/Block';
 export type { BlockProps } from './components/Block';
 /**

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.22.0";
+export declare const SDK_VERSION = "0.25.0";

package/dist/_dts/sdk/src/zod/titleSourceSchema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const titleSourceValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+export type TitleSourceValue = z.infer<typeof titleSourceValueSchema>;

package/dist/cli/index.js

@@ -1196,7 +1196,7 @@ z10.z.object({
   name: z10.z.string().min(1),
   version: z10.z.string().min(1),
   title: z10.z.string().min(1),
-  titleSource: z10.z.string().optional(),
+  titleSource: z10.z.union([z10.z.string().min(1), z10.z.array(z10.z.string().min(1)).min(1)]).optional(),
   description: z10.z.string().optional(),
   component: z10.z.string().min(1),
   fields: fieldSchema.array().default([]),
@@ -4448,7 +4448,7 @@ function fragmentsToRepeaterField(id, label, fragments, options = {}) {
     description: options.description,
     polymorphic: true,
     itemLabel: options.itemLabel ?? "Item",
-    itemLabelSource: "_type",
+    itemLabelSource: options.itemLabelSource ?? "_type",
     minItems: options.minItems ?? 0,
     maxItems: options.maxItems,
     allowConversion: options.allowConversion ?? true,
@@ -7170,6 +7170,7 @@ var columnsManifest = createBlockManifest({
       label: "Desktop columns",
       description: "Auto uses item count. Set this to create editorial layouts with column spans.",
       defaultValue: "auto",
+      ui: { intent: "display" },
       options: [
         { value: "auto", label: "Auto" },
         { value: "2", label: "2 columns" },
@@ -7542,9 +7543,10 @@ var textCardStylesField = (() => {
 })();
 var mediaTextManifest = createBlockManifest({
   id: "block.media-text",
-  title: "Media Text",
+  title: "Media and Text",
   category: "layout",
   includeContainerStyles: true,
+  titleSource: "title",
   additionalFields: [
     {
       id: "images",
@@ -10472,6 +10474,7 @@ var fields = parseFieldDefinitions([
     description: "Extend the gallery edge-to-edge by removing section side padding and container max-width.",
     defaultValue: false,
     ui: {
+      intent: "display",
       visibleWhen: { field: "variant", notIn: ["marquee"] }
     }
   },
@@ -10522,6 +10525,7 @@ var fields = parseFieldDefinitions([
       { value: "3", label: "Three at a time" }
     ],
     ui: {
+      intent: "display",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10537,6 +10541,7 @@ var fields = parseFieldDefinitions([
       { value: "3", label: "Three at a time" }
     ],
     ui: {
+      intent: "display",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10561,6 +10566,7 @@ var fields = parseFieldDefinitions([
     label: "Show arrows",
     defaultValue: true,
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10570,6 +10576,7 @@ var fields = parseFieldDefinitions([
     label: "Show dots",
     defaultValue: false,
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10579,6 +10586,7 @@ var fields = parseFieldDefinitions([
     label: "Autoplay",
     defaultValue: false,
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10594,6 +10602,7 @@ var fields = parseFieldDefinitions([
       { value: "10000", label: "10 seconds" }
     ],
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10607,6 +10616,7 @@ var fields = parseFieldDefinitions([
       { value: "hover", label: "Show on hover" }
     ],
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -10616,6 +10626,7 @@ var fields = parseFieldDefinitions([
     label: "Loop slides",
     defaultValue: true,
     ui: {
+      intent: "behavior",
       visibleWhen: { field: "variant", equals: "carousel" }
     }
   },
@@ -11624,6 +11635,7 @@ var teamMembersManifest = createBlockManifest({
         minItems: 0,
         maxItems: 50,
         itemLabel: "Team member",
+        itemLabelSource: "name",
         description: "Add people to this section."
       }
     )
@@ -17586,6 +17598,10 @@ var dashboardConfigSchema = z10.z.object({
   previewEditingEnabled: z10.z.boolean().optional(),
   navigation: dashboardNavigationConfigSchema.optional()
 }).strip();
+var titleSourceValueSchema = z10.z.union([
+  z10.z.string().min(1),
+  z10.z.array(z10.z.string().min(1)).min(1)
+]);
 
 // ../blocks/src/system/data/loaderEndpoints.ts
 var SUPPORTED_LOADER_ENDPOINTS = [
@@ -17762,7 +17778,7 @@ var sdkCustomBlockSchema = z10.z.object({
     message: "Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens"
   }),
   title: z10.z.string().min(1, "Title is required"),
-  titleSource: z10.z.string().optional(),
+  titleSource: titleSourceValueSchema.optional(),
   description: z10.z.string().optional(),
   category: blockCategoryEnum,
   icon: z10.z.string().optional(),
@@ -17784,18 +17800,21 @@ var sdkCustomBlockSchema = z10.z.object({
       icon: z10.z.string().min(1).optional()
     })
   ).optional()
-}).refine(
-  // Validate titleSource references a valid field if provided
-  (data) => {
-    if (!data.titleSource) return true;
+}).superRefine((data, ctx) => {
+  if (data.titleSource) {
     const fields3 = data.fields;
-    return fields3.some((field) => field.id === data.titleSource);
-  },
-  {
-    message: "titleSource must reference a valid field ID",
-    path: ["titleSource"]
+    const sources = Array.isArray(data.titleSource) ? data.titleSource : [data.titleSource];
+    sources.forEach((source, index) => {
+      const exists = fields3.some((field) => field.id === source);
+      if (!exists) {
+        ctx.addIssue({
+          code: z10.z.ZodIssueCode.custom,
+          message: `titleSource must reference a valid field ID (got "${source}")`,
+          path: Array.isArray(data.titleSource) ? ["titleSource", index] : ["titleSource"]
+        });
+      }
+    });
   }
-).superRefine((data, ctx) => {
   if (data.layout && data.variants) {
     ctx.addIssue({
       code: z10.z.ZodIssueCode.custom,
@@ -29504,7 +29523,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.22.0";
+var SDK_VERSION = "0.25.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
@@ -32527,7 +32546,10 @@ var llmCustomBlockSchema = z10.z.object({
     message: "Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens"
   }),
   title: z10.z.string().min(1, "Title is required"),
-  titleSource: z10.z.string().nullable(),
+  // Keep in sync with `sdkCustomBlockSchema` and the system manifest schema:
+  // - `null` used by OpenAI structured output for "optional" values
+  // - array allows multi-part titles (e.g. ["navLabel", "title"])
+  titleSource: titleSourceValueSchema.nullable(),
   description: z10.z.string().nullable(),
   category: blockCategoryEnum,
   icon: z10.z.string().nullable(),