@riverbankcms/sdk 0.143.0 → 0.145.0

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

@@ -1,3 +1,4 @@
+import type { BrowserReadAuthority } from "../../api/types";
 import type { DisplayMode, EventLayout } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import type { EventListingDisplay, EventListingInteractiveIslandProps } from "./EventListing.interactive";
@@ -36,6 +37,7 @@ export type EventCalendarHydration = EventCollectionHydration;
 type EventCalendarIslandMeta = Readonly<{
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
 }>;
 export declare function buildEventCalendarDisplay(source: EventCalendarSourceProps): EventCalendarDisplay;
@@ -52,7 +54,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
         hydration: Readonly<{
             calendarWindow?: import("../../../../contracts").CalendarWindowPage;
             siteId: string;
-            stage?: "preview" | "published";
             prefetchedEvents: boolean;
             eventSurface: import("../../..").EventSurfaceScope;
             filterEventPresets: string | null;
@@ -78,7 +79,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -98,7 +98,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -120,6 +119,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -130,7 +130,6 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
@@ -149,6 +148,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -159,7 +159,6 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCombined.client.d.ts

@@ -7,10 +7,9 @@ import type { EventCollectionHydration } from "./shared/eventCollectionContract"
 import { type CalendarDate, type CalendarViewport } from "./shared";
 import { type EventListPaginationAction, type EventPageSize } from "./shared/listOptions";
 import { type CalendarViewToggleOption } from "./shared/calendarViewOptions";
-export type EventCombinedClientProps = Readonly<{
+type EventCombinedControllerProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
-    stage?: "preview" | "published";
     listLayout?: EventLayout;
     listColumns?: ColumnOption;
     eventsPerPage?: EventPageSize;
@@ -40,6 +39,12 @@ export type EventCombinedClientProps = Readonly<{
     calendarContext: EventCollectionHydration["calendarContext"];
     calendarWindow?: EventCollectionHydration["calendarWindow"];
 }>;
+/** External SDK prop shape retained at blocks/client/events; hosted controllers
+ * obtain read mode exclusively from their provider, never from this metadata. */
+export type EventCombinedClientProps = EventCombinedControllerProps & Readonly<{
+    /** @deprecated Configure browsing authority on BlockApiProvider instead. */
+    stage?: "preview" | "published";
+}>;
 export type EventCombinedIslandClientProps = EventCombinedInteractiveIslandProps;
 type EventCombinedCalendarTabProps = Readonly<{
     calendarTabViews: CalendarTabViews;

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

@@ -1,3 +1,4 @@
+import type { BrowserReadAuthority } from "../../api/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import type { EventListingDisplay } from "./EventListing.interactive";
 import { type EventCollectionDisplay, type EventCollectionHydration, type EventCollectionSourceProps } from "./shared/eventCollectionContract";
@@ -10,6 +11,7 @@ export type EventCombinedHydration = EventCollectionHydration;
 type EventCombinedIslandMeta = Readonly<{
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
 }>;
 export declare function buildEventCombinedDisplay(source: EventCombinedSourceProps): EventCombinedDisplay;
@@ -25,6 +27,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
         events?: import("../../../../../../api/src/index").PublicEvent[] | null;
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
         listLayout?: import("../../..").EventLayout;
         listColumns?: import("../../..").ColumnOption;
@@ -60,7 +63,6 @@ export declare const eventCombinedBlockRuntime: Readonly<{
         hydration: Readonly<{
             calendarWindow?: import("../../../../contracts").CalendarWindowPage;
             siteId: string;
-            stage?: "preview" | "published";
             prefetchedEvents: boolean;
             eventSurface: import("../../..").EventSurfaceScope;
             filterEventPresets: string | null;
@@ -82,6 +84,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 events?: import("../../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
+                readAuthority?: BrowserReadAuthority;
                 stage?: "preview" | "published";
                 listLayout?: import("../../..").EventLayout;
                 listColumns?: import("../../..").ColumnOption;
@@ -118,6 +121,7 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 events?: import("../../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
+                readAuthority?: BrowserReadAuthority;
                 stage?: "preview" | "published";
                 listLayout?: import("../../..").EventLayout;
                 listColumns?: import("../../..").ColumnOption;
@@ -156,7 +160,6 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -176,7 +179,6 @@ export declare const eventCombinedBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -198,6 +200,7 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -208,7 +211,6 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
@@ -227,6 +229,7 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -237,7 +240,6 @@ export declare const eventCombinedInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;

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

@@ -3,10 +3,12 @@ import { type CardRole } from "../../../../../../theme-core/src/cards/index";
 import type { ButtonVariant, CardOrientation, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./shared/listOptions";
+import type { BrowserReadAuthority } from "../../api/types";
 export type EventListingSourceProps = Pick<EventCollectionSourceProps, "showFilters" | "showCategoryFilter" | "showVenueFilter" | "showStaffFilter" | "eventSurface" | "filterEventPresets" | "scheduleScope" | "seriesIds" | "filterCategoryIds" | "filterStaffMemberId" | "filterVenueId"> & Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
     layout?: EventLayout;
     columns?: ColumnOption;
@@ -42,7 +44,6 @@ export type EventListingDisplay = Readonly<{
 }>;
 export type EventListingHydration = Readonly<{
     siteId: string;
-    stage?: "preview" | "published";
     eventsPerPage: EventPageSize;
     paginationAction: EventListPaginationAction;
     showFilters: boolean;
@@ -61,6 +62,7 @@ export type EventListingHydration = Readonly<{
 type EventListingIslandMeta = Readonly<{
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
 }>;
 export type EventListingInteractiveIslandProps = InteractiveIslandProps<EventListingIslandMeta, "event-listing", typeof eventListingBlockRuntime>;
@@ -86,7 +88,6 @@ export declare const eventListingBlockRuntime: Readonly<{
         }>;
         hydration: Readonly<{
             siteId: string;
-            stage?: "preview" | "published";
             eventsPerPage: EventPageSize;
             paginationAction: EventListPaginationAction;
             showFilters: boolean;
@@ -129,7 +130,6 @@ export declare const eventListingBlockRuntime: Readonly<{
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: EventPageSize;
                     paginationAction: EventListPaginationAction;
                     showFilters: boolean;
@@ -166,7 +166,6 @@ export declare const eventListingBlockRuntime: Readonly<{
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: EventPageSize;
                     paginationAction: EventListPaginationAction;
                     showFilters: boolean;
@@ -190,6 +189,7 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -215,7 +215,6 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
             }>;
             hydration: Readonly<{
                 siteId: string;
-                stage?: "preview" | "published";
                 eventsPerPage: EventPageSize;
                 paginationAction: EventListPaginationAction;
                 showFilters: boolean;
@@ -236,6 +235,7 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -261,7 +261,6 @@ export declare const eventListingInteractiveIslandPropsCodec: Readonly<{
             }>;
             hydration: Readonly<{
                 siteId: string;
-                stage?: "preview" | "published";
                 eventsPerPage: EventPageSize;
                 paginationAction: EventListPaginationAction;
                 showFilters: boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { BrowserReadAuthority } from "../../../api/types";
 import { type CalendarWindowPage } from "../../../../blocks/events/shared/calendarWindow";
 import { type CardRole } from "../../../../../../../theme-core/src/cards/index";
 import { type BookingTimeZone } from "../../../../../../../core/src/index";
@@ -11,6 +12,7 @@ export type EventCollectionSourceProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
     listLayout?: EventLayout;
     listColumns?: ColumnOption;
@@ -73,7 +75,6 @@ export type EventCollectionDisplay = Readonly<{
 export type EventCollectionHydration = Readonly<{
     calendarWindow?: CalendarWindowPage;
     siteId: string;
-    stage?: "preview" | "published";
     prefetchedEvents: boolean;
     eventSurface: EventSurfaceScope;
     filterEventPresets: string | null;
@@ -93,8 +94,8 @@ export declare const eventCollectionFilterSourceSchemaShape: {
     readonly showVenueFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showStaffFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly eventSurface: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>>>;
@@ -139,8 +140,8 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly showVenueFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showStaffFilter: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly eventSurface: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>>>;
@@ -1149,6 +1150,7 @@ export declare const eventCollectionSourceSchemaShape: {
     }, z.core.$strip>]>>>>;
     readonly siteId: z.ZodString;
     readonly apiBaseUrl: z.ZodOptional<z.ZodString>;
+    readonly readAuthority: z.ZodOptional<z.ZodType<BrowserReadAuthority, unknown, z.core.$ZodTypeInternals<BrowserReadAuthority, unknown>>>;
     readonly stage: z.ZodOptional<z.ZodEnum<{
         published: "published";
         preview: "preview";
@@ -2211,8 +2213,8 @@ export declare const eventCollectionDisplaySchemaShape: {
     readonly showVenueFilter: z.ZodBoolean;
     readonly showStaffFilter: z.ZodBoolean;
     readonly eventSurface: z.ZodEnum<{
-        custom: "custom";
         all: "all";
+        custom: "custom";
         regularClassSchedule: "regularClassSchedule";
         specialDatedEvents: "specialDatedEvents";
     }>;

package/dist/_dts/blocks/src/system/runtime/nodes/header-control.d.ts

@@ -0,0 +1,10 @@
+import type { AriaAttributes, ReactNode } from 'react';
+type HeaderControlProps = Pick<AriaAttributes, 'aria-label' | 'aria-expanded' | 'aria-controls' | 'aria-haspopup'> & {
+    className?: string;
+    children?: ReactNode;
+    'data-nav-mobile-toggle'?: string;
+    'data-nav-mobile-trigger'?: string;
+};
+/** System navigation controls retain their runtime hooks independently of authored CTAs. */
+export declare function HeaderControlNode({ className, children, 'aria-label': label, 'aria-expanded': expanded, 'aria-controls': controls, 'aria-haspopup': hasPopup, 'data-nav-mobile-toggle': mobileToggle, 'data-nav-mobile-trigger': mobileTrigger, }: HeaderControlProps): import("react").JSX.Element;
+export {};

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

@@ -3,24 +3,9 @@ import Section from '../../../primitives/layout/Section';
 import { Stack as StackPrimitive } from '../../../primitives/layout/Stack';
 import { Inline as InlinePrimitive } from '../../../primitives/layout/Inline';
 import { Grid as GridPrimitive } from '../../../primitives/layout/Grid';
-type NodeMetadataProps = {
-    pathBase?: string;
-    blockId?: string | null;
-    blockKind?: string;
-    blockContent?: unknown;
-    fragmentRegistry?: unknown;
-    previewAuthoring?: unknown;
-};
-type SectionNodeProps = React.ComponentProps<typeof Section> & NodeMetadataProps;
-type StackNodeProps = React.ComponentProps<typeof StackPrimitive> & NodeMetadataProps;
-type InlineNodeProps = React.ComponentProps<typeof InlinePrimitive> & NodeMetadataProps;
-type GridNodeProps = React.ComponentProps<typeof GridPrimitive> & NodeMetadataProps;
-type DivNodeProps = React.ComponentProps<'div'> & NodeMetadataProps;
-type FigureNodeProps = React.ComponentProps<'figure'> & NodeMetadataProps;
-export declare const SectionNode: React.FC<SectionNodeProps>;
-export declare const StackNode: React.FC<StackNodeProps>;
-export declare const InlineNode: React.FC<InlineNodeProps>;
-export declare const GridNode: React.FC<GridNodeProps>;
-export declare const DivNode: React.FC<DivNodeProps>;
-export declare const FigureNode: React.FC<FigureNodeProps>;
-export {};
+export declare const SectionNode: React.FC<React.ComponentProps<typeof Section>>;
+export declare const StackNode: React.FC<React.ComponentProps<typeof StackPrimitive>>;
+export declare const InlineNode: React.FC<React.ComponentProps<typeof InlinePrimitive>>;
+export declare const GridNode: React.FC<React.ComponentProps<typeof GridPrimitive>>;
+export declare const DivNode: React.FC<React.ComponentProps<'div'>>;
+export declare const FigureNode: React.FC<React.ComponentProps<'figure'>>;

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

@@ -18,12 +18,31 @@ export type NewsletterFormSubmissionFields = Readonly<{
     phone?: string;
     honeypot: string;
 }>;
+/**
+ * Why the form refused to send, before any request was made. Visitors see one
+ * neutral message for all of these; the reason is for whoever is debugging.
+ *
+ * - `missing_block_source`: a page block hydrated without a content version
+ *   to submit against, so the API could not verify the placement.
+ * - `preview_only_source`: the footer editor's live widget, which renders
+ *   unsaved composition state and has nothing published to record against.
+ * - `setup_not_configured`: no mailing-list setup reached the block.
+ * - `destination_unavailable`: the setup is there but the placement's
+ *   destination (default list, custom targeting) is not in it.
+ * - `choices_unusable`: the offered topic choices no longer fit the provider.
+ */
+export type NewsletterSignupRefusalReason = 'missing_block_source' | 'preview_only_source' | 'setup_not_configured' | 'destination_unavailable' | 'choices_unusable';
 export type NewsletterSubmitTargetResolution = Readonly<{
     tag: 'ready';
     sourceRef: MailingListSignupSourceRef;
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'missing_block_source';
+    reason: Extract<NewsletterSignupRefusalReason, 'missing_block_source' | 'preview_only_source'>;
 }>;
+/**
+ * Logs a refusal with its reason so a QA session can tell the cases apart in
+ * the console, since the visitor-facing copy deliberately does not.
+ */
+export declare function reportNewsletterSignupRefusal(reason: NewsletterSignupRefusalReason, detail?: Readonly<Record<string, unknown>>): void;
 export declare function mapNewsletterFormFieldsToSubscriberInput(fields: NewsletterFormRawSubmissionFields): NewsletterFormSubmissionFields;
 export declare function resolveNewsletterSubmitTarget(input: NewsletterFormHydrationTarget): NewsletterSubmitTargetResolution;

package/dist/_dts/blocks/src/system/runtime/nodes/product-detail.server.d.ts

@@ -4,6 +4,7 @@ type ProductDetailProps = Readonly<{
     blockId?: string | null;
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;

package/dist/_dts/blocks/src/system/runtime/nodes/product-list.server.d.ts

@@ -4,6 +4,7 @@ type ProductListProps = Readonly<{
     blockId?: string | null;
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;

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

@@ -5,9 +5,11 @@ import { type CartDisplay, type CheckoutDisplay, type PassesMembershipsDisplay,
 import type { CommerceCartItem } from './shop-commerce.shared';
 import type { ShopDisplayConfig } from './shop.types';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
+import type { BrowserReadAuthority } from '../api/types';
 type ShopSourceProps = ShopDisplayConfig & Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>;
 export type { ShopSourceProps };
@@ -41,6 +43,7 @@ export type CheckoutHydration = Readonly<{
 type ShopIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>;
 export declare function resolveShowPricePerCredit(source: Pick<ShopSourceProps, 'showPricePerCredit'>): boolean;
@@ -514,6 +517,7 @@ export declare const shopInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -565,6 +569,7 @@ export declare const shopInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -618,6 +623,7 @@ export declare const productListInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -664,6 +670,7 @@ export declare const productListInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -712,6 +719,7 @@ export declare const productDetailInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -731,6 +739,7 @@ export declare const productDetailInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -752,6 +761,7 @@ export declare const cartInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";
@@ -786,6 +796,7 @@ export declare const cartInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";
@@ -822,6 +833,7 @@ export declare const checkoutInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";
@@ -845,6 +857,7 @@ export declare const checkoutInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";

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

@@ -4,6 +4,7 @@ type ShopProps = Readonly<{
     blockId?: string | null;
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     checkoutEndpoint?: string;
     children?: React.ReactNode;

package/dist/_dts/blocks/src/system/runtime/shared/components/ThemedButton.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+import { type ButtonSizeName, type ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
+type ThemedControlStyleProps = Readonly<{
+    variant: ThemeButtonVariantId;
+    size: ButtonSizeName;
+    extraClassName?: string | null;
+    screenReaderSuffix?: string;
+    labelClassName?: string;
+}>;
+type ThemedButtonPendingState = Readonly<{
+    label: string;
+    srLabel?: string;
+    spinnerSize?: 'xs' | 'sm';
+    spinnerClassName?: string;
+    contentClassName?: string;
+}>;
+export type ThemedButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'className' | 'dangerouslySetInnerHTML'> & ThemedControlStyleProps & Readonly<{
+    label: string | number;
+    pending?: ThemedButtonPendingState;
+}>;
+export declare function ThemedButton({ variant, size, extraClassName, screenReaderSuffix, labelClassName, pending, label, ...buttonProps }: ThemedButtonProps): React.ReactElement;
+export type ThemedButtonLinkProps = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'className' | 'dangerouslySetInnerHTML'> & ThemedControlStyleProps & Readonly<{
+    label: string | number;
+}>;
+export declare function ThemedButtonLink({ variant, size, extraClassName, screenReaderSuffix, labelClassName, label, ...anchorProps }: ThemedButtonLinkProps): React.ReactElement;
+export type ThemedButtonSpecimenProps = Readonly<{
+    variant: ThemeButtonVariantId;
+    size: ButtonSizeName;
+    label: string | number;
+    extraClassName?: string | null;
+    forceHover?: boolean;
+}>;
+/** Noninteractive button-style preview with no caller-owned markup. */
+export declare function ThemedButtonSpecimen({ variant, size, label, extraClassName, forceHover, }: ThemedButtonSpecimenProps): React.ReactElement;
+export type ThemedActionsButtonProps = Omit<ThemedButtonProps, 'label' | 'pending' | 'screenReaderSuffix' | 'labelClassName' | 'aria-label'>;
+/** Fixed icon-only actions control; callers cannot supply icon children. */
+export declare function ThemedActionsButton({ variant, size, extraClassName, ...buttonProps }: ThemedActionsButtonProps): React.ReactElement;
+export type ThemedDownloadLinkProps = ThemedButtonLinkProps;
+/** Fixed semantic download affordance; callers cannot supply arbitrary icon children. */
+export declare function ThemedDownloadLink({ variant, size, extraClassName, label, screenReaderSuffix, labelClassName, ...anchorProps }: ThemedDownloadLinkProps): React.ReactElement;
+export type ThemedAuthoredButtonProps = Readonly<{
+    label: string | number;
+    href?: string;
+    variant: ThemeButtonVariantId | null;
+    size: ButtonSizeName;
+    extraClassName?: string | null;
+    disabled?: boolean;
+    type?: 'button' | 'submit' | 'reset';
+    target?: string;
+    rel?: string;
+    ariaLabel?: string;
+    dataTestId?: string;
+    trailingIcon?: string;
+    onClick?: React.MouseEventHandler<HTMLElement>;
+}>;
+/** Boundary for authored button nodes and their registry-backed trailing icon. */
+export declare function ThemedAuthoredButton({ label, href, variant, size, extraClassName, disabled, type, target, rel, ariaLabel, dataTestId, trailingIcon, onClick, }: ThemedAuthoredButtonProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -25,3 +25,5 @@ export { StepIndicator } from './StepIndicator';
 export type { StepIndicatorBaseProps, StepIndicatorProps, } from './StepIndicator';
 export { RB_OPTION_CARD_CLASSES, SelectableOptionCard, } from './SelectableOptionCard';
 export type { SelectableOptionCardProps } from './SelectableOptionCard';
+export { ThemedActionsButton, ThemedAuthoredButton, ThemedButton, ThemedButtonLink, ThemedButtonSpecimen, ThemedDownloadLink } from './ThemedButton';
+export type { ThemedActionsButtonProps, ThemedAuthoredButtonProps, ThemedButtonProps, ThemedButtonLinkProps, ThemedButtonSpecimenProps, ThemedDownloadLinkProps } from './ThemedButton';

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

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { type SurfaceTone } from '../../../../../theme-core/src/surfaces/index';
+import { type TransformDefinition } from './core';
+declare const chromeLogoSurfaceValues: readonly ["header-root", "header-mobile-panel", "footer-root"];
+type ChromeLogoSurface = (typeof chromeLogoSurfaceValues)[number];
+declare const chromeLogoSchema: z.ZodObject<{
+    surface: z.ZodEnum<{
+        "header-root": "header-root";
+        "header-mobile-panel": "header-mobile-panel";
+        "footer-root": "footer-root";
+    }>;
+}, z.core.$strip>;
+export declare function resolveChromeSurfaceTone(surface: ChromeLogoSurface, context: Parameters<TransformDefinition['run']>[2]): SurfaceTone;
+/**
+ * Picks the site logo for the surface it is drawn on. Bound from block
+ * `content`: `logoVariants` when the renderer supplies both logos, otherwise
+ * the single `logo` older callers pass.
+ */
+export declare const chromeLogoTransform: TransformDefinition<z.infer<typeof chromeLogoSchema>>;
+export declare const chromeLogoTransforms: TransformDefinition<{
+    surface: "header-root" | "header-mobile-panel" | "footer-root";
+}>[];
+export {};

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

@@ -1,5 +1,6 @@
 import { formattingTransforms } from "./formatting";
 import { layoutTransforms } from "./layout";
+import { chromeLogoTransforms } from "./chromeLogo";
 import { uiTransforms } from "./ui";
 import { mediaTransforms } from "./media";
 import { backgroundTransforms } from "./background";
@@ -10,4 +11,4 @@ import { headerRuntimeTransforms } from "./headerRuntime";
 export declare const builtinTransformDefinitions: import("./core").TransformDefinition<unknown>[];
 export declare const defaultTransforms: import("./core").TransformRegistry;
 export { boxStyleClassNames } from "./_utils/boxStyleClassNames";
-export { formattingTransforms, layoutTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };
+export { formattingTransforms, layoutTransforms, chromeLogoTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { type ThemeHeader } from '../../../../../theme-core/src/schema';
+import { type ThemeFooter, type ThemeHeader } from '../../../../../theme-core/src/schema';
 import { type TransformDefinition } from './core';
+import { resolveSurfaceForeground, type ResolvedSurfaceForeground } from '../../../../../theme-core/src/surfaces/index';
 declare const headerLogoClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -41,6 +42,7 @@ export declare function resolveHeaderVisualStyles(header: Partial<ThemeHeader> |
     readonly backgroundToken: "transparent";
     readonly isTransparent: true;
 };
+export declare function resolveFooterRootForeground(footer: Partial<ThemeFooter> | undefined, palette: Parameters<typeof resolveSurfaceForeground>[1]): ResolvedSurfaceForeground;
 export declare const headerRootClassTransform: TransformDefinition<HeaderRootOptions>;
 declare const footerRootClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;