@riverbankcms/sdk 0.152.0 → 0.154.0

package/dist/_dts/blocks/src/system/runtime/nodes/file-download.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import { type Media, type PublicDownloadMediaType } from '../../../lib/media';
+import { type PublicDownloadMediaType } from '../../../lib/media';
+import { type RuntimeMedia } from './media';
 import { type BlockButtonRole } from '../../constants/buttonRoles';
 export type FileDownloadNodeProps = Readonly<{
-    value?: Media | null;
+    value?: RuntimeMedia | null;
     title?: string | null;
     description?: string | null;
     buttonLabel?: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/form.fields.d.ts

@@ -1,5 +1,8 @@
 import React from 'react';
+import { type LookListPresentation } from '../lookSurfaces';
+type FieldPresentation = Pick<LookListPresentation, 'lookSlots'>;
 import type { FormFieldDef } from './form.types';
-export declare function FormFieldControl({ field }: Readonly<{
+export declare function FormFieldControl({ field, lookSlots }: Readonly<{
     field: FormFieldDef;
-}>): React.ReactElement;
+}> & FieldPresentation): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/form.interactive.d.ts

@@ -1,7 +1,8 @@
+import { type LookListPresentation } from '../lookSurfaces';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
 import { type FormFieldGroup } from './form-layout';
 import type { FormRecord } from './form.types';
-export type FormSourceProps = Readonly<{
+export type FormSourceProps = Pick<LookListPresentation, 'lookSlots'> & Readonly<{
     value?: FormRecord;
     siteId?: string;
     apiBaseUrl?: string;
@@ -10,7 +11,7 @@ export type FormSourceProps = Readonly<{
     className?: string;
     spamProtectionEnabled?: boolean;
 }>;
-export type FormDisplay = Readonly<{
+export type FormDisplay = Pick<LookListPresentation, 'lookSlots'> & Readonly<{
     kind: 'form';
     state: 'missing' | 'ready';
     className: string | null;
@@ -31,77 +32,26 @@ export declare function buildFormDisplay(source: FormSourceProps): FormDisplay;
 export type FormInteractiveIslandProps = InteractiveIslandProps<FormIslandMeta, 'form', typeof formBlockRuntime>;
 export declare const formBlockRuntime: Readonly<{
     kind: "progressive";
-    buildRender: (source: Readonly<{
-        value?: FormRecord;
-        siteId?: string;
-        apiBaseUrl?: string;
-        submitLabel?: string;
-        successMessage?: string | null;
-        className?: string;
-        spamProtectionEnabled?: boolean;
-    }>) => Readonly<{
-        display: Readonly<{
-            kind: "form";
-            state: "missing" | "ready";
-            className: string | null;
-            formId: string | null;
-            submitLabel: string;
-            successMessage: string | null;
-            form: FormRecord | null;
-            groups: readonly FormFieldGroup[];
-        }>;
+    buildRender: (source: FormSourceProps) => Readonly<{
+        display: FormDisplay;
         hydration: Readonly<{
             spamProtectionEnabled?: boolean;
         }>;
     }>;
     contracts: Readonly<{
         source: Readonly<{
-            encode: (value: Readonly<{
-                value?: FormRecord;
-                siteId?: string;
-                apiBaseUrl?: string;
-                submitLabel?: string;
-                successMessage?: string | null;
-                className?: string;
-                spamProtectionEnabled?: boolean;
-            }>) => unknown;
-            decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                value?: FormRecord;
-                siteId?: string;
-                apiBaseUrl?: string;
-                submitLabel?: string;
-                successMessage?: string | null;
-                className?: string;
-                spamProtectionEnabled?: boolean;
-            }>>;
+            encode: (value: FormSourceProps) => unknown;
+            decode: (input: unknown) => import("../../../contracts").DecodeResult<FormSourceProps>;
         }>;
         render: Readonly<{
             encode: (value: Readonly<{
-                display: Readonly<{
-                    kind: "form";
-                    state: "missing" | "ready";
-                    className: string | null;
-                    formId: string | null;
-                    submitLabel: string;
-                    successMessage: string | null;
-                    form: FormRecord | null;
-                    groups: readonly FormFieldGroup[];
-                }>;
+                display: FormDisplay;
                 hydration: Readonly<{
                     spamProtectionEnabled?: boolean;
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                display: Readonly<{
-                    kind: "form";
-                    state: "missing" | "ready";
-                    className: string | null;
-                    formId: string | null;
-                    submitLabel: string;
-                    successMessage: string | null;
-                    form: FormRecord | null;
-                    groups: readonly FormFieldGroup[];
-                }>;
+                display: FormDisplay;
                 hydration: Readonly<{
                     spamProtectionEnabled?: boolean;
                 }>;
@@ -118,16 +68,7 @@ export declare const formInteractiveIslandPropsCodec: Readonly<{
         render: Readonly<{
             mode: "form";
         } & Readonly<{
-            display: Readonly<{
-                kind: "form";
-                state: "missing" | "ready";
-                className: string | null;
-                formId: string | null;
-                submitLabel: string;
-                successMessage: string | null;
-                form: FormRecord | null;
-                groups: readonly FormFieldGroup[];
-            }>;
+            display: FormDisplay;
             hydration: Readonly<{
                 spamProtectionEnabled?: boolean;
             }>;
@@ -141,16 +82,7 @@ export declare const formInteractiveIslandPropsCodec: Readonly<{
         render: Readonly<{
             mode: "form";
         } & Readonly<{
-            display: Readonly<{
-                kind: "form";
-                state: "missing" | "ready";
-                className: string | null;
-                formId: string | null;
-                submitLabel: string;
-                successMessage: string | null;
-                form: FormRecord | null;
-                groups: readonly FormFieldGroup[];
-            }>;
+            display: FormDisplay;
             hydration: Readonly<{
                 spamProtectionEnabled?: boolean;
             }>;

package/dist/_dts/blocks/src/system/runtime/nodes/form.parts.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { FormDisplay } from './form.interactive';
+/** SSR and hydration consume the same decided field groups and Look hooks. */
+export declare function FormFieldGroups({ groups, lookSlots }: Pick<FormDisplay, 'groups' | 'lookSlots'>): React.ReactElement;
+export declare function FormSubmitAction({ lookSlots, submitLabel, disabled }: Pick<FormDisplay, 'lookSlots' | 'submitLabel'> & Readonly<{
+    disabled?: boolean;
+}>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/form.server.d.ts

@@ -1,20 +1,9 @@
 import React from 'react';
-import type { FormRecord } from './form.types';
-type FormNodeProps = {
+import { type FormSourceProps } from './form.interactive';
+type FormNodeProps = FormSourceProps & {
     blockId?: string | null;
-    value?: FormRecord;
-    submitLabel?: string;
-    successMessage?: string | null;
-    className?: string;
     onSubmit?: React.FormEventHandler<HTMLFormElement>;
-    /** Override server form action (defaults to /api/forms/submit). */
     action?: string;
-    /** Site ID for form submission */
-    siteId?: string;
-    /** API base URL for client-side fetching (passed from server to avoid env var resolution on client) */
-    apiBaseUrl?: string;
-    /** Enable spam protection (ALTCHA) */
-    spamProtectionEnabled?: boolean;
 };
 export declare const FormNodeSSR: React.FC<FormNodeProps>;
 export {};

package/dist/_dts/blocks/src/system/runtime/nodes/media.d.ts

@@ -1,6 +1,10 @@
 import React from 'react';
-import { type ResolvedMediaTransform, type DirectImageUrlOptions, type RenderableMediaAsset, type RenderableMediaAssetIndex } from '../../../../../media-core/src/index';
+import { type RuntimeMedia, type ManagedMediaResolution, type ResolvedMediaTransform, type DirectImageUrlOptions } from '../../../../../media-core/src/index';
 import type { Media } from '../../../lib/media';
+import { type ResolveImageUrlContext } from './mediaContext';
+export { buildMediaAssetIndex, buildResolveImageUrlContext, getCurrentResolveImageUrlContext, getSiteId, getSupabaseUrl, runWithMediaContext, setContextSupabaseUrl, setContextSiteId, setContextMediaAssetIndex, setContextMediaAssets, setContextResolveImageUrlContext, } from './mediaContext';
+export type { MediaAssetIndex, MediaAssetIndexItem, ResolveImageUrlContext, ResolveImageUrlContextInput } from './mediaContext';
+export type { RuntimeMedia } from '../../../../../media-core/src/index';
 /**
  * Options for image URL resolution.
  * Requires either dimensions or explicit original request.
@@ -18,24 +22,6 @@ export type ImageOptions = {
 } | {
     original: true;
 };
-export type ResolveImageUrlContext = {
-    supabaseUrl?: string;
-    siteId?: string;
-    /**
-     * Optional per-call media asset index for resolving identifier-only media values
-     * without mutating persisted content shapes.
-     */
-    mediaAssetIndex?: MediaAssetIndex;
-};
-export type ResolveImageUrlContextInput = Readonly<{
-    supabaseUrl?: string;
-    siteId?: string;
-    mediaAssetIndex?: MediaAssetIndex;
-    mediaAssets?: readonly MediaAssetIndexItem[];
-}>;
-export type MediaAssetIndexItem = RenderableMediaAsset;
-export type MediaAssetIndex = RenderableMediaAssetIndex;
-export declare function buildMediaAssetIndex(assets: readonly MediaAssetIndexItem[] | undefined): MediaAssetIndex | undefined;
 export type ResolveImageSourceSetOptions = {
     widthCandidates?: readonly number[];
     sizes?: string;
@@ -78,9 +64,8 @@ export type MediaUrlResolution = Readonly<{
     assetId?: string;
     identifier?: string | null;
 }>;
-export declare function buildResolveImageUrlContext(input: ResolveImageUrlContextInput | undefined): ResolveImageUrlContext;
-export declare function resolveMediaStorageUrl(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): string | undefined;
-export declare function resolveMediaStorageUrlResult(value: Media, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): MediaUrlResolution;
+export declare function resolveMediaStorageUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): string | undefined;
+export declare function resolveMediaStorageUrlResult(value: RuntimeMedia, context?: ResolveImageUrlContext | null, transformOptions?: DirectImageUrlOptions): MediaUrlResolution;
 /**
  * Common image size presets.
  * Use these for consistent sizing across the application.
@@ -111,68 +96,15 @@ export declare const ImagePresets: {
         readonly resize: "contain";
     };
 };
-/**
- * Media context for URL resolution.
- * Contains site-specific values needed to build storage URLs.
- */
-type MediaContext = {
-    supabaseUrl?: string;
-    siteId?: string;
-    mediaAssetIndex?: MediaAssetIndex;
-};
-/**
- * Run a function with the given media context.
- * On server: Uses AsyncLocalStorage to isolate context per request.
- * On client: Temporarily sets module-level context for the duration of the call.
- *
- * @example
- * ```tsx
- * runWithMediaContext(
- *   { supabaseUrl: 'https://...', siteId: 'abc-123' },
- *   () => renderPage(page)
- * )
- * ```
- */
-export declare function runWithMediaContext<T>(context: MediaContext, fn: () => T): T;
-/**
- * Set the Supabase URL in the current context.
- * @deprecated Use runWithMediaContext instead for request isolation.
- */
-export declare function setContextSupabaseUrl(url: string | undefined): void;
-/**
- * Set the site ID in the current context.
- * @deprecated Use runWithMediaContext instead for request isolation.
- */
-export declare function setContextSiteId(siteId: string | undefined): void;
-export declare function setContextMediaAssetIndex(index: MediaAssetIndex | undefined): void;
-export declare function setContextResolveImageUrlContext(context: ResolveImageUrlContext | undefined): void;
-export declare function getCurrentResolveImageUrlContext(): ResolveImageUrlContext | undefined;
-export declare function setContextMediaAssets(assets: readonly MediaAssetIndexItem[] | undefined): void;
-/**
- * Get the Supabase URL for constructing direct storage URLs.
- * Used for serving images directly from Supabase storage CDN.
- *
- * Resolution order:
- * 1. Context URL (set via runWithMediaContext or setContextSupabaseUrl)
- * 2. Environment variable NEXT_PUBLIC_SUPABASE_URL
- *
- * SDK sites receive the URL from the API, so they don't need the env var.
- * Dashboard and frontend apps use the env var.
- */
-export declare function getSupabaseUrl(): string;
-/**
- * Get the site ID for constructing storage paths.
- * Required for relative path resolution.
- */
-export declare function getSiteId(): string | undefined;
-export declare function resolveVideoPosterUrl(value: Media, context?: ResolveImageUrlContext | null): string | undefined;
-export declare function resolveMediaWithContext<TMedia extends Media>(value: TMedia, context?: ResolveImageUrlContext | null): TMedia;
+/** Resolve portable content without exposing runtime metadata as saved values. */
+export declare function resolveMediaWithContext<TReference extends Media>(reference: TReference, context?: ResolveImageUrlContext | null): ManagedMediaResolution<TReference>;
+export declare function resolveVideoPosterUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null): string | undefined;
 export type MediaImageLoading = NonNullable<React.ImgHTMLAttributes<HTMLImageElement>['loading']>;
 export type MediaImageFetchPriority = NonNullable<React.ImgHTMLAttributes<HTMLImageElement>['fetchPriority']>;
 export type MediaNodeProps = {
     "data-slot"?: string;
     "data-surface"?: string;
-    value?: Media | null;
+    value?: RuntimeMedia | null;
     className?: string;
     style?: React.CSSProperties;
     children?: React.ReactNode;
@@ -196,7 +128,7 @@ export type MediaNodeProps = {
     imageResolveContext?: ResolveImageUrlContext | null;
 };
 export type VideoPlaybackMode = 'inline' | 'background';
-export declare function resolveMediaNodeResponsiveImage(value: Media, size: ImageOptions, style: React.CSSProperties | undefined, slot: {
+export declare function resolveMediaNodeResponsiveImage(value: RuntimeMedia, size: ImageOptions, style: React.CSSProperties | undefined, slot: {
     fieldPath?: string;
     blockKind?: string | null;
     blockContent?: unknown;
@@ -207,14 +139,15 @@ export declare function resolveMediaNodeResponsiveImage(value: Media, size: Imag
     resolvedTransform?: ResolvedMediaTransform;
     isProxy?: boolean;
 };
-export declare function renderVideo(value: Media, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null, options?: {
+export declare function renderVideo(value: RuntimeMedia, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null, options?: {
     playback?: VideoPlaybackMode;
 }): React.ReactElement | null;
-export declare function renderAudio(value: Media, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null): React.ReactElement | null;
-export declare function computeMediaTransformStyle(value: Media, style?: React.CSSProperties, targetAspectRatio?: number | string, options?: {
+export declare function resolvePublicMediaUrl(value: RuntimeMedia, context?: ResolveImageUrlContext | null): string | undefined;
+export declare function renderAudio(value: RuntimeMedia, className?: string, style?: React.CSSProperties, context?: ResolveImageUrlContext | null): React.ReactElement | null;
+export declare function computeMediaTransformStyle(value: RuntimeMedia, style?: React.CSSProperties, targetAspectRatio?: number | string, options?: {
     resolvedTransform?: ResolvedMediaTransform;
     isProxy?: boolean;
-}): React.CSSProperties | undefined;
+}, context?: ResolveImageUrlContext | null): React.CSSProperties | undefined;
 export declare const computeHotspotStyle: typeof computeMediaTransformStyle;
 export declare function resolveTargetAspectRatio(size: ImageOptions): number | undefined;
 export declare function MediaPlaceholder({ className, style, fieldPath, authoring, }: {
@@ -246,10 +179,9 @@ export declare const MediaNode: React.FC<MediaNodeProps>;
  * resolveImageUrl(media, { original: true })
  * ```
  */
-export declare function resolveImageUrl(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): string | undefined;
-export declare function resolveImageUrlResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null): MediaUrlResolution;
-export declare function resolveImageUrlWithContext(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): string | undefined;
-export declare function resolveImageUrlWithContextResult(value: Media, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): MediaUrlResolution;
-export declare function resolveImageSourceSetWithContext(value: Media, options: ResolveImageSourceSetOptions, context?: ResolveImageUrlContext | null): ResolvedImageSourceSet | undefined;
+export declare function resolveImageUrl(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null): string | undefined;
+export declare function resolveImageUrlResult(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null): MediaUrlResolution;
+export declare function resolveImageUrlWithContext(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): string | undefined;
+export declare function resolveImageUrlWithContextResult(value: RuntimeMedia, options: ImageOptions, context?: ResolveImageUrlContext | null, transformAspectRatio?: number | string): MediaUrlResolution;
+export declare function resolveImageSourceSetWithContext(value: RuntimeMedia, options: ResolveImageSourceSetOptions, context?: ResolveImageUrlContext | null): ResolvedImageSourceSet | undefined;
 export declare function mediaImageHostProps(props: Pick<MediaNodeProps, 'value' | 'className' | 'loading' | 'fetchPriority' | 'data-slot' | 'data-surface'>, style: React.CSSProperties | undefined): React.ImgHTMLAttributes<HTMLImageElement> & Pick<MediaNodeProps, 'data-slot' | 'data-surface'>;
-export {};

package/dist/_dts/blocks/src/system/runtime/nodes/mediaContext.d.ts

@@ -0,0 +1,69 @@
+import { type RenderableMediaAsset, type RenderableMediaAssetIndex } from '../../../../../media-core/src/index';
+export type ResolveImageUrlContext = {
+    supabaseUrl?: string;
+    siteId?: string;
+    /**
+     * Optional per-call media asset index for resolving identifier-only media values
+     * without mutating persisted content shapes.
+     */
+    mediaAssetIndex?: MediaAssetIndex;
+};
+export type ResolveImageUrlContextInput = Readonly<{
+    supabaseUrl?: string;
+    siteId?: string;
+    mediaAssetIndex?: MediaAssetIndex;
+    mediaAssets?: readonly MediaAssetIndexItem[];
+}>;
+export type MediaAssetIndexItem = RenderableMediaAsset;
+export type MediaAssetIndex = RenderableMediaAssetIndex;
+export declare function buildMediaAssetIndex(assets: readonly MediaAssetIndexItem[] | undefined): MediaAssetIndex | undefined;
+export declare function buildResolveImageUrlContext(input: ResolveImageUrlContextInput | undefined): ResolveImageUrlContext;
+/**
+ * Media context for URL resolution.
+ * Contains site-specific values needed to build storage URLs.
+ */
+type MediaContext = {
+    supabaseUrl?: string;
+    siteId?: string;
+    mediaAssetIndex?: MediaAssetIndex;
+};
+/**
+ * Run a function with the given media context.
+ * On server: Uses AsyncLocalStorage to isolate context per request.
+ * On client: Temporarily sets module-level context for the duration of the call.
+ *
+ * @example
+ * ```tsx
+ * runWithMediaContext(
+ *   { supabaseUrl: 'https://...', siteId: 'abc-123' },
+ *   () => renderPage(page)
+ * )
+ * ```
+ */
+export declare function runWithMediaContext<T>(context: MediaContext, fn: () => T): T;
+export declare function setContextSupabaseUrl(url: string | undefined): void;
+/** @deprecated Use runWithMediaContext for request isolation. */
+export declare function setContextSiteId(siteId: string | undefined): void;
+export declare function setContextMediaAssetIndex(index: MediaAssetIndex | undefined): void;
+export declare function setContextResolveImageUrlContext(context: ResolveImageUrlContext | undefined): void;
+export declare function getCurrentResolveImageUrlContext(): ResolveImageUrlContext | undefined;
+export declare function setContextMediaAssets(assets: readonly MediaAssetIndexItem[] | undefined): void;
+/**
+ * Get the Supabase URL for constructing direct storage URLs.
+ * Used for serving images directly from Supabase storage CDN.
+ *
+ * Resolution order:
+ * 1. Context URL (set via runWithMediaContext or setContextSupabaseUrl)
+ * 2. Environment variable NEXT_PUBLIC_SUPABASE_URL
+ *
+ * SDK sites receive the URL from the API, so they don't need the env var.
+ * Dashboard and frontend apps use the env var.
+ */
+export declare function getSupabaseUrl(): string;
+/**
+ * Get the site ID for constructing storage paths.
+ * Required for relative path resolution.
+ */
+export declare function getSiteId(): string | undefined;
+export declare function getMediaAssetIndex(context?: ResolveImageUrlContext): MediaAssetIndex | undefined;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.interactive.d.ts

@@ -1,8 +1,9 @@
+import { type LookListPresentation } from '../lookSurfaces';
 import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
 import { type NewsletterButtonVariant, type NewsletterFieldDef, type NewsletterFormProps } from './newsletter-form.types';
 export type NewsletterFormSourceProps = NewsletterFormProps;
-export type NewsletterFormDisplay = Readonly<{
+export type NewsletterFormDisplay = Pick<LookListPresentation, 'lookSlots'> & Readonly<{
     kind: 'newsletter-form';
     availability: 'ready' | 'unavailable';
     className: string | null;
@@ -47,25 +48,12 @@ type NewsletterIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
 }>;
-export declare function buildNewsletterDisplay(source: Pick<NewsletterFormSourceProps, 'source' | 'mailingList' | 'targeting' | 'buttonVariant' | 'className'>): NewsletterFormDisplay;
+export declare function buildNewsletterDisplay(source: Pick<NewsletterFormSourceProps, 'source' | 'mailingList' | 'targeting' | 'buttonVariant' | 'className' | 'lookSlots'>): NewsletterFormDisplay;
 export type NewsletterFormInteractiveIslandProps = InteractiveIslandProps<NewsletterIslandMeta, 'newsletter-form', typeof newsletterFormBlockRuntime>;
 export declare const newsletterFormBlockRuntime: Readonly<{
     kind: "progressive";
     buildRender: (source: NewsletterFormProps) => Readonly<{
-        display: Readonly<{
-            kind: "newsletter-form";
-            availability: "ready" | "unavailable";
-            className: string | null;
-            buttonLabel: string;
-            successMessage: string;
-            buttonVariant: NewsletterButtonVariant;
-            privacyNote: string | null;
-            fields: readonly NewsletterFieldDef[];
-            choices: readonly Readonly<{
-                id: string;
-                label: string;
-            }>[];
-        }>;
+        display: NewsletterFormDisplay;
         hydration: Readonly<{
             target: NewsletterFormHydrationTarget;
             setupRevision: number | null;
@@ -81,20 +69,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
         }>;
         render: Readonly<{
             encode: (value: Readonly<{
-                display: Readonly<{
-                    kind: "newsletter-form";
-                    availability: "ready" | "unavailable";
-                    className: string | null;
-                    buttonLabel: string;
-                    successMessage: string;
-                    buttonVariant: NewsletterButtonVariant;
-                    privacyNote: string | null;
-                    fields: readonly NewsletterFieldDef[];
-                    choices: readonly Readonly<{
-                        id: string;
-                        label: string;
-                    }>[];
-                }>;
+                display: NewsletterFormDisplay;
                 hydration: Readonly<{
                     target: NewsletterFormHydrationTarget;
                     setupRevision: number | null;
@@ -104,20 +79,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                display: Readonly<{
-                    kind: "newsletter-form";
-                    availability: "ready" | "unavailable";
-                    className: string | null;
-                    buttonLabel: string;
-                    successMessage: string;
-                    buttonVariant: NewsletterButtonVariant;
-                    privacyNote: string | null;
-                    fields: readonly NewsletterFieldDef[];
-                    choices: readonly Readonly<{
-                        id: string;
-                        label: string;
-                    }>[];
-                }>;
+                display: NewsletterFormDisplay;
                 hydration: Readonly<{
                     target: NewsletterFormHydrationTarget;
                     setupRevision: number | null;
@@ -139,20 +101,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
         render: Readonly<{
             mode: "newsletter-form";
         } & Readonly<{
-            display: Readonly<{
-                kind: "newsletter-form";
-                availability: "ready" | "unavailable";
-                className: string | null;
-                buttonLabel: string;
-                successMessage: string;
-                buttonVariant: NewsletterButtonVariant;
-                privacyNote: string | null;
-                fields: readonly NewsletterFieldDef[];
-                choices: readonly Readonly<{
-                    id: string;
-                    label: string;
-                }>[];
-            }>;
+            display: NewsletterFormDisplay;
             hydration: Readonly<{
                 target: NewsletterFormHydrationTarget;
                 setupRevision: number | null;
@@ -170,20 +119,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
         render: Readonly<{
             mode: "newsletter-form";
         } & Readonly<{
-            display: Readonly<{
-                kind: "newsletter-form";
-                availability: "ready" | "unavailable";
-                className: string | null;
-                buttonLabel: string;
-                successMessage: string;
-                buttonVariant: NewsletterButtonVariant;
-                privacyNote: string | null;
-                fields: readonly NewsletterFieldDef[];
-                choices: readonly Readonly<{
-                    id: string;
-                    label: string;
-                }>[];
-            }>;
+            display: NewsletterFormDisplay;
             hydration: Readonly<{
                 target: NewsletterFormHydrationTarget;
                 setupRevision: number | null;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.parts.d.ts

@@ -1,15 +1,15 @@
+import { type LookListPresentation } from '../lookSurfaces';
 import React from 'react';
 import type { NewsletterButtonVariant, NewsletterFieldDef } from './newsletter-form.types';
 /**
  * Newsletter form pieces shared by the SSR render and the hydrated island, so
  * both produce the same markup.
  *
- * Labels are visually hidden: every field has a placeholder, and a visible
- * "Email *" label over a single field reads like a generic form. Screen
- * readers still get the label.
+ * Legacy layouts keep visually hidden labels and the joined email/button.
+ * Compiler-owned Look hooks expose labelled controls and a separate action.
  */
 export declare const TOPIC_CHOICE_FIELD_ID = "mailingListChoice";
-type FieldState = Readonly<{
+type FieldState = Pick<LookListPresentation, 'lookSlots'> & Readonly<{
     disabled?: boolean;
     error?: string | null;
 }>;
@@ -18,7 +18,7 @@ export declare function partitionNewsletterFields(fields: readonly NewsletterFie
     email: NewsletterFieldDef | null;
     extra: readonly NewsletterFieldDef[];
 }>;
-export declare function NewsletterExtraField({ field, disabled, error, }: Readonly<{
+export declare function NewsletterExtraField({ field, disabled, error, lookSlots, }: Readonly<{
     field: NewsletterFieldDef;
 }> & FieldState): React.ReactElement;
 /** The email field and submit button sharing one input-styled shell. */
@@ -31,7 +31,7 @@ export declare function NewsletterEmailEntry({ field, buttonVariant, buttonLabel
  * The submit action: joined to the email field when the preset has one
  * (every current preset does), otherwise a plain themed button.
  */
-export declare function NewsletterSubmitRow({ emailField, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
+export declare function NewsletterSubmitRow({ emailField, lookSlots, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
     emailField: NewsletterFieldDef | null;
     buttonVariant: NewsletterButtonVariant;
     buttonLabel: string;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.types.d.ts

@@ -5,6 +5,7 @@
  */
 import type { MailingListGlobalForm, MailingListPlacementTargeting, MailingListRuntimeContext, MailingListSignupSourceRef } from '../../../../../core/src/index';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
+import type { LookListPresentation } from '../lookSurfaces';
 import type { NewsletterBlockSubmission } from './newsletter-form.block-submission';
 export type NewsletterPreset = MailingListGlobalForm['fields']['preset'];
 export type NewsletterFieldDef = {
@@ -15,7 +16,7 @@ export type NewsletterFieldDef = {
     placeholder?: string;
 };
 export type NewsletterButtonVariant = BlockButtonRole;
-type NewsletterFormCommonProps = {
+type NewsletterFormCommonProps = Pick<LookListPresentation, 'lookSlots'> & {
     /** Site ID for API calls */
     siteId?: string;
     /** API base URL for client-side fetching */
@@ -52,5 +53,5 @@ export type NewsletterFormProps = NewsletterFormCommonProps & (BlockNewsletterFo
 /**
  * Get form fields based on preset configuration.
  */
-export declare function getGlobalFormFields(form: MailingListGlobalForm): NewsletterFieldDef[];
+export declare function getGlobalFormFields(form: MailingListGlobalForm, presentation?: Pick<LookListPresentation, "lookSlots">): NewsletterFieldDef[];
 export {};

package/dist/_dts/blocks/src/system/runtime/nodes/shared/contract-schemas.d.ts

@@ -18,8 +18,8 @@ export declare const eventButtonVariantSchema: z.ZodEnum<{
     ghost: "ghost";
 }>;
 export declare const eventLayoutSchema: z.ZodEnum<{
-    stack: "stack";
     compact: "compact";
+    stack: "stack";
     grid: "grid";
 }>;
 export declare const eventCalendarDisplayModeSchema: z.ZodEnum<{
@@ -44,8 +44,8 @@ export declare const weekStartSchema: z.ZodEnum<{
 }>;
 export declare const filterAutoShowSchema: z.ZodEnum<{
     auto: "auto";
-    never: "never";
     always: "always";
+    never: "never";
 }>;
 export declare const calendarTabViewsSchema: z.ZodEnum<{
     week: "week";

package/dist/_dts/blocks/src/system/transforms/registry/_utils/surfaceForegroundStyles.d.ts

@@ -1,3 +1,4 @@
+import { surfaceDecorationColors } from '../../../../../../theme-core/src/site-styles/index';
 import { resolveSurfaceForeground, type ResolvedSurfaceForeground } from '../../../../../../theme-core/src/surfaces/index';
 import type { ThemeFooter, ThemeHeader } from '../../../../../../theme-core/src/schema';
 import type { ThemeColorToken } from '../../../../../../theme-core/src/tokens/index';
@@ -7,3 +8,5 @@ export declare function resolveFooterRootForeground(footer: Partial<ThemeFooter>
 export declare function resolveSurfaceForegroundStyles(value: unknown, context: TransformContext, options?: Readonly<{
     fallbackToken?: string;
 }>): Record<string, string>;
+/** Decoration roles already resolved by the surface owner, shared with footer arrangements. */
+export declare function surfaceInkStyles(foreground: ResolvedSurfaceForeground, palette: Parameters<typeof surfaceDecorationColors>[1]): Record<string, string>;