@riverbankcms/sdk 0.147.0 → 0.148.0

package/dist/_dts/billing/src/plans/entitlements.d.ts

@@ -0,0 +1,80 @@
+import { type BillingPlanId, type BrandingTier, type FormsTier, type NewsletterTier, type PlanBooleanFeatureKey, type PlanEntitlements, type SeoTier, type StorageBytes, type StorageQuota, type TeamTier, type WebsiteCollaborationTier, type WebsiteTier } from './types';
+type MinimumTier<TTier extends string> = Readonly<{
+    minimum: TTier;
+}>;
+export type PlanEntitlementRequirementSpec = Readonly<{
+    features?: readonly PlanBooleanFeatureKey[];
+    website?: MinimumTier<WebsiteTier>;
+    /** Commission isn't a tier: the only requirement is that there is none. */
+    stripeBookingCommission?: Readonly<{
+        kind: 'none';
+    }>;
+    /** Extra sites aren't a tier either: the plan either prices them or doesn't offer them. */
+    extraSite?: Readonly<{
+        kind: 'supported';
+    }>;
+    forms?: MinimumTier<FormsTier>;
+    seo?: MinimumTier<SeoTier>;
+    newsletter?: MinimumTier<NewsletterTier>;
+    branding?: MinimumTier<BrandingTier>;
+    team?: MinimumTier<TeamTier>;
+    websiteCollaboration?: MinimumTier<WebsiteCollaborationTier>;
+}>;
+export type StorageQuotaCheckResult = Readonly<{
+    tag: 'unlimited';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'within_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'at_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+}> | Readonly<{
+    tag: 'would_exceed_limit';
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+    remainingBytes: StorageBytes;
+    maxBytes: StorageBytes;
+    overByBytes: StorageBytes;
+}>;
+export declare function definePlanEntitlementRequirements<const TRequirements extends PlanEntitlementRequirementSpec>(requirements: TRequirements): TRequirements;
+export declare function isPlanBooleanFeatureEnabled(entitlements: PlanEntitlements, feature: PlanBooleanFeatureKey): boolean;
+export declare function meetsPlanEntitlementRequirements(entitlements: PlanEntitlements, requirements: PlanEntitlementRequirementSpec): boolean;
+/**
+ * The cheapest plan that grants `requirements`, by list price: the plan an
+ * upgrade prompt names. Price order, not registry order, so a plan added
+ * anywhere in the ladder is still found correctly.
+ */
+export declare function cheapestPlanMeetingRequirements(requirements: PlanEntitlementRequirementSpec): BillingPlanId | null;
+/**
+ * What choosing `planId` at launch commits the site to: the entitlements a
+ * launched site depends on (the website, a team, its own domain, no
+ * commission). A current plan satisfies the selection when it grants all of
+ * them, so plans that differ in other ways (storage, analytics) never block a
+ * launch, and a plan outside a single ladder (Team, alongside Solo) needs no
+ * rank.
+ */
+export declare function launchRequirementFor(planId: BillingPlanId): PlanEntitlementRequirementSpec;
+/**
+ * The plan an upgrade prompt names when an account on `currentPlanId` needs
+ * `addition`: the cheapest plan that keeps everything a launched site on the
+ * current plan depends on and adds it. A Team account that needs extra sites
+ * is pointed to Studio, not Solo, because Solo would lose the team. Null when
+ * no plan does.
+ */
+export declare function upgradeTargetAdding(currentPlanId: BillingPlanId, addition: PlanEntitlementRequirementSpec): BillingPlanId | null;
+/** Whether an account on `currentPlanId` can launch a site that selected `selectedPlanId`. */
+export declare function planSatisfiesLaunchSelection(currentPlanId: BillingPlanId | null, selectedPlanId: BillingPlanId): boolean;
+export declare function checkStorageQuota(quota: StorageQuota, input: Readonly<{
+    usedBytes: StorageBytes;
+    incomingBytes: StorageBytes;
+}>): StorageQuotaCheckResult;
+export declare function listBooleanPlanFeatureKeys(): readonly PlanBooleanFeatureKey[];
+export {};

package/dist/_dts/billing/src/plans/registry.d.ts

@@ -1,4 +1,4 @@
-import { type BillingInterval, type BillingPlanId, type PlanDefinition, type DisplayPricing } from './types';
+import { type BillingPlanId, type PlanDefinition } from './types';
 export declare function listPlans(): PlanDefinition[];
 export declare function isBillingPlanId(planId: string): planId is BillingPlanId;
 export declare function ensureBillingPlanId(planId: string): BillingPlanId;
@@ -8,23 +8,23 @@ export declare function getKnownPlan(planId: BillingPlanId): PlanDefinition;
 export declare function ensurePlan(planId: string): PlanDefinition;
 export declare function getPlanEntitlements(planId: string): PlanDefinition['entitlements'];
 export declare function getMacadamiaSiteAllowance(planId: string): PlanDefinition['entitlements']['macadamiaSiteAllowance'];
-/**
- * @deprecated Use database pricing with resolveUserPrice() instead.
- * This function fetches pre-created Stripe Price IDs which is being replaced
- * by inline price_data creation from database prices.
- */
-export declare function getStripePriceId(planId: string, interval: BillingInterval): Promise<string>;
-/**
- * @deprecated Use database pricing with getPlanPrice() and resolveUserPrice() instead.
- * This function fetches prices from Stripe which is being replaced by database pricing.
- */
-export declare function calculatePlanPricing(planId: string): Promise<DisplayPricing>;
-/**
- * @deprecated Use database pricing instead. This function fetches prices from Stripe.
- */
-export declare function listPricing(): Promise<DisplayPricing[]>;
 /**
  * Check if a plan is a paid plan.
  * A plan is paid if it's not the 'free' plan.
  */
 export declare function isPaidPlan(planId: string): boolean;
+/** What a plan costs and charges, derived from the registry. Not a second store. */
+export type PlanCommercials = Readonly<{
+    planId: BillingPlanId;
+    /** The monthly list price, before any per-user override or site costs. */
+    monthlyPricePence: number;
+    /** Macadamia's commission on Stripe-paid bookings; 0 when the plan has none. */
+    commissionPercent: number;
+    /**
+     * The monthly online revenue at which Free's commission equals this plan's
+     * price. Null for Free itself, and for any plan that does not charge less
+     * commission than Free.
+     */
+    breakEvenMonthlyOnlineRevenuePence: number | null;
+}>;
+export declare function planCommercials(planId: BillingPlanId): PlanCommercials;

package/dist/_dts/billing/src/plans/standing.d.ts

@@ -1,6 +1,6 @@
 import type { SubscriptionStandingEvidence, SubscriptionStandingEvidenceError, SubscriptionStandingInput } from '../subscriptions/standingEvidence';
-import { type SubscriptionRead } from '../subscriptions/store';
-type PaidStandingDetails = Pick<SubscriptionStandingEvidence, 'planId' | 'interval' | 'currentPeriodEnd' | 'cancelAtPeriodEnd'>;
+import { type SubscriptionRead, type SubscriptionStatus } from '../subscriptions/store';
+type PaidStandingDetails = Pick<SubscriptionStandingEvidence, 'planId' | 'currentPeriodEnd' | 'cancelAtPeriodEnd'>;
 export type PlanStanding = Readonly<{
     kind: 'paid';
 } & PaidStandingDetails> | Readonly<{
@@ -16,4 +16,11 @@ export type PlanStanding = Readonly<{
 export declare function resolvePlanStanding(input: SubscriptionStandingInput): PlanStanding;
 /** Repository reads have already parsed provider evidence; never validate it again here. */
 export declare function resolveStoredPlanStanding(record: SubscriptionRead): PlanStanding;
+/**
+ * Whether the provider still holds this subscription: it can be recovered,
+ * updated, cancelled or acted on by an arrangement change. This is presence,
+ * not entitlement: an unpaid subscription is present but grants free standing,
+ * so read `resolvePlanStanding` for what a plan allows.
+ */
+export declare function hasProviderSubscriptionPresence(status: SubscriptionStatus): boolean;
 export {};

package/dist/_dts/billing/src/plans/types.d.ts

@@ -1,4 +1,3 @@
-export type BillingInterval = 'monthly' | 'annual';
 declare const storageBytesBrand: unique symbol;
 export type StorageBytes = number & {
     readonly [storageBytesBrand]: 'StorageBytes';
@@ -24,10 +23,11 @@ export declare function storageGigabytes(value: number): StorageBytes;
 export declare function limitedStorageQuota(maxBytes: StorageBytes): StorageQuota;
 export declare function formatStorageBytes(bytes: StorageBytes): string;
 export declare function formatStorageQuota(quota: StorageQuota): string;
-export declare const BILLING_PLAN_IDS: readonly ["free", "core", "solo", "studio"];
+/** The ladder in reading order: the booking-page plans, then the website plans. */
+export declare const BILLING_PLAN_IDS: readonly ["free", "core", "team", "solo", "studio"];
 export type BillingPlanId = (typeof BILLING_PLAN_IDS)[number];
-export declare const PAID_BILLING_PLAN_IDS: readonly ["core", "solo", "studio"];
-export type PaidBillingPlanId = (typeof PAID_BILLING_PLAN_IDS)[number];
+export type PaidBillingPlanId = Exclude<BillingPlanId, 'free'>;
+export declare function isPaidBillingPlanId(planId: BillingPlanId): planId is PaidBillingPlanId;
 export declare const FORMS_TIERS: readonly ["limited", "full"];
 export type FormsTier = (typeof FORMS_TIERS)[number];
 export declare const SEO_TIERS: readonly ["none", "basic", "advanced"];
@@ -73,8 +73,7 @@ export type StripeBookingCommission = Readonly<{
 }>;
 export interface PlanEntitlements {
     planId: BillingPlanId;
-    monthlyPricePence: number | null;
-    availableIntervals: readonly BillingInterval[];
+    monthlyPricePence: number;
     macadamiaSiteAllowance: Readonly<{
         includedLiveSiteCount: number;
         extraSite: Readonly<{
@@ -106,13 +105,9 @@ export interface PlanDefinition {
     name: string;
     description: string;
     defaultCurrency: string;
-    annualDiscountPercent?: number;
-    /** @deprecated Use database pricing instead. Will be removed in Phase 6. */
-    stripePriceLookupKeys?: Partial<Record<BillingInterval, string>>;
     /** @deprecated Stripe products are now auto-created via ensurePlatformProduct(). */
     stripeProductId?: string;
     entitlements: PlanEntitlements;
-    trialDays?: number;
     metadata?: Record<string, string | number | boolean>;
 }
 export interface DisplayPricing {
@@ -122,10 +117,5 @@ export interface DisplayPricing {
         amountPence: number;
         formatted: string;
     };
-    annual: {
-        amountPence: number;
-        formatted: string;
-        discountPercent?: number;
-    };
 }
 export {};

package/dist/_dts/billing/src/site-arrangements.d.ts

@@ -1,4 +1,5 @@
 import { type PositiveCents, type Result } from '../../core/src/index';
+import type { SubscriptionStatus } from './subscriptions/store';
 export declare const SITE_BILLING_ARRANGEMENT_KINDS: readonly ["self_serve", "managed_platform_subscription", "managed_manual"];
 export type SiteBillingArrangementKind = (typeof SITE_BILLING_ARRANGEMENT_KINDS)[number];
 export declare const MANAGED_MANUAL_BILLING_REASONS: readonly ["bank_transfer", "testing_exchange", "complimentary", "other"];
@@ -56,7 +57,7 @@ export type ActiveSiteLinkedPlatformAddOn = Readonly<{
 export type SiteBillingSubscriptionSnapshot = Readonly<{
     id: string;
     origin: BillingSubscriptionOrigin | null;
-    status: string;
+    status: SubscriptionStatus;
 }> | null;
 export type SiteBillingManualReviewReason = 'ambiguous_subscription_origin' | 'active_site_linked_add_on' | 'admin_requested_manual_review' | 'missing_admin_subscription_choice' | 'practitioner_limit_exceeded' | 'live_site_allowance_exceeded' | 'subscription_action_failed' | 'multiple_platform_subscriptions' | 'platform_subscription_recovery_failed' | 'commission_reconciliation_exhausted';
 export declare const SITE_BILLING_MANUAL_REVIEW_REASONS: readonly ["ambiguous_subscription_origin", "active_site_linked_add_on", "admin_requested_manual_review", "missing_admin_subscription_choice", "practitioner_limit_exceeded", "live_site_allowance_exceeded", "subscription_action_failed", "multiple_platform_subscriptions", "platform_subscription_recovery_failed", "commission_reconciliation_exhausted"];
@@ -175,4 +176,3 @@ export declare function planSiteBillingArrangementChange(input: Readonly<{
     activeSiteLinkedAddOns: readonly ActiveSiteLinkedPlatformAddOn[];
     adminSubscriptionAction?: AdminManagedSubscriptionActionChoice | null;
 }>): SiteBillingArrangementChangePlan;
-export declare function isSubscriptionActiveForArrangementPlanning(status: string): boolean;

package/dist/_dts/billing/src/subscriptions/standingEvidence.d.ts

@@ -1,18 +1,16 @@
 import { type Result, type UtcIsoDateTimeString } from '../../../core/src/index';
-import type { BillingInterval, PaidBillingPlanId } from '../plans/types';
+import type { PaidBillingPlanId } from '../plans/types';
 import type { SubscriptionStatus } from './store';
 /** Untrusted stored columns, before defaults, casts or membership projection. */
 export type RawSubscriptionStandingEvidence = Readonly<{
     planId: unknown;
-    interval: unknown;
     status: unknown;
     currentPeriodEnd: unknown;
     cancelAtPeriodEnd: unknown;
 }>;
-export type SubscriptionStandingEvidenceError = 'invalid_plan' | 'invalid_interval' | 'invalid_status' | 'invalid_period_end' | 'invalid_cancellation';
+export type SubscriptionStandingEvidenceError = 'invalid_plan' | 'invalid_status' | 'invalid_period_end' | 'invalid_cancellation';
 export type SubscriptionStandingEvidence = Readonly<{
     planId: PaidBillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionStatus;
     currentPeriodEnd: UtcIsoDateTimeString;
     cancelAtPeriodEnd: boolean;

package/dist/_dts/billing/src/subscriptions/store.d.ts

@@ -1,15 +1,14 @@
+import { type StripeCustomerId, type StripeSubscriptionId } from '../../../core/src/index';
 import type { ProviderSubscriptionRecord } from './evidence';
 import { type RawSubscriptionStandingEvidence, type SubscriptionStandingEvidenceError } from './standingEvidence';
-import type { BillingInterval } from '../plans/types';
 import type { BillingSubscriptionOrigin } from '../site-arrangements';
 export type SubscriptionStatus = 'incomplete_expired' | 'paused' | 'incomplete' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid';
 export interface SubscriptionRecord {
-    id: string;
+    id: StripeSubscriptionId;
     userId: string;
-    customerId: string;
+    customerId: StripeCustomerId;
     planId: string;
     origin: BillingSubscriptionOrigin | null;
-    interval: BillingInterval;
     status: SubscriptionStatus;
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
@@ -18,9 +17,9 @@ export interface SubscriptionRecord {
 }
 export type InvalidSubscriptionRecord = Readonly<{
     kind: 'invalid';
-    id: string;
+    id: StripeSubscriptionId;
     userId: string;
-    customerId: string;
+    customerId: StripeCustomerId;
     reason: SubscriptionStandingEvidenceError;
 }>;
 export type SubscriptionRead = ProviderSubscriptionRecord | InvalidSubscriptionRecord | null;
@@ -31,18 +30,25 @@ export declare class InvalidSubscriptionEvidenceError extends Error {
 }
 /** For mutation boundaries that cannot operate without valid subscription evidence. */
 export declare function requireSubscriptionRecord(value: SubscriptionRead): ProviderSubscriptionRecord | null;
-export declare function readSubscriptionRecord(raw: Omit<SubscriptionRecord, keyof RawSubscriptionStandingEvidence> & RawSubscriptionStandingEvidence): ProviderSubscriptionRecord | InvalidSubscriptionRecord;
+/**
+ * The parse boundary for a stored row: the Stripe ids arrive as the column
+ * strings and leave as branded ids, whether or not the rest is valid.
+ */
+export declare function readSubscriptionRecord(raw: Omit<SubscriptionRecord, keyof RawSubscriptionStandingEvidence | 'id' | 'customerId'> & RawSubscriptionStandingEvidence & Readonly<{
+    id: string;
+    customerId: string;
+}>): ProviderSubscriptionRecord | InvalidSubscriptionRecord;
 export interface SubscriptionRepository {
     upsert(record: SubscriptionRecord): Promise<void>;
     getByUserId(userId: string): Promise<SubscriptionRead>;
-    getBySubscriptionId(subscriptionId: string): Promise<SubscriptionRead>;
-    removeBySubscriptionId(subscriptionId: string): Promise<void>;
+    getBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<SubscriptionRead>;
+    removeBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<void>;
 }
 export declare class InMemorySubscriptionRepository implements SubscriptionRepository {
     private byUser;
     private byId;
     upsert(record: SubscriptionRecord): Promise<void>;
     getByUserId(userId: string): Promise<SubscriptionRead>;
-    getBySubscriptionId(subscriptionId: string): Promise<SubscriptionRead>;
-    removeBySubscriptionId(subscriptionId: string): Promise<void>;
+    getBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<SubscriptionRead>;
+    removeBySubscriptionId(subscriptionId: StripeSubscriptionId): Promise<void>;
 }

package/dist/_dts/block-form/src/backend/store-backend.d.ts

@@ -4,13 +4,11 @@
  * Integrates with EditorUiStore for autosave-enabled form management.
  * Supports blocks (per-block data), metadata, content, and linkedContent (embedded entry data).
  */
-import type { EditorBlockId, EditorSyncState } from '../../../core/src/index';
+import { type EditorBlockId, type EditorValueRecord, type ValueSync } from '../../../core/src/index';
 import { type BlockDraftSaveability } from '../blockDraftSaveability';
 import type { FormBackend, StoreBackendOptions } from './types';
 type StoreSnapshot = {
-    current: Record<string, unknown> | null;
-    baseline: Record<string, unknown> | null;
-    syncState: EditorSyncState;
+    sync: ValueSync<EditorValueRecord | null>;
     version?: number;
 };
 interface BlocksSlice {
@@ -18,7 +16,6 @@ interface BlocksSlice {
     setAtPath: (blockId: EditorBlockId, path: string, value: unknown) => void;
     getCurrentValues: (blockId: EditorBlockId) => Record<string, unknown> | null;
     getBlockSnapshot?: (blockId: EditorBlockId) => StoreSnapshot | null;
-    clearError?: (blockId: EditorBlockId) => void;
     updateBlockBaseline?: (blockId: EditorBlockId, data: Record<string, unknown> | null) => void;
 }
 interface RootSlice {
@@ -27,8 +24,10 @@ interface RootSlice {
     setAtPath: (path: string, value: unknown) => void;
     getCurrentValues: () => Record<string, unknown> | null;
     getSnapshot?: () => StoreSnapshot | null;
-    clearError?: () => void;
-    hydrate?: (baseline: Record<string, unknown> | null, current: Record<string, unknown> | null) => void;
+    /** Applies server values as a refresh; `replace` throws local edits away. */
+    refresh?: (input: Readonly<{
+        values: Record<string, unknown> | null;
+    }>, policy: 'replace') => unknown;
 }
 interface ArrayKeysManager {
     get: (scope: string, path: string) => string[] | undefined;

package/dist/_dts/block-form/src/backend/types.d.ts

@@ -133,6 +133,13 @@ export type StoreBackendOptions<TState = unknown> = {
     store: ZustandLikeStore<TState>;
     blockId?: EditorBlockId;
     validateFn?: (values: Record<string, unknown>) => ZodIssue[];
+    /**
+     * Read-only values beside the scope's own, keyed by top-level field id. A read of a key
+     * the values don't hold falls back to these, so a widget can watch a sibling that isn't
+     * a value (slug auto-generation's `statusFieldId` reads the entry's lifecycle status
+     * this way). They're never written, sent or edited.
+     */
+    context?: Readonly<Record<string, unknown>>;
 };
 /**
  * Type guards for discriminating backend types

package/dist/_dts/block-form/src/widgets/FieldFrame.d.ts

@@ -9,6 +9,8 @@ export type FieldFrameProps = {
     fieldPath?: string;
     label?: ReactNode;
     required?: boolean;
+    /** Marks the label "optional", for forms that mark what can be left blank rather than what can't. */
+    optional?: boolean;
     labelClassName?: string;
     description?: ReactNode;
     descriptionClassName?: string;
@@ -29,4 +31,4 @@ export declare function FieldFrameMessage({ id, error, hint }: FieldFrameMessage
 export declare function FieldLabelText({ label, required, }: {
     label: ReactNode;
     required?: boolean;
-}): import("react").JSX.Element | null;
+}): import("react").JSX.Element;

package/dist/_dts/blocks/src/client/events.d.ts

@@ -4,3 +4,6 @@ export { EventDetailsIslandClient, type EventDetailsIslandClientProps, } from '.
 export { EventCalendarClient, type EventCalendarClientProps, } from '../system/runtime/nodes/events/EventCalendar.client';
 export { EventCombinedIslandClient, type EventCombinedClientProps, type EventCombinedIslandClientProps, } from '../system/runtime/nodes/events/EventCombined.client';
 export { EventListingClient, type EventListingClientProps, } from '../system/runtime/nodes/events/EventListing.client';
+export { EventCardClient, type EventCardClientProps, } from '../system/runtime/nodes/events/shared/EventCard.client';
+export { catalogueEventCardProps, type EventCardDisplayProps, } from '../system/runtime/nodes/events/shared/eventCardPresentations';
+export { defaultEventListingCardProps } from '../system/runtime/nodes/events/EventListing.interactive';

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

@@ -28,6 +28,7 @@ export declare const proofBlockIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -118,6 +119,7 @@ export declare const proofBlockIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -205,7 +207,7 @@ export declare const proofBlockIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>>;
@@ -223,7 +225,7 @@ export declare const proofBlockIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>>;
@@ -779,6 +781,7 @@ export declare const proofBlockIslandCodecs: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>) => unknown;
@@ -803,6 +806,7 @@ export declare const proofBlockIslandCodecs: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>>;
@@ -857,6 +861,7 @@ export declare const proofBlockIslandCodecs: {
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>) => unknown;
@@ -909,6 +914,7 @@ export declare const proofBlockIslandCodecs: {
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>>;
@@ -994,6 +1000,7 @@ export declare const runtimeIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -1084,6 +1091,7 @@ export declare const runtimeIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -1171,7 +1179,7 @@ export declare const runtimeIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>>;
@@ -1189,7 +1197,7 @@ export declare const runtimeIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>>;
@@ -1745,6 +1753,7 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>) => unknown;
@@ -1769,6 +1778,7 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>>;
@@ -1823,6 +1833,7 @@ export declare const runtimeIslandCodecs: {
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>) => unknown;
@@ -1875,6 +1886,7 @@ export declare const runtimeIslandCodecs: {
                     memberships: readonly import("..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>>;
         }>>;

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

@@ -1,3 +1,4 @@
+import type { PublishedBlockPlacementRead } from '../../core/src/index';
 import type { Block, PageOutline } from './structure/schema';
 import type { ManifestContentAdmissionError, RenderableManifestContent } from './system/manifest/validation';
 export type PageBlockRenderAdmissionError = Readonly<{
@@ -6,17 +7,7 @@ export type PageBlockRenderAdmissionError = Readonly<{
 }> | Readonly<{
     kind: 'manifest_unavailable';
 }>;
-export type PublishedBlockPlacement = Readonly<{
-    id: string;
-    content: Record<string, unknown>;
-}>;
-export type PublishedBlockPlacementRead = PublishedBlockPlacement | Readonly<{
-    kind: 'incomplete';
-    id: string | null;
-    content: Record<string, unknown> | null;
-}> | null;
-/** Pair a published version with the content it authorises at the render boundary. */
-export declare function readPublishedBlockPlacement(id: string | null | undefined, content: Record<string, unknown> | null | undefined): PublishedBlockPlacementRead;
+export { readPublishedBlockPlacement, type PublishedBlockPlacement, type PublishedBlockPlacementRead, } from '../../core/src/index';
 export type RenderablePageBlock = Readonly<{
     id: Block['id'];
     kind: Block['kind'];
@@ -54,11 +45,11 @@ export type PresentationBlock = Block & Readonly<{
 export type PresentationPageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: readonly PresentationBlock[];
 }>;
+/** A content-read page for the editor: render blocks plus their server versions. */
 export type EditorRenderablePageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: (Block & Readonly<{
         draftContentId: string | null;
-        publishedContentId: string | null;
-        publishedContent: Record<string, unknown> | null;
+        publishedPlacement: PublishedBlockPlacementRead;
     }>)[];
 }>;
 export type EditorPageOutlineWithPlacement = Omit<PageOutline, 'blocks'> & Readonly<{

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

@@ -48,6 +48,7 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     data?: Record<string, unknown>;
     /** Site UUID (useful for media URL resolution in override components) */
     siteId?: string;
+    demoEmailSuppressed?: boolean;
     /** Dashboard API URL for client-side block runtime calls. */
     apiBaseUrl?: string;
     /** Canonical site timezone for calendar/date behavior. */
@@ -137,6 +138,7 @@ export type SdkConfigForRenderer = {
  */
 export type PageRendererDataContext = {
     siteId?: string;
+    demoEmailSuppressed?: boolean;
     /** Public business name from sites.title. */
     siteName?: string;
     pageId?: string;

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

@@ -124,8 +124,6 @@ export interface CustomerEventSeriesRegistration {
     eventTitle: string;
     /** Path to the Event page (published route) when available */
     eventPath?: string | null;
-    /** Rich text description in ProseMirror/TipTap JSON format, or null if not set */
-    eventDescription: unknown;
     status: 'pending_payment' | 'enrolled' | 'waitlist' | 'cancelled' | 'completed';
     paymentMethod: 'free' | 'membership' | 'stripe' | null;
     paymentStatus: 'not_required' | 'pending' | 'completed' | 'failed' | 'refunded' | null;

package/dist/_dts/blocks/src/system/blocks/contact-newsletter.d.ts

@@ -1,5 +1,5 @@
 import type { SystemBlockDefinition } from "../registry";
-import type { SectionStylesContent } from "../fields/boxStyles";
+import type { ContainerStylesContent, SectionStylesContent } from "../fields/boxStyles";
 import { type RichTextDoc } from "./form";
 import type { MailingListPlacementTargeting } from '../../../../core/src/index';
 export declare const contactNewsletterManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
@@ -142,6 +142,7 @@ export type ContactNewsletterContent = {
     formSlug: string;
     contactSubmitLabel?: string | null;
     contactSuccessMessage?: string | null;
+    _containerStyles?: ContainerStylesContent;
     _sectionStyles?: SectionStylesContent;
 };
 export declare const contactNewsletterBlockDefinition: SystemBlockDefinition<ContactNewsletterContent>;

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

@@ -92,8 +92,10 @@ export declare const eventRegistrationManifest: import("..").DefinedBlockManifes
         readonly description: "Message shown after successful registration";
         readonly required: false;
         readonly multiline: true;
-        readonly defaultValue: "Thank you for registering! Check your email for confirmation details.";
         readonly maxLength: 500;
+        readonly ui: {
+            readonly placeholder: "Thank you for registering! Check your email for confirmation details.";
+        };
     }, {
         readonly id: "buttonText";
         readonly type: "text";