@riverbankcms/sdk 0.104.3 → 0.108.0

package/dist/_dts/content-editor/src/ui/editorUiStore.d.ts

@@ -1,3 +1,4 @@
+import type { FooterModuleId } from '../../../core/src/index';
 import { type EditorUnpublishedState } from '../controller/deriveEditorUnpublishedState';
 import { type AutosaveState } from './stores/autosaveStore';
 import { type GeneratedIconAssetsState } from './stores/generatedIconAssetsStore';
@@ -33,6 +34,7 @@ export type ActivePreviewField = (Readonly<{
  */
 export type AutosaveAcknowledgement = Readonly<{
     acknowledgedVersion: number;
+    optimisticHash?: string | null;
 }>;
 /**
  * Form-facing metadata facade. Consumers pass plain records for ergonomics;
@@ -65,6 +67,13 @@ export type PreviewInspection = Readonly<{
     kind: 'linked-entry';
     entryId: LinkedContentEntryId;
     requestId: number;
+}> | Readonly<{
+    kind: 'footer-module';
+    moduleId: FooterModuleId;
+    requestId: number;
+}> | Readonly<{
+    kind: 'footer';
+    requestId: number;
 }>;
 export type LinkedEntryState = {
     getSelectedEntryId: () => LinkedContentEntryId | null;
@@ -184,6 +193,8 @@ export type EditorUiState = {
     setPreviewSidebarTab: (tab: PreviewSidebarTab) => void;
     inspectBlock: (blockId: EditorBlockId) => void;
     inspectLinkedEntry: (entryId: string) => void;
+    inspectFooterModule: (moduleId: FooterModuleId) => void;
+    inspectFooter: () => void;
     clearPreviewInspection: () => void;
     setActivePreviewField: (field: ActivePreviewField) => void;
     requestFocus: (payload: Omit<NonNullable<FocusRequest>, 'requestId'>) => void;

package/dist/_dts/content-model/src/content-types/schema.d.ts

@@ -8,11 +8,11 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
+        url: "url";
         text: "text";
         textarea: "textarea";
         select: "select";
         link: "link";
-        url: "url";
         file: "file";
         media: "media";
         reference: "reference";

package/dist/_dts/content-model/src/definitions/shared.d.ts

@@ -38,6 +38,9 @@ type SnapshotDefaults = {
     slug?: string | null;
 };
 export declare function createSnapshotFromContentEntry<TStatus extends string = string>(data: ContentEntryLike, routing: RoutingHelpers, defaults: SnapshotDefaults, titleField?: string | null): ContentEntrySnapshot<TStatus>;
+export declare function createSnapshotFromRoutableContent<TStatus extends string = string>(owner: Readonly<{
+    id: string;
+}>, route: NonNullable<ContentEntryLike["route"]>, routing: RoutingHelpers, defaults: SnapshotDefaults): RoutableContentSnapshot<TStatus>;
 type PageRecordLike = {
     id: string;
     draftTitle?: string | null;

package/dist/_dts/core/src/branded.d.ts

@@ -54,6 +54,13 @@ export type SafeDownloadFilename = Brand<string, 'SafeDownloadFilename'>;
 export type PositiveByteCount = Brand<number, 'PositiveByteCount'>;
 export type PositiveSeconds = Brand<number, 'PositiveSeconds'>;
 export type BookingSessionId = Brand<string, 'BookingSessionId'>;
+export type DatedOfferingCapacityHoldId = Brand<string, 'DatedOfferingCapacityHoldId'>;
+export type DatedOfferingCapacityHoldAuditRef = Brand<string, 'DatedOfferingCapacityHoldAuditRef'>;
+export type DatedOfferingRevocationAuditEventId = Brand<string, 'DatedOfferingRevocationAuditEventId'>;
+export type DatedOfferingNonCashProjectionClaimToken = Brand<string, 'DatedOfferingNonCashProjectionClaimToken'>;
+export type DatedOfferingWaitlistCapacityEffectId = Brand<string, 'DatedOfferingWaitlistCapacityEffectId'>;
+export type DatedOfferingWaitlistCapacityEffectClaimToken = Brand<string, 'DatedOfferingWaitlistCapacityEffectClaimToken'>;
+export type DatedOfferingRunCancellationOperationId = Brand<string, 'DatedOfferingRunCancellationOperationId'>;
 export type EntitlementId = Brand<string, 'EntitlementId'>;
 export type SiteFontId = Brand<string, 'SiteFontId'>;
 export type UserId = Brand<string, 'UserId'>;
@@ -66,6 +73,12 @@ export type CourseProgramId = Brand<string, 'CourseProgramId'>;
 export type CustomerId = Brand<string, 'CustomerId'>;
 export type OrderId = Brand<string, 'OrderId'>;
 export type OrderItemId = Brand<string, 'OrderItemId'>;
+export type OrderRefundId = Brand<string, 'OrderRefundId'>;
+export type OrderPaymentReceiptId = Brand<string, 'OrderPaymentReceiptId'>;
+export type OrderFlexibleBalanceContractId = Brand<string, 'OrderFlexibleBalanceContractId'>;
+export type OrderPaymentPlanId = Brand<string, 'OrderPaymentPlanId'>;
+export type OrderPaymentPlanInstalmentId = Brand<string, 'OrderPaymentPlanInstalmentId'>;
+export type ManualPaymentOperationId = Brand<string, 'ManualPaymentOperationId'>;
 export type CheckoutLineId = Brand<string, 'CheckoutLineId'>;
 export type AttendeeId = Brand<string, 'AttendeeId'>;
 export type CustomerPassId = Brand<string, 'CustomerPassId'>;
@@ -83,6 +96,7 @@ export type BookingCalendarFeedTokenPublicId = Brand<string, 'BookingCalendarFee
 export type BookingCalendarFeedTokenSecret = Brand<string, 'BookingCalendarFeedTokenSecret'>;
 export type BookingCalendarFeedTokenSecretHash = Brand<string, 'BookingCalendarFeedTokenSecretHash'>;
 export type ContentEntryId = Brand<string, 'ContentEntryId'>;
+export type ContentBlockId = Brand<string, 'ContentBlockId'>;
 export type ContentVersionId = Brand<string, 'ContentVersionId'>;
 export type EntryContentHash = Brand<string, 'EntryContentHash'>;
 export type StripeInvoiceId = Brand<string, 'StripeInvoiceId'>;
@@ -175,6 +189,13 @@ export declare const unsafeAsSafeDownloadFilename: (value: string) => SafeDownlo
 export declare const unsafeAsPositiveByteCount: (value: number) => PositiveByteCount;
 export declare const unsafeAsPositiveSeconds: (value: number) => PositiveSeconds;
 export declare const unsafeAsBookingSessionId: (id: string) => BookingSessionId;
+export declare const unsafeAsDatedOfferingCapacityHoldId: (value: string) => DatedOfferingCapacityHoldId;
+export declare const unsafeAsDatedOfferingCapacityHoldAuditRef: (value: string) => DatedOfferingCapacityHoldAuditRef;
+export declare const unsafeAsDatedOfferingRevocationAuditEventId: (value: string) => DatedOfferingRevocationAuditEventId;
+export declare const unsafeAsDatedOfferingNonCashProjectionClaimToken: (value: string) => DatedOfferingNonCashProjectionClaimToken;
+export declare const unsafeAsDatedOfferingWaitlistCapacityEffectId: (value: string) => DatedOfferingWaitlistCapacityEffectId;
+export declare const unsafeAsDatedOfferingWaitlistCapacityEffectClaimToken: (value: string) => DatedOfferingWaitlistCapacityEffectClaimToken;
+export declare const unsafeAsDatedOfferingRunCancellationOperationId: (value: string) => DatedOfferingRunCancellationOperationId;
 export declare const unsafeAsEntitlementId: (id: string) => EntitlementId;
 export declare const unsafeAsSiteFontId: (id: string) => SiteFontId;
 export declare const unsafeAsUserId: (id: string) => UserId;
@@ -187,6 +208,12 @@ export declare const unsafeAsCourseProgramId: (id: string) => CourseProgramId;
 export declare const unsafeAsCustomerId: (id: string) => CustomerId;
 export declare const unsafeAsOrderId: (id: string) => OrderId;
 export declare const unsafeAsOrderItemId: (id: string) => OrderItemId;
+export declare const unsafeAsOrderRefundId: (id: string) => OrderRefundId;
+export declare const unsafeAsOrderPaymentReceiptId: (id: string) => OrderPaymentReceiptId;
+export declare const unsafeAsOrderFlexibleBalanceContractId: (id: string) => OrderFlexibleBalanceContractId;
+export declare const unsafeAsOrderPaymentPlanId: (id: string) => OrderPaymentPlanId;
+export declare const unsafeAsOrderPaymentPlanInstalmentId: (id: string) => OrderPaymentPlanInstalmentId;
+export declare const unsafeAsManualPaymentOperationId: (id: string) => ManualPaymentOperationId;
 export declare const unsafeAsCheckoutLineId: (id: string) => CheckoutLineId;
 export declare const unsafeAsAttendeeId: (id: string) => AttendeeId;
 export declare const unsafeAsCustomerPassId: (id: string) => CustomerPassId;
@@ -204,6 +231,7 @@ export declare const unsafeAsBookingCalendarFeedTokenPublicId: (id: string) => B
 export declare const unsafeAsBookingCalendarFeedTokenSecret: (value: string) => BookingCalendarFeedTokenSecret;
 export declare const unsafeAsBookingCalendarFeedTokenSecretHash: (value: string) => BookingCalendarFeedTokenSecretHash;
 export declare const unsafeAsContentEntryId: (id: string) => ContentEntryId;
+export declare const unsafeAsContentBlockId: (id: string) => ContentBlockId;
 export declare const unsafeAsContentVersionId: (id: string) => ContentVersionId;
 export declare const unsafeAsEntryContentHash: (value: string) => EntryContentHash;
 export declare const unsafeAsStripeInvoiceId: (id: string) => StripeInvoiceId;
@@ -254,6 +282,7 @@ export declare const parseProductVariantId: (value: unknown) => Result<ProductVa
 export declare const parseProductCategoryId: (value: unknown) => Result<ProductCategoryId, BrandedIdParseError>;
 export declare const parseMediaAssetId: (value: unknown) => Result<MediaAssetId, BrandedIdParseError>;
 export declare const parseContentEntryId: (value: unknown) => Result<ContentEntryId, BrandedIdParseError>;
+export declare const parseContentBlockId: (value: unknown) => Result<ContentBlockId, BrandedIdParseError>;
 export declare const parseContentVersionId: (value: unknown) => Result<ContentVersionId, BrandedIdParseError>;
 export declare const parseNavigationMenuId: (value: unknown) => Result<NavigationMenuId, BrandedIdParseError>;
 export declare const parseNavigationItemId: (value: unknown) => Result<NavigationItemId, BrandedIdParseError>;
@@ -267,8 +296,26 @@ export declare const parseAppointmentResourceId: (value: unknown) => Result<Appo
 export declare const parseAppointmentReservationId: (value: unknown) => Result<AppointmentReservationId, BrandedIdParseError>;
 export declare const parseAppointmentReservationRunId: (value: unknown) => Result<AppointmentReservationRunId, BrandedIdParseError>;
 export declare const parseAttendeeId: (value: unknown) => Result<AttendeeId, BrandedIdParseError>;
+export declare const parseDatedOfferingCapacityHoldId: (value: unknown) => Result<DatedOfferingCapacityHoldId, BrandedIdParseError>;
+export declare const parseDatedOfferingCapacityHoldAuditRef: (value: unknown) => Result<DatedOfferingCapacityHoldAuditRef, BrandedIdParseError>;
+export declare const parseDatedOfferingRevocationAuditEventId: (value: unknown) => Result<DatedOfferingRevocationAuditEventId, BrandedIdParseError>;
+export declare const parseDatedOfferingNonCashProjectionClaimToken: (value: unknown) => Result<DatedOfferingNonCashProjectionClaimToken, BrandedIdParseError>;
+export declare const parseDatedOfferingWaitlistCapacityEffectId: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectId, BrandedIdParseError>;
+export declare const parseDatedOfferingWaitlistCapacityEffectClaimToken: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectClaimToken, BrandedIdParseError>;
+export declare const parseDatedOfferingRunCancellationOperationId: (value: unknown) => Result<DatedOfferingRunCancellationOperationId, BrandedIdParseError>;
 export declare const parseCustomerId: (value: unknown) => Result<CustomerId, BrandedIdParseError>;
 export declare const parseCustomerPassId: (value: unknown) => Result<CustomerPassId, BrandedIdParseError>;
 export declare const parseCustomerMembershipId: (value: unknown) => Result<CustomerMembershipId, BrandedIdParseError>;
 export declare const parseEventSeriesId: (value: unknown) => Result<EventSeriesId, BrandedIdParseError>;
+export declare const parseEnrollmentId: (value: unknown) => Result<EnrollmentId, BrandedIdParseError>;
+export declare const parseParticipantId: (value: unknown) => Result<ParticipantId, BrandedIdParseError>;
+export declare const parseParticipantParticipationId: (value: unknown) => Result<ParticipantParticipationId, BrandedIdParseError>;
+export declare const parseOrderItemId: (value: unknown) => Result<OrderItemId, BrandedIdParseError>;
+export declare const parseOrderId: (value: unknown) => Result<OrderId, BrandedIdParseError>;
+export declare const parseOrderRefundId: (value: unknown) => Result<OrderRefundId, BrandedIdParseError>;
+export declare const parseOrderPaymentReceiptId: (value: unknown) => Result<OrderPaymentReceiptId, BrandedIdParseError>;
+export declare const parseOrderFlexibleBalanceContractId: (value: unknown) => Result<OrderFlexibleBalanceContractId, BrandedIdParseError>;
+export declare const parseOrderPaymentPlanId: (value: unknown) => Result<OrderPaymentPlanId, BrandedIdParseError>;
+export declare const parseOrderPaymentPlanInstalmentId: (value: unknown) => Result<OrderPaymentPlanInstalmentId, BrandedIdParseError>;
+export declare const parseManualPaymentOperationId: (value: unknown) => Result<ManualPaymentOperationId, BrandedIdParseError>;
 export {};

package/dist/_dts/core/src/dated-offering-settlement.d.ts

@@ -0,0 +1,47 @@
+import type { UtcIsoDateTimeString } from './booking-date-time';
+import type { Brand, StripeCheckoutSessionId } from './branded';
+import { type Result } from './result';
+export type StripePaymentIntentRef = Brand<string, 'StripePaymentIntentRef'>;
+export type StripeWebhookEventRef = Brand<string, 'StripeWebhookEventRef'>;
+export type StripeBalanceTransactionRef = Brand<string, 'StripeBalanceTransactionRef'>;
+export type StripeChargeRef = Brand<string, 'StripeChargeRef'>;
+export type StripeAccountRef = Brand<string, 'StripeAccountRef'>;
+export type StripeSettlementReferenceParseError = Readonly<{
+    kind: 'not_string';
+}> | Readonly<{
+    kind: 'empty_string';
+}>;
+export declare const parseStripePaymentIntentRef: (value: unknown) => Result<StripePaymentIntentRef, StripeSettlementReferenceParseError>;
+export declare const parseStripeWebhookEventRef: (value: unknown) => Result<StripeWebhookEventRef, StripeSettlementReferenceParseError>;
+export declare const parseStripeBalanceTransactionRef: (value: unknown) => Result<StripeBalanceTransactionRef, StripeSettlementReferenceParseError>;
+export declare const parseStripeChargeRef: (value: unknown) => Result<StripeChargeRef, StripeSettlementReferenceParseError>;
+export declare const parseStripeAccountRef: (value: unknown) => Result<StripeAccountRef, StripeSettlementReferenceParseError>;
+export declare const parseStripeCheckoutSessionId: (value: unknown) => Result<StripeCheckoutSessionId, StripeSettlementReferenceParseError>;
+export type DatedOfferingSettlementIdentity = Readonly<{
+    kind: 'stripe_payment_intent';
+    paymentIntentRef: StripePaymentIntentRef;
+}>;
+/**
+ * A webhook says when Riverbank observed Stripe state, not when funds settled.
+ * It must never be used for capacity-hold deadline arbitration.
+ */
+export type DatedOfferingSettlementObservation = Readonly<{
+    kind: 'stripe_webhook_event_observed';
+    identity: DatedOfferingSettlementIdentity;
+    eventRef: StripeWebhookEventRef;
+    observedAtIso: UtcIsoDateTimeString;
+}>;
+/** Authoritative Stripe settlement fact retrieved with its charge evidence. */
+export type DatedOfferingSettlementEvidence = Readonly<{
+    kind: 'stripe_balance_transaction';
+    identity: DatedOfferingSettlementIdentity;
+    evidenceRef: StripeBalanceTransactionRef;
+    chargeRef: StripeChargeRef;
+    settledAtIso: UtcIsoDateTimeString;
+}>;
+export type VerifiedDatedOfferingCheckoutSettlement = Readonly<{
+    kind: 'verified_stripe_checkout_settlement';
+    stripeAccountRef: StripeAccountRef;
+    checkoutSessionId: StripeCheckoutSessionId;
+    evidence: DatedOfferingSettlementEvidence;
+}>;

package/dist/_dts/core/src/editor-state.d.ts

@@ -27,6 +27,7 @@ export type EditorStructuralDraftMeta = Readonly<{
     purpose: string | null;
     orderIndex: number | null;
     publishedContent: EditorBlockValues | null;
+    optimisticHash: string | null;
 }>;
 export type EditorStructuralDraftSnapshot = Readonly<{
     id: EditorBlockId;
@@ -45,12 +46,14 @@ export type EditorDraftBlockInitMetaInput = Readonly<{
     purpose?: string | null;
     orderIndex?: number | null;
     publishedContent?: EditorBlockBaselineInput;
+    optimisticHash?: string | null;
 }>;
 export type EditorDraftBlockBaselineUpdateMetaInput = Readonly<{
     kind?: string;
     purpose?: string | null;
     orderIndex?: number | null;
     publishedContent?: EditorBlockBaselineInput;
+    optimisticHash?: string | null;
 }>;
 export type EditorBlockPublishedBaselineInput = Readonly<{
     id: EditorBlockId;
@@ -66,6 +69,7 @@ export type EditorPersistedBlock = Readonly<{
     publishedContent: EditorBlockValues | null;
     bindings: EditorBlockValues | null;
     purpose: string | null;
+    optimisticHash: string | null;
 }>;
 export type EditorInsertBlockCommand = Readonly<{
     type: 'insert-block';

package/dist/_dts/core/src/event-page-surface-subject.d.ts

@@ -0,0 +1,44 @@
+import { type BrandedIdParseError, type EventOfferingId, type EventSeriesId } from './branded';
+import { type Result } from './result';
+export type EventPageSurfaceSubjectRef = Readonly<{
+    kind: 'eventSeries';
+    eventSeriesId: EventSeriesId;
+}> | Readonly<{
+    kind: 'eventOffering';
+    eventOfferingId: EventOfferingId;
+}>;
+export type EventPageSurfaceSubjectRefWire = Readonly<{
+    kind: 'eventSeries';
+    eventSeriesId: string;
+}> | Readonly<{
+    kind: 'eventOffering';
+    eventOfferingId: string;
+}>;
+export type EventPageSurfaceSubject = Extract<EventPageSurfaceSubjectRef, {
+    kind: 'eventSeries';
+}> | Readonly<{
+    kind: 'eventOffering';
+    eventOfferingId: EventOfferingId;
+    availableEventSeriesIds: readonly EventSeriesId[];
+}>;
+export type EventPageSurfaceSubjectWire = Extract<EventPageSurfaceSubjectRefWire, {
+    kind: 'eventSeries';
+}> | Readonly<{
+    kind: 'eventOffering';
+    eventOfferingId: string;
+    availableEventSeriesIds: readonly string[];
+}>;
+export type EventPageSurfaceSubjectParseError = Readonly<{
+    kind: 'notObject';
+}> | Readonly<{
+    kind: 'unsupportedSubject';
+    subjectKind: unknown;
+}> | Readonly<{
+    kind: 'invalidEventSeriesId';
+    error: BrandedIdParseError;
+}> | Readonly<{
+    kind: 'invalidEventOfferingId';
+    error: BrandedIdParseError;
+}>;
+export declare function parseEventPageSurfaceSubject(value: unknown): Result<EventPageSurfaceSubject, EventPageSurfaceSubjectParseError>;
+export declare function toEventPageSurfaceSubjectWire(subject: EventPageSurfaceSubject): EventPageSurfaceSubjectWire;

package/dist/_dts/core/src/footer-composition.d.ts

@@ -0,0 +1,143 @@
+import type { Brand } from './branded';
+import { type Result } from './result';
+export type FooterModuleId = Brand<string, 'FooterModuleId'>;
+export type FooterMembershipKey = Brand<string, 'FooterMembershipKey'>;
+export type FooterRichText = Readonly<Record<string, unknown>>;
+export type FooterNavigationRole = 'main' | 'legal-policy';
+type FooterSectionBase<TKind extends string> = Readonly<{
+    id: FooterModuleId;
+    kind: TKind;
+    heading: string | null;
+    selected: boolean;
+}>;
+export type FooterSection = (FooterSectionBase<'brand'> & Readonly<{
+    showLogo: boolean;
+    showTitle: boolean;
+}>) | (FooterSectionBase<'navigation'> & Readonly<{
+    source: Readonly<{
+        kind: 'menu-role';
+        role: 'main';
+    }>;
+}>) | (FooterSectionBase<'legal-navigation'> & Readonly<{
+    source: Readonly<{
+        kind: 'menu-role';
+        role: 'legal-policy';
+    }>;
+}>) | (FooterSectionBase<'business-address'> & Readonly<{
+    source: Readonly<{
+        kind: 'business-address';
+    }>;
+}>) | (FooterSectionBase<'contact'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'opening-hours'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'social-links'> & Readonly<{
+    source: Readonly<{
+        kind: 'public-profile';
+    }>;
+}>) | (FooterSectionBase<'supporting-text'> & Readonly<{
+    content: FooterRichText | null;
+}>) | (FooterSectionBase<'legal'> & Readonly<{
+    content: FooterRichText | null;
+}>);
+/** Retained as a source-compatible name while callers move from modules to sections. */
+export type FooterModule = FooterSection;
+export type FooterModuleKind = FooterSection['kind'];
+export type FooterCompositionV1 = Readonly<{
+    schemaVersion: 1;
+    sections: readonly FooterSection[];
+}>;
+export type FooterCompositionError = Readonly<{
+    code: 'invalid_shape' | 'unsupported_schema_version' | 'invalid_section' | 'duplicate_section_id' | 'duplicate_section_kind' | 'unknown_section';
+    path: string;
+    message: string;
+}>;
+export type FooterLookPolicy = Readonly<{
+    kind: 'integrated-legal';
+}> | Readonly<{
+    kind: 'separate-legal-region';
+}>;
+export type FooterVisualGroupKind = 'identity' | 'main-navigation' | 'visit' | 'legal-ending';
+export type FooterColumnCount = 1 | 2 | 3 | 4;
+export type FooterVisualGroup = Readonly<{
+    kind: FooterVisualGroupKind;
+    sections: readonly FooterSection[];
+    span: 1;
+}>;
+export type FooterRenderRegion = Readonly<{
+    kind: 'main' | 'bottom';
+    columns: FooterColumnCount;
+    groups: readonly FooterVisualGroup[];
+}>;
+export type FooterArrangementPlan = Readonly<{
+    membershipKey: FooterMembershipKey;
+    regions: readonly FooterRenderRegion[];
+    mobileGroups: readonly FooterVisualGroup[];
+}>;
+export type FooterRepairTarget = Readonly<{
+    kind: 'site-identity';
+}> | Readonly<{
+    kind: 'navigation';
+    role: FooterNavigationRole;
+}> | Readonly<{
+    kind: 'business-address';
+}> | Readonly<{
+    kind: 'public-profile';
+    section: 'contact' | 'opening-hours' | 'social-links';
+}> | Readonly<{
+    kind: 'footer-section';
+    sectionId: FooterModuleId;
+}>;
+export type ResolvedFooterSection = Readonly<{
+    kind: 'renderable';
+    section: FooterSection;
+}> | Readonly<{
+    kind: 'missing-source';
+    section: FooterSection;
+    repairTarget: FooterRepairTarget;
+}>;
+export type RenderableFooterSection = Extract<ResolvedFooterSection, {
+    kind: 'renderable';
+}>;
+export type FooterSourceAvailability = Readonly<{
+    hasLogo: boolean;
+    hasMainNavigation: boolean;
+    hasLegalPolicyNavigation: boolean;
+    hasBusinessAddress: boolean;
+    hasContact: boolean;
+    hasOpeningHours: boolean;
+    hasSocialLinks: boolean;
+}>;
+export declare function unsafeAsFooterModuleId(value: string): FooterModuleId;
+export declare function parseFooterModuleId(value: unknown): Result<FooterModuleId, FooterCompositionError>;
+export declare function validateFooterComposition(composition: FooterCompositionV1): Result<FooterCompositionV1, FooterCompositionError>;
+export declare function parseFooterCompositionV1(value: unknown): Result<FooterCompositionV1, FooterCompositionError>;
+/**
+ * Bounded pre-production upgrader for the placement-shaped V1 that never reached production.
+ * It is intentionally not called by the runtime parser.
+ */
+export declare function upgradePlacementFooterCompositionV1(value: unknown): Result<FooterCompositionV1, FooterCompositionError>;
+export declare function setFooterSectionSelected(composition: FooterCompositionV1, sectionId: FooterModuleId, selected: boolean): Result<FooterCompositionV1, FooterCompositionError>;
+export declare function resolveFooterSections(composition: FooterCompositionV1, availability: FooterSourceAvailability): readonly ResolvedFooterSection[];
+export declare function planFooterArrangement(renderableSections: readonly RenderableFooterSection[], policy: FooterLookPolicy): FooterArrangementPlan;
+export type FooterEditorOverviewItem = Readonly<{
+    section: FooterSection;
+    status: 'selected' | 'available';
+}>;
+export declare function deriveFooterEditorOverview(composition: FooterCompositionV1): Readonly<{
+    selected: readonly FooterEditorOverviewItem[];
+    available: readonly FooterEditorOverviewItem[];
+}>;
+type LegacyFooterNormalizationOptions = Readonly<{
+    brand?: Readonly<{
+        showLogo: boolean;
+        showTitle: boolean;
+    }>;
+    footerVisible?: boolean;
+}>;
+export declare function normalizeLegacyFooterContentToV1(value: unknown, options?: LegacyFooterNormalizationOptions): Result<FooterCompositionV1, FooterCompositionError>;
+export {};

package/dist/_dts/core/src/index.d.ts

@@ -1,47 +1,51 @@
-export * from "./branded";
-export * from "./date-math";
-export * from "./duration";
-export * from "./demo-capability-policy";
-export * from "./demo-claim-access";
-export * from "./demo-lifecycle-status";
-export * from "./demo-runtime";
-export * from "./collections";
-export * from "./event-pricing";
-export * from "./money-input";
-export * from "./booking-flexible-balance";
-export * from "./booking-refunds";
-export * from "./booking-instalments";
-export * from "./booking-date-time";
-export * from "./person-records";
-export * from "./rectification";
-export * from "./location";
-export * from "./business-address";
-export * from "./result";
-export { assertNever } from "./assert-never";
-export { tryAsync } from "./try-async";
-export * from "./narrow-result";
-export * from "./non-empty-array";
-export * from "./editor-state";
-export * from "./sensitive-collection";
-export * from "./assertNever";
-export * from "./participants";
-export * from "./participant-identity";
-export * from "./public-url-validation";
-export * from "./number-input";
-export * from "./field-errors";
-export * from "./form-submission-preview";
-export * from "./csv-cells";
-export * from "./csv-date-filter";
-export * from "./csv-escape";
-export * from "./csv-filename";
-export * from "./csv-render";
-export * from "./csv-types";
-export * from "./currency-format";
-export * from "./email-format";
-export * from "./slug";
-export * from "./string";
-export * from "./uuid";
-export * from "./stable-json";
-export * from "./site-route-target";
-export { disabledSelection, enabledSelection, plannerNoChange, plannerPatch, plannerUpdate, resolvePlanningDateInput, resolvePlanningNow, resolvePlanningNowDate, systemPlanningClock, } from "./planner";
-export type { DisabledSelection, EnabledSelection, OptionalSelection, PlannerNoChange, PlannerPatch, PlannerUpdate, PlanningClock, PlanningDateInput, PlanningTimeOptions, } from "./planner";
+export * from './branded';
+export * from './date-math';
+export * from './duration';
+export * from './demo-capability-policy';
+export * from './demo-claim-access';
+export * from './demo-lifecycle-status';
+export * from './demo-runtime';
+export * from './collections';
+export * from './event-pricing';
+export * from './event-page-surface-subject';
+export * from './money-input';
+export * from './booking-flexible-balance';
+export * from './booking-refunds';
+export * from './booking-instalments';
+export * from './booking-date-time';
+export * from './dated-offering-settlement';
+export * from './person-records';
+export * from './rectification';
+export * from './location';
+export * from './business-address';
+export * from './result';
+export { assertNever } from './assert-never';
+export { tryAsync } from './try-async';
+export * from './narrow-result';
+export * from './non-empty-array';
+export * from './editor-state';
+export * from './sensitive-collection';
+export * from './assertNever';
+export * from './participants';
+export * from './participant-identity';
+export * from './public-url-validation';
+export * from './public-profile';
+export * from './footer-composition';
+export * from './number-input';
+export * from './field-errors';
+export * from './form-submission-preview';
+export * from './csv-cells';
+export * from './csv-date-filter';
+export * from './csv-escape';
+export * from './csv-filename';
+export * from './csv-render';
+export * from './csv-types';
+export * from './currency-format';
+export * from './email-format';
+export * from './slug';
+export * from './string';
+export * from './uuid';
+export * from './stable-json';
+export * from './site-route-target';
+export { disabledSelection, enabledSelection, plannerNoChange, plannerPatch, plannerUpdate, resolvePlanningDateInput, resolvePlanningNow, resolvePlanningNowDate, systemPlanningClock, } from './planner';
+export type { DisabledSelection, EnabledSelection, OptionalSelection, PlannerNoChange, PlannerPatch, PlannerUpdate, PlanningClock, PlanningDateInput, PlanningTimeOptions, } from './planner';

package/dist/_dts/core/src/public-profile.d.ts

@@ -0,0 +1,73 @@
+import type { Brand } from './branded';
+import { type Result } from './result';
+export type PublicProfileTimeZone = Brand<string, 'PublicProfileTimeZone'>;
+export type OpeningHoursTime = Brand<string, 'OpeningHoursTime'>;
+export type PublicSocialLinkId = Brand<string, 'PublicSocialLinkId'>;
+export declare const publicProfileWeekdays: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
+export type PublicProfileWeekday = (typeof publicProfileWeekdays)[number];
+export declare const knownSocialPlatforms: readonly ["facebook", "instagram", "linkedin", "tiktok", "x", "youtube"];
+export type KnownSocialPlatform = (typeof knownSocialPlatforms)[number];
+export type PublicContactDetails = Readonly<{
+    kind: 'phone';
+    phone: string;
+    email: null;
+}> | Readonly<{
+    kind: 'email';
+    phone: null;
+    email: string;
+}> | Readonly<{
+    kind: 'phone-and-email';
+    phone: string;
+    email: string;
+}>;
+export type OpeningHoursInterval = Readonly<{
+    opensAt: OpeningHoursTime;
+    closesAt: OpeningHoursTime;
+}>;
+export type OpeningHoursDay = Readonly<{
+    kind: 'closed';
+    weekday: PublicProfileWeekday;
+}> | Readonly<{
+    kind: 'open';
+    weekday: PublicProfileWeekday;
+    intervals: readonly [OpeningHoursInterval, ...OpeningHoursInterval[]];
+}>;
+export type WeeklyOpeningHours = Readonly<{
+    timeZone: PublicProfileTimeZone;
+    days: readonly [
+        OpeningHoursDay,
+        OpeningHoursDay,
+        OpeningHoursDay,
+        OpeningHoursDay,
+        OpeningHoursDay,
+        OpeningHoursDay,
+        OpeningHoursDay
+    ];
+}>;
+export type PublicSocialLink = Readonly<{
+    id: PublicSocialLinkId;
+    kind: 'known';
+    platform: KnownSocialPlatform;
+    url: string;
+}> | Readonly<{
+    id: PublicSocialLinkId;
+    kind: 'custom';
+    label: string;
+    url: string;
+}>;
+export type PublicProfile = Readonly<{
+    contact: PublicContactDetails | null;
+    openingHours: WeeklyOpeningHours | null;
+    socialLinks: readonly PublicSocialLink[];
+}>;
+export type PublicProfileParseError = Readonly<{
+    code: 'invalid_shape' | 'contact_method_required' | 'invalid_email' | 'invalid_phone' | 'invalid_timezone' | 'invalid_weekdays' | 'invalid_time' | 'invalid_interval' | 'overlapping_intervals' | 'invalid_social_link' | 'duplicate_social_link_id';
+    path: string;
+    message: string;
+}>;
+export declare function parsePublicContactDetails(value: unknown): Result<PublicContactDetails, PublicProfileParseError>;
+export declare function parsePublicProfileTimeZone(value: unknown): Result<PublicProfileTimeZone, PublicProfileParseError>;
+export declare function parseWeeklyOpeningHours(value: unknown): Result<WeeklyOpeningHours, PublicProfileParseError>;
+export declare function parsePublicSocialLinks(value: unknown): Result<readonly PublicSocialLink[], PublicProfileParseError>;
+export declare function parsePublicProfile(value: unknown): Result<PublicProfile, PublicProfileParseError>;
+export declare function emptyPublicProfile(): PublicProfile;