@riverbankcms/sdk 0.104.3 → 0.107.0

package/dist/_dts/api/src/sdkContracts.d.ts

@@ -294,6 +294,27 @@ export interface SdkMediaFinalizeUploadResponse {
 export interface SdkPullMeta {
     pulledAt: string;
 }
+/**
+ * Explicitly describes payload truncation applied by a pull endpoint.
+ * Pagination metadata remains responsible for caller-requested pages.
+ */
+export type SdkPullTruncationMeta = {
+    truncated: false;
+    returned: number;
+    capPerType?: never;
+    capTotal?: never;
+    droppedTypes?: never;
+} | ({
+    truncated: true;
+    returned: number;
+    droppedTypes: readonly [string, ...string[]];
+} & ({
+    capPerType: number;
+    capTotal?: number;
+} | {
+    capPerType?: number;
+    capTotal: number;
+}));
 export interface SdkPullSiteInfoResponse {
     supabaseUrl: string;
     meta: {
@@ -336,6 +357,17 @@ export interface SdkPullPagesResponse {
     pages: SdkPullPage[];
     meta: SdkPullMeta;
 }
+export interface SdkGetPageBlock {
+    id: string;
+    identifier: string;
+    kind: string;
+    position: number;
+    data: Record<string, unknown>;
+    contentHash: string;
+}
+export interface SdkGetPageBlockResponse {
+    block: SdkGetPageBlock;
+}
 export interface SdkPullNavigationItem {
     id: string;
     menuId: string;
@@ -423,6 +455,12 @@ export interface SdkPullThemeResponse {
     theme: Theme | null;
     themeId: string | null;
     selectionId: string | null;
+    /**
+     * Current style-selection concurrency token. Pass this value as
+     * `baseSelectionVersion` when applying a style; it is 0 when no selection
+     * exists.
+     */
+    selectionVersion: number;
     meta: SdkPullThemeMeta;
 }
 export interface SdkPullFooterMeta extends SdkPullMeta {
@@ -622,8 +660,7 @@ export interface SdkPullEntriesResponse {
     }>;
     meta: SdkPullMeta & {
         entries: Record<string, SdkPullEntryTimestamps>;
-        truncated: boolean;
-        truncationMessage?: string;
+        truncation: SdkPullTruncationMeta;
     };
     pagination: SdkPullPagination;
 }
@@ -641,8 +678,7 @@ export interface SdkPullEntriesAllResponse {
         totalEntries: number;
         contentTypes: string[];
         entries: Record<string, SdkPullEntryTimestamps>;
-        truncated: boolean;
-        truncationMessage?: string;
+        truncation: SdkPullTruncationMeta;
     };
 }
 export interface SdkManagementPage {
@@ -700,6 +736,31 @@ export type SdkManagementCourseRun = SdkPullCourseRun & {
 export interface SdkPageResponse {
     page: SdkManagementPage;
 }
+export type SdkUpsertPageResponse = SdkPageResponse & SdkPublicationStageFields<SdkPagePublishErrorCode>;
+export interface SdkDraftPage {
+    identifier: string;
+    hasUnpublishedChanges: boolean;
+    status: 'draft' | 'published';
+}
+export interface SdkDraftEntry {
+    contentType: string;
+    identifier: string;
+    status: 'draft' | 'published';
+}
+/**
+ * Cross-type overview of everything with pending (unpublished) changes.
+ * Fully enumerated server-side — a resource appears here iff it is a draft or
+ * carries unpublished changes. There is no cap and no post-pagination filter.
+ */
+export interface SdkPullDraftsResponse {
+    pages: SdkDraftPage[];
+    entries: SdkDraftEntry[];
+    summary: {
+        pageCount: number;
+        entryCount: number;
+    };
+    meta: SdkPullMeta;
+}
 export interface SdkUpsertBlockResponse {
     block: SdkManagementBlock;
 }
@@ -709,9 +770,58 @@ export interface SdkDeleteResponse {
 export interface SdkReorderResponse {
     reordered: true;
 }
-export interface SdkUpsertEntryResponse {
-    entry: Omit<SdkManagementEntry, 'publishedData'>;
+/** Closed publish-failure code union for entry upserts. */
+export type SdkEntryPublishErrorCode = 'PUBLISH_ENTRY_FAILED';
+/** Closed publish-failure code union for page upserts. */
+export type SdkPagePublishErrorCode = 'PUBLISH_PAGE_FAILED';
+/**
+ * Machine-readable detail for a publish that failed after a successful save.
+ * `TCode` is the endpoint's closed code union — an entry response cannot carry
+ * a page code and vice versa. `message` is a sanitized public message; the raw
+ * internal cause is logged server-side, never sent over the wire.
+ */
+export interface SdkPublishError<TCode extends string> {
+    code: TCode;
+    message: string;
 }
+/**
+ * Outcome of the optional publish stage on an entry/page upsert.
+ *
+ * Mutation and publication are NOT atomic (page publish is explicitly
+ * non-transactional), so the save and the publish are reported as distinct
+ * stages. Modeled as a discriminated union on `published` so a success can
+ * never carry an error and a failure can never omit one.
+ *
+ * Accepted limitations (documented, not bugs to fix here):
+ * - Page publish is a non-transactional multi-step flow: a mid-loop failure can
+ *   leave partial published state (some blocks promoted). The envelope reports
+ *   `published: false` and re-running publish is safe/idempotent.
+ * - The entity returned alongside a successful publish comes from a re-read
+ *   after the publish, not an atomic snapshot; a concurrent write in that
+ *   window can be reflected in the returned entity.
+ */
+export type SdkPublicationOutcome<TCode extends string> = {
+    published: true;
+} | {
+    published: false;
+    publishError: SdkPublishError<TCode>;
+};
+/**
+ * Publication-stage fields for upsert responses, correlated so invalid states
+ * are unrepresentable: a draft upsert carries neither field (response is
+ * byte-identical to the pre-publication-intent contract), and a publish-intent
+ * upsert always carries both `saved: true` and a publication outcome.
+ */
+export type SdkPublicationStageFields<TCode extends string> = {
+    saved?: never;
+    publication?: never;
+} | {
+    saved: true;
+    publication: SdkPublicationOutcome<TCode>;
+};
+export type SdkUpsertEntryResponse = {
+    entry: Omit<SdkManagementEntry, 'publishedData'>;
+} & SdkPublicationStageFields<SdkEntryPublishErrorCode>;
 export interface SdkPublishOrUnpublishEntryResponse {
     entry: Omit<SdkManagementEntry, 'publishedData'>;
 }

package/dist/_dts/api/src/siteOperations.d.ts

@@ -540,6 +540,7 @@ export type SendShopOrderPaymentReminderResponse = {
     recipientEmail: string;
 };
 export type SettleShopOrderPaymentRequest = {
+    operationId: string;
     action: "mark_paid" | "mark_waived" | "record_partial_payment";
     amountCents?: number | null;
     externalReference?: string | null;

package/dist/_dts/api/src/sitePlatformEndpoints.d.ts

@@ -1,4 +1,5 @@
 import type { Theme } from '../../blocks/src/index';
+import type { SiteCommandOf } from '../../site-commands/src/index';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { AdminCreateSiteRequest, AdminCreateSiteResponse, AdminDeletePriceOverrideRequest, AdminDeletePriceOverrideResponse, AdminDeleteSiteResponse, AdminGetPriceOverrideQuery, AdminGetPriceOverrideResponse, AdminUpsertPriceOverrideRequest, AdminUpsertPriceOverrideResponse } from './accessAdmin';
 import type { MutableCourseStatus } from './courses';
@@ -9,7 +10,7 @@ import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSit
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from './siteRuntimeEndpoints';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { StripeConnectDisconnectResponse, StripeConnectStartResponse, StripeConnectStatusResponse, UpdateStripeAutomaticTaxRequest } from './billing';
 import type { NavigationLinkInput } from './navigation/types';
@@ -188,6 +189,9 @@ export type SitePlatformAPIEndpoints = {
     sdkPullPages: APIEndpoint<never, {
         siteId: string;
     }, SdkPullPagesResponse>;
+    sdkPullDrafts: APIEndpoint<never, {
+        siteId: string;
+    }, SdkPullDraftsResponse>;
     sdkPullNavigation: APIEndpoint<never, {
         siteId: string;
     }, SdkPullNavigationResponse>;
@@ -235,9 +239,10 @@ export type SitePlatformAPIEndpoints = {
         path: string;
         seoTitle?: string;
         seoDescription?: string;
+        publication?: 'draft' | 'publish';
     }, {
         siteId: string;
-    }, SdkPageResponse>;
+    }, SdkUpsertPageResponse>;
     sdkPublishPage: APIEndpoint<never, {
         siteId: string;
         identifier: string;
@@ -246,6 +251,12 @@ export type SitePlatformAPIEndpoints = {
         siteId: string;
         identifier: string;
     }, SdkPageResponse>;
+    sdkDeletePage: APIEndpoint<never, {
+        siteId: string;
+        identifier: string;
+    }, {
+        deleted: true;
+    }>;
     sdkUpsertPageBlock: APIEndpoint<{
         identifier: string;
         kind: string;
@@ -262,6 +273,11 @@ export type SitePlatformAPIEndpoints = {
     }, {
         deleted: true;
     }>;
+    sdkGetPageBlock: APIEndpoint<never, {
+        siteId: string;
+        identifier: string;
+        blockIdentifier: string;
+    }, SdkGetPageBlockResponse>;
     sdkReorderPageBlocks: APIEndpoint<{
         identifiers: string[];
     }, {
@@ -285,11 +301,16 @@ export type SitePlatformAPIEndpoints = {
     }, {
         deleted: true;
     }>;
-    sdkUpsertTheme: APIEndpoint<{
+    sdkUpsertTheme: APIEndpoint<Readonly<{
+        kind: 'update';
         theme: Theme;
         themeId?: string;
         selectionId?: string;
-    }, {
+    }> | Readonly<{
+        /** The first theme is compiled authoritatively from this command. */
+        kind: 'initialize';
+        command: SiteCommandOf<'applySiteStyleSelection'>;
+    }>, {
         siteId: string;
     }, SdkUpsertThemeResponse>;
     sdkApplySiteStyleSelection: APIEndpoint<ApplySiteStyleSelectionBody, {
@@ -424,6 +445,7 @@ export type SitePlatformAPIEndpoints = {
         slug?: string;
         manualOrder?: number;
         blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
+        publication?: 'draft' | 'publish';
     }, {
         siteId: string;
     }, SdkUpsertEntryResponse>;

package/dist/_dts/api/src/siteRuntimeEndpoints.d.ts

@@ -1,9 +1,9 @@
 import type { BackgroundOverride, SystemCustomizeFacetSelection, Theme } from '../../blocks/src/index';
 import type { ListMediaAssetsResult, MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import type { DbJson } from '../../db/src/index';
-import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, LayoutVariantKey, SiteStyleId, TypographyPresetId } from '../../theme-core/src/site-styles/index';
+import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, LayoutVariantKey, SiteStyleId } from '../../theme-core/src/site-styles/index';
 import type { ButtonPersonalityId } from '../../theme-core/src/buttons/index';
-import type { PaletteCommand, PaletteOverrides, PaletteSelection, CuratedPaletteId } from '../../theme-core/src/palette/index';
+import type { PaletteCommand, PaletteLibraryAuthority, PaletteSelection } from '../../theme-core/src/palette/index';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { AnalyticsReportQuery, AnalyticsReportResponse } from './analytics';
 import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
@@ -21,40 +21,42 @@ import type { DevToolsGetSiteRoleDowngradeQuery, DevToolsImpersonationResponse,
  */
 export type SiteThemeSelectionsPayload = {
     buttonPersonalityId?: ButtonPersonalityId | null;
-    paletteVariantId?: CuratedPaletteId | null;
-    paletteOverrides?: PaletteOverrides | null;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
     headerLookId?: HeaderLookId | null;
     footerLookId?: FooterLookId | null;
 };
-type ApplySiteStyleSelectionCommonBody = Readonly<{
+export type ApplySiteStyleSelectionCommonBody = Readonly<{
     siteStyleId: SiteStyleId;
-    buttonPersonalityId: ButtonPersonalityId | null;
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
-    customTypography?: Theme['typography'] | null;
-    headerLookId: HeaderLookId | null;
-    headerLayoutId?: HeaderLayoutId | null;
-    headerStyleId?: HeaderStyleId | null;
-    footerLookId: FooterLookId | null;
+    /** Omitted or `null` selects the first button personality recommended by the site style; a value selects that personality. */
+    buttonPersonalityId?: ButtonPersonalityId | null;
+    /** Omitted selects the site style's authoritative concrete typography; a value applies submitted concrete typography. */
+    typography?: Theme['typography'];
+    /** Omitted or `null` selects the first header Look recommended by the site style; a value selects that Look. When both header pair fields are omitted, a supplied Look derives the canonical pair when it has one. */
+    headerLookId?: HeaderLookId | null;
+    /** Omitted or `null` selects the first footer Look recommended by the site style; a value selects that Look. */
+    footerLookId?: FooterLookId | null;
     baseSelectionVersion: number;
+    /** Omitted or `null` lets the server target the current selection; a value targets that selection row. */
     selectionId?: string | null;
 }>;
-export type ApplySiteStyleSelectionBody = ApplySiteStyleSelectionCommonBody & (Readonly<{
-    paletteCommand: PaletteCommand;
-    paletteVariantId?: never;
-    paletteOverrides?: never;
+export type ApplySiteStyleSelectionHeaderBody = Readonly<{
+    /** Omit both fields to use the curated site style's canonical header default; when `headerLookId` is supplied, derive the pair from that Look when it has a canonical alias. */
+    headerLayoutId?: undefined;
+    headerStyleId?: undefined;
 }> | Readonly<{
-    /** Bounded input adapter for callers not yet emitting commands. */
-    paletteCommand?: undefined;
-    paletteVariantId: CuratedPaletteId | null;
-    paletteOverrides: PaletteOverrides | null;
-}>);
+    /** Send both fields as `null` to use the legacy header default. */
+    headerLayoutId: null;
+    headerStyleId: null;
+}> | Readonly<{
+    /** Canonical header selections are atomic: layout and style must be supplied together. */
+    headerLayoutId: HeaderLayoutId;
+    headerStyleId: HeaderStyleId;
+}>;
+export type ApplySiteStyleSelectionBody = ApplySiteStyleSelectionCommonBody & Readonly<{
+    /** Omitted selects the site style's recommended curated palette; a command applies that palette operation. */
+    paletteCommand?: PaletteCommand;
+}> & ApplySiteStyleSelectionHeaderBody;
 export type ApplySiteStyleSelectionResponse = Readonly<{
     success: boolean;
     themeId: string;
@@ -65,29 +67,16 @@ export type ApplySiteStyleSelectionResponse = Readonly<{
     theme: Theme;
     siteStyleId: SiteStyleId;
     buttonPersonalityId: ButtonPersonalityId;
-    paletteVariantId: CuratedPaletteId;
-    paletteOverrides: PaletteOverrides | null;
     activePaletteSelection: PaletteSelection;
     /** Present only when the active selection is a site palette. */
     activeSitePaletteVersion: number | null;
     headerLayoutId: HeaderLayoutId;
     headerStyleId: HeaderStyleId;
-    typographyPresetId: TypographyPresetId | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId;
 }>;
 export type ListSiteThemePalettesResponse = Readonly<{
-    active: Readonly<{
-        kind: 'migrated';
-        selection: PaletteSelection;
-    }> | Readonly<{
-        kind: 'legacy-unmigrated';
-    }> | Readonly<{
-        kind: 'invalid';
-        reason: string;
-    }>;
+    active: PaletteLibraryAuthority;
     palettes: readonly import('../../theme-core/src/palette/index').SitePalette[];
 }>;
 export type SaveSiteChromeLookSelectionBody = Readonly<{
@@ -267,13 +256,10 @@ export type SiteRuntimeAPIEndpoints = {
          * local state without a follow-up read.
          */
         buttonPersonalityId: ButtonPersonalityId | null;
-        paletteVariantId: CuratedPaletteId | null;
-        paletteOverrides: PaletteOverrides | null;
+        activePaletteSelection: PaletteSelection;
+        activeSitePaletteVersion: number | null;
         headerLayoutId: HeaderLayoutId | null;
         headerStyleId: HeaderStyleId | null;
-        typographyPresetId: TypographyPresetId | null;
-        typographyBodyFontOverride: string | null;
-        typographyHeadingFontOverride: string | null;
         headerLookId: HeaderLookId | null;
         footerLookId: FooterLookId | null;
     }>;
@@ -835,4 +821,3 @@ export type SiteRuntimeAPIEndpoints = {
         sessionId?: string;
     }, never, void>;
 };
-export {};

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -463,6 +463,12 @@ export declare const proofBlockIslandCodecs: {
                     filterVenueId: string | null;
                     buttonVariant: import("../system").ButtonVariant;
                     buttonText: string;
+                    boardTitle?: string;
+                    footerNote?: string;
+                    seeAllUrl?: string;
+                    loadMoreText?: string;
+                    elevated: boolean;
+                    banded: boolean;
                     showVenue: boolean;
                     showMap: boolean;
                     showCapacity: boolean;
@@ -513,6 +519,12 @@ export declare const proofBlockIslandCodecs: {
                     filterVenueId: string | null;
                     buttonVariant: import("../system").ButtonVariant;
                     buttonText: string;
+                    boardTitle?: string;
+                    footerNote?: string;
+                    seeAllUrl?: string;
+                    loadMoreText?: string;
+                    elevated: boolean;
+                    banded: boolean;
                     showVenue: boolean;
                     showMap: boolean;
                     showCapacity: boolean;
@@ -543,6 +555,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "newsletter-form";
                     className: string | null;
                     buttonLabel: string;
+                    buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
                     successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
@@ -569,6 +582,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "newsletter-form";
                     className: string | null;
                     buttonLabel: string;
+                    buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
                     successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
@@ -902,7 +916,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "passes-memberships";
                     state: "empty" | "ready";
                     className: string | null;
-                    layout: "grid" | "list";
+                    layout: "grid" | "list" | "register";
                     columns: string;
                     emptyMessage: string;
                     passesHeading: string;
@@ -930,6 +944,7 @@ export declare const proofBlockIslandCodecs: {
                     passes: readonly import("..").PublicPassProduct[];
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
+                    buttonVariant: "primary" | "secondary" | "outline" | "link";
                 }>;
             }>>;
         }>) => unknown;
@@ -946,7 +961,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "passes-memberships";
                     state: "empty" | "ready";
                     className: string | null;
-                    layout: "grid" | "list";
+                    layout: "grid" | "list" | "register";
                     columns: string;
                     emptyMessage: string;
                     passesHeading: string;
@@ -974,6 +989,7 @@ export declare const proofBlockIslandCodecs: {
                     passes: readonly import("..").PublicPassProduct[];
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
+                    buttonVariant: "primary" | "secondary" | "outline" | "link";
                 }>;
             }>>;
         }>>;
@@ -1533,6 +1549,12 @@ export declare const runtimeIslandCodecs: {
                     filterVenueId: string | null;
                     buttonVariant: import("../system").ButtonVariant;
                     buttonText: string;
+                    boardTitle?: string;
+                    footerNote?: string;
+                    seeAllUrl?: string;
+                    loadMoreText?: string;
+                    elevated: boolean;
+                    banded: boolean;
                     showVenue: boolean;
                     showMap: boolean;
                     showCapacity: boolean;
@@ -1583,6 +1605,12 @@ export declare const runtimeIslandCodecs: {
                     filterVenueId: string | null;
                     buttonVariant: import("../system").ButtonVariant;
                     buttonText: string;
+                    boardTitle?: string;
+                    footerNote?: string;
+                    seeAllUrl?: string;
+                    loadMoreText?: string;
+                    elevated: boolean;
+                    banded: boolean;
                     showVenue: boolean;
                     showMap: boolean;
                     showCapacity: boolean;
@@ -1613,6 +1641,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "newsletter-form";
                     className: string | null;
                     buttonLabel: string;
+                    buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
                     successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
@@ -1639,6 +1668,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "newsletter-form";
                     className: string | null;
                     buttonLabel: string;
+                    buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
                     successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
@@ -1972,7 +2002,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "passes-memberships";
                     state: "empty" | "ready";
                     className: string | null;
-                    layout: "grid" | "list";
+                    layout: "grid" | "list" | "register";
                     columns: string;
                     emptyMessage: string;
                     passesHeading: string;
@@ -2000,6 +2030,7 @@ export declare const runtimeIslandCodecs: {
                     passes: readonly import("..").PublicPassProduct[];
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
+                    buttonVariant: "primary" | "secondary" | "outline" | "link";
                 }>;
             }>>;
         }>) => unknown;
@@ -2016,7 +2047,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "passes-memberships";
                     state: "empty" | "ready";
                     className: string | null;
-                    layout: "grid" | "list";
+                    layout: "grid" | "list" | "register";
                     columns: string;
                     emptyMessage: string;
                     passesHeading: string;
@@ -2044,6 +2075,7 @@ export declare const runtimeIslandCodecs: {
                     passes: readonly import("..").PublicPassProduct[];
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
+                    buttonVariant: "primary" | "secondary" | "outline" | "link";
                 }>;
             }>>;
         }>>;

package/dist/_dts/blocks/src/definitions.d.ts

@@ -4,7 +4,7 @@
  * It is safe to use in Server Components and data fetching utilities.
  */
 export { getBlockDefinition, getBlockRenderKind, listBlockDefinitions, hasBlockDefinition, registerBlockDefinition, type SystemBlockDefinition, type BlockDataLoader, type BlockDescriptor, } from './system/registry';
-export { blockDesignCapabilityMapFromDefinitions, blockDesignMetadataMapFromDefinitions, declareBlockDesignCapability, declareNoBlockDesignCapability, } from './system/designCapabilities';
+export { blockDesignCapabilityMapFromDefinitions, blockDesignMetadataMapFromDefinitions, declareBlockDesignCapability, declareNoBlockDesignCapability, resolveDeclaredBlockDesignCapability, } from './system/designCapabilities';
 export type { BlockDesignCapabilityDeclaration, NoBlockDesignCapabilityReason, } from './system/designCapabilities';
 export type { AnyBlockRuntimeDefinition, BlockRenderKind, BlockRuntimeDefinition, RuntimeContractsFor, RuntimeDisplay, RuntimeHydration, RuntimeKind, RuntimeRender, RuntimeSource, } from './contracts';
 export { ensureSystemBlockDefinitionsRegistered, systemBlockDefinitions, } from './system/blocks';

package/dist/_dts/blocks/src/portal/types.d.ts

@@ -296,20 +296,38 @@ export type CustomerOrderInstalmentStatus = OrderInstalmentStatus;
 export type CustomerOrderInstalmentRow = OrderInstalmentSummaryRow;
 export type CustomerOrderInstalmentPlan = OrderInstalmentSummary;
 export type CustomerOrderPaymentState = {
-    kind: 'outstanding';
-    balanceDueCents: number;
+    kind: 'not_required';
+    reason: 'free' | 'waived' | 'pass' | 'membership';
+    collectedCents: number;
+    refundedCents: number;
+    outstandingCents: number;
 } | {
-    kind: 'paid';
-    settledVia: 'stripe' | 'store_credit' | 'mixed' | 'pass_redemption' | 'membership_access' | 'free' | 'manual';
+    kind: 'unpaid' | 'partially_paid' | 'collection_failed';
+    collectedCents: number;
+    refundedCents: number;
+    outstandingCents: number;
 } | {
     kind: 'waived';
+    collectedCents: number;
+    waivedCents: number;
+    refundedCents: number;
+    outstandingCents: 0;
 } | {
-    kind: 'refunded';
+    kind: 'paid';
+    collectedCents: number;
+    refundedCents: number;
+    outstandingCents: 0;
+    settledVia: 'stripe' | 'store_credit' | 'mixed' | 'pass_redemption' | 'membership_access' | 'free' | 'manual';
 } | {
-    kind: 'failed';
-    balanceDueCents: number;
+    kind: 'refunded';
+    collectedCents: number;
+    refundedCents: number;
+    outstandingCents: number;
 } | {
     kind: 'cancelled';
+    collectedCents: number;
+    refundedCents: number;
+    outstandingCents: number;
 };
 export interface CustomerOrderActions {
     canPayOnline: boolean;

package/dist/_dts/blocks/src/system/blocks/course-registration.d.ts

@@ -28,7 +28,7 @@ export declare const courseRegistrationManifest: import("..").DefinedBlockManife
         readonly description: "Main heading for the registration form";
         readonly required: false;
         readonly multiline: false;
-        readonly defaultValue: "Enroll in this course";
+        readonly defaultValue: "Sign up";
     }, {
         readonly id: "description";
         readonly type: "richText";
@@ -109,7 +109,7 @@ export declare const courseRegistrationManifest: import("..").DefinedBlockManife
         readonly description: "Text for the enrollment submit button";
         readonly required: false;
         readonly multiline: false;
-        readonly defaultValue: "Complete Enrollment";
+        readonly defaultValue: "Sign up";
         readonly maxLength: 40;
     }, {
         readonly id: "buttonVariant";

package/dist/_dts/blocks/src/system/blocks/courses/shared/schemas.d.ts

@@ -141,6 +141,7 @@ export declare const coursePricingSchema: z.ZodObject<{
  */
 export declare const publicCourseSchema: z.ZodObject<{
     id: z.ZodString;
+    seriesId: z.ZodString;
     title: z.ZodString;
     slug: z.ZodString;
     description: z.ZodNullable<z.ZodUnknown>;
@@ -341,6 +342,7 @@ export declare const publicCourseSchema: z.ZodObject<{
  */
 export declare const publicCoursesArraySchema: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
+    seriesId: z.ZodString;
     title: z.ZodString;
     slug: z.ZodString;
     description: z.ZodNullable<z.ZodUnknown>;

package/dist/_dts/blocks/src/system/blocks/courses/shared/types.d.ts

@@ -55,6 +55,8 @@ export type CoursePricing = {
  */
 export type PublicCourse = {
     id: string;
+    /** Event-series identity backing this concrete course run. */
+    seriesId: string;
     title: string;
     slug: string;
     /** Rich text description (ProseMirror/TipTap JSON format) */

package/dist/_dts/blocks/src/system/blocks/events/event-calendar.d.ts

@@ -80,6 +80,10 @@ export type EventCalendarContent = {
     buttonText?: string | null;
     showCapacity?: boolean | null;
     emptyMessage?: string | null;
+    boardTitle?: string | null;
+    footerNote?: string | null;
+    elevated?: boolean | null;
+    banded?: boolean | null;
     _sectionStyles?: SectionStylesContent;
     _containerStyles?: ContainerStylesContent;
 };