@riverbankcms/sdk 0.153.0 → 0.155.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/README.md +2 -0
  2. package/dist/{EventEmbeddedCheckoutStep-veN-QiAE.mjs → EventEmbeddedCheckoutStep-DALtAjqG.mjs} +1 -1
  3. package/dist/{PreviewEditorSidebar-jI_4DTZY.mjs → PreviewEditorSidebar-CbSbqmz3.mjs} +219 -38
  4. package/dist/{PreviewEditorUI-ORkVZhfu.mjs → PreviewEditorUI-CKKnAw11.mjs} +26 -58
  5. package/dist/{SdkPreviewModeRuntime-DaNqevI1.mjs → SdkPreviewModeRuntime-wLkXrWy9.mjs} +177 -84
  6. package/dist/{SiteChromeCustomizeContext-CgNuBHC0.mjs → SiteChromeCustomizeContext-BQ8vvKb-.mjs} +9824 -5829
  7. package/dist/{ThemedButton-X2UxhW6F.mjs → ThemedButton-Bi0rgijy.mjs} +482 -85
  8. package/dist/_dts/ai/src/contracts/proposals.d.ts +42873 -16847
  9. package/dist/_dts/ai/src/contracts/siteStyleProposalSchemas.d.ts +5432 -1810
  10. package/dist/_dts/api/src/billing.d.ts +2 -0
  11. package/dist/_dts/api/src/billingEndpointDefinitions.d.ts +78 -0
  12. package/dist/_dts/api/src/bookingAdjustments.d.ts +3 -2
  13. package/dist/_dts/api/src/bookingConfig.d.ts +4 -12
  14. package/dist/_dts/api/src/bookingManagementEventEndpointTypes.d.ts +2 -2
  15. package/dist/_dts/api/src/bookingOperations.d.ts +11 -2
  16. package/dist/_dts/api/src/bookingPeople.d.ts +20 -1
  17. package/dist/_dts/api/src/bookingPeopleEndpointDefinitions.d.ts +8 -0
  18. package/dist/_dts/api/src/bookingRecords.d.ts +5 -106
  19. package/dist/_dts/api/src/bookings.d.ts +10 -4
  20. package/dist/_dts/api/src/commercePortalEndpoints.d.ts +1 -1
  21. package/dist/_dts/api/src/common/envelope.d.ts +2 -2
  22. package/dist/_dts/api/src/contentRuntime.d.ts +5 -3
  23. package/dist/_dts/api/src/endpoints.d.ts +89 -44
  24. package/dist/_dts/api/src/eventManagementContracts.d.ts +20 -11
  25. package/dist/_dts/api/src/eventManagementEndpointDefinitions.d.ts +1 -1
  26. package/dist/_dts/api/src/index.d.ts +9 -4
  27. package/dist/_dts/api/src/indexCoreTypes.d.ts +1 -0
  28. package/dist/_dts/api/src/moneyPayments.d.ts +116 -0
  29. package/dist/_dts/api/src/onboarding/surfaceData.d.ts +2 -0
  30. package/dist/_dts/api/src/privacyPolicy.d.ts +20 -2
  31. package/dist/_dts/api/src/public/types.d.ts +1 -0
  32. package/dist/_dts/api/src/publicAppointmentBookingContracts.d.ts +1 -0
  33. package/dist/_dts/api/src/publicBookingService.d.ts +1 -0
  34. package/dist/_dts/api/src/publicExperience/commerceEndpoints.d.ts +4 -0
  35. package/dist/_dts/api/src/sdk-event-management.d.ts +1 -0
  36. package/dist/_dts/api/src/sdk-event-upsert.d.ts +24 -9
  37. package/dist/_dts/api/src/sdkContracts.d.ts +2 -0
  38. package/dist/_dts/api/src/sdkManagedEventContracts.d.ts +5 -3
  39. package/dist/_dts/api/src/sdkPullEventContracts.d.ts +15 -4
  40. package/dist/_dts/api/src/sdkThemeWire.d.ts +172 -103
  41. package/dist/_dts/api/src/siteManagementEndpoints.d.ts +2 -2
  42. package/dist/_dts/api/src/sitePlatformEndpoints.d.ts +18 -0
  43. package/dist/_dts/api/src/siteRuntimeEndpoints.d.ts +17 -16
  44. package/dist/_dts/api/src/siteSettings.d.ts +1 -0
  45. package/dist/_dts/api/src/siteTerms.d.ts +100 -0
  46. package/dist/_dts/api/src/stripeConnectSetup.d.ts +90 -0
  47. package/dist/_dts/api/src/types.d.ts +13 -32
  48. package/dist/_dts/api/src/webhooks.d.ts +9 -9
  49. package/dist/_dts/api/src/wholeSeriesRuns.d.ts +2 -4
  50. package/dist/_dts/block-form/src/client/index.d.ts +2 -1
  51. package/dist/_dts/block-form/src/widgets/DateField/DateField.d.ts +3 -1
  52. package/dist/_dts/block-form/src/widgets/DateField/datePickerPopover.d.ts +3 -1
  53. package/dist/_dts/block-form/src/widgets/DateTimeField/DateTimeField.d.ts +3 -1
  54. package/dist/_dts/blocks/src/client/carousel.d.ts +1 -0
  55. package/dist/_dts/blocks/src/client/site-chrome.d.ts +1 -1
  56. package/dist/_dts/blocks/src/contracts/non-block-islands.d.ts +12 -33
  57. package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts +30 -118
  58. package/dist/_dts/blocks/src/index.d.ts +2 -2
  59. package/dist/_dts/blocks/src/pageRenderAdmission.d.ts +1 -0
  60. package/dist/_dts/blocks/src/pageRenderPlan.d.ts +8 -1
  61. package/dist/_dts/blocks/src/pageRendererContracts.d.ts +1 -0
  62. package/dist/_dts/blocks/src/primitives/content/components/RichText.d.ts +1 -1
  63. package/dist/_dts/blocks/src/primitives/content/primitives.d.ts +4 -1
  64. package/dist/_dts/blocks/src/primitives/layout/Section.d.ts +1 -0
  65. package/dist/_dts/blocks/src/rendering/server.d.ts +1 -0
  66. package/dist/_dts/blocks/src/system/blocks/events/event-calendar.d.ts +1 -1
  67. package/dist/_dts/blocks/src/system/blocks/events/eventSelectionFields.d.ts +1 -1
  68. package/dist/_dts/blocks/src/system/blocks/events/shared/fields.d.ts +0 -4
  69. package/dist/_dts/blocks/src/system/blocks/events/shared/index.d.ts +0 -1
  70. package/dist/_dts/blocks/src/system/blocks/events/shared/schemas.d.ts +13 -9
  71. package/dist/_dts/blocks/src/system/blocks/events/shared/types.d.ts +1 -0
  72. package/dist/_dts/blocks/src/system/blocks/form.d.ts +10 -0
  73. package/dist/_dts/blocks/src/system/blocks/image-gallery/fields.d.ts +1 -0
  74. package/dist/_dts/blocks/src/system/blocks/image-gallery.d.ts +6 -1
  75. package/dist/_dts/blocks/src/system/blocks/location-map.d.ts +1 -1
  76. package/dist/_dts/blocks/src/system/blocks/media-text.d.ts +47 -45
  77. package/dist/_dts/blocks/src/system/blocks/newsletter-signup.d.ts +12 -0
  78. package/dist/_dts/blocks/src/system/blocks/offerings-preview/catalogue.d.ts +7 -1
  79. package/dist/_dts/blocks/src/system/blocks/offerings-preview/index.d.ts +14 -0
  80. package/dist/_dts/blocks/src/system/blocks/offerings-preview/itemData.d.ts +12 -0
  81. package/dist/_dts/blocks/src/system/blocks/offerings-preview/model.d.ts +56 -6
  82. package/dist/_dts/blocks/src/system/blocks/offerings-preview/photoCount.d.ts +3 -12
  83. package/dist/_dts/blocks/src/system/blocks/shared/siteTerms.d.ts +17 -0
  84. package/dist/_dts/blocks/src/system/blocks/site-footer-runtime-layout.d.ts +23 -0
  85. package/dist/_dts/blocks/src/system/blocks/site-footer-runtime-profile.d.ts +20 -0
  86. package/dist/_dts/blocks/src/system/blocks/site-footer-runtime.d.ts +17 -16
  87. package/dist/_dts/blocks/src/system/blocks/site-footer.d.ts +1 -1
  88. package/dist/_dts/blocks/src/system/customize/facets.d.ts +119 -9
  89. package/dist/_dts/blocks/src/system/manifest/fieldValidation/index.d.ts +2 -1
  90. package/dist/_dts/blocks/src/system/manifest/schema.d.ts +24 -24
  91. package/dist/_dts/blocks/src/system/manifest/validation.d.ts +3 -1
  92. package/dist/_dts/blocks/src/system/node/fragments/backgroundLayer.d.ts +6 -0
  93. package/dist/_dts/blocks/src/system/node/fragments/index.d.ts +1 -0
  94. package/dist/_dts/blocks/src/system/node/fragments/lookSlot.d.ts +22 -3
  95. package/dist/_dts/blocks/src/system/node/fragments/responsiveTwoColumn.d.ts +3 -1
  96. package/dist/_dts/blocks/src/system/node/fragments/sectionHead.d.ts +15 -0
  97. package/dist/_dts/blocks/src/system/node/fragments/styledSection.d.ts +4 -0
  98. package/dist/_dts/blocks/src/system/runtime/api/client.d.ts +2 -0
  99. package/dist/_dts/blocks/src/system/runtime/api/endpoints.d.ts +7 -0
  100. package/dist/_dts/blocks/src/system/runtime/api/types/events.d.ts +2 -0
  101. package/dist/_dts/blocks/src/system/runtime/api/types/portal.d.ts +1 -0
  102. package/dist/_dts/blocks/src/system/runtime/api/types/shop.d.ts +3 -0
  103. package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts +51 -198
  104. package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts +21 -99
  105. package/dist/_dts/blocks/src/system/runtime/hooks/useBookingFlowController.d.ts +2 -0
  106. package/dist/_dts/blocks/src/system/runtime/hooks/useBookingSubmission.d.ts +3 -2
  107. package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessBookingFlow.d.ts +4 -0
  108. package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessEventRegistrationFlow.d.ts +2 -0
  109. package/dist/_dts/blocks/src/system/runtime/hooks/useSiteTermsAgreement.d.ts +17 -0
  110. package/dist/_dts/blocks/src/system/runtime/hooks/useSiteTermsAgreement.state.d.ts +42 -0
  111. package/dist/_dts/blocks/src/system/runtime/lookSurfaces.d.ts +22 -4
  112. package/dist/_dts/blocks/src/system/runtime/nodes/appointment-services.d.ts +6 -2
  113. package/dist/_dts/blocks/src/system/runtime/nodes/basic.d.ts +2 -1
  114. package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.headless.state.d.ts +4 -0
  115. package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.interactive.d.ts +15 -0
  116. package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.state.d.ts +1 -0
  117. package/dist/_dts/blocks/src/system/runtime/nodes/booking-runtime-sources.d.ts +3 -0
  118. package/dist/_dts/blocks/src/system/runtime/nodes/carousel.client.d.ts +5 -30
  119. package/dist/_dts/blocks/src/system/runtime/nodes/carousel.server.d.ts +3 -12
  120. package/dist/_dts/blocks/src/system/runtime/nodes/carousel.shared.d.ts +71 -1
  121. package/dist/_dts/blocks/src/system/runtime/nodes/event-details/lookPresentation.d.ts +16 -4
  122. package/dist/_dts/blocks/src/system/runtime/nodes/event-details/presentation.d.ts +1 -1
  123. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/AttendeeDetailsStep.d.ts +3 -0
  124. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/CalendarAction.d.ts +5 -0
  125. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/SuccessStep.d.ts +2 -0
  126. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/bookingCalendar.d.ts +16 -0
  127. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/event-registration.headless.contract.d.ts +2 -0
  128. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/finishedBooking.d.ts +8 -0
  129. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/registrationStateMachine.d.ts +2 -0
  130. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/types.d.ts +3 -1
  131. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/useEventRegistrationWizard.d.ts +42 -0
  132. package/dist/_dts/blocks/src/system/runtime/nodes/event-registration.interactive.d.ts +5 -0
  133. package/dist/_dts/blocks/src/system/runtime/nodes/events/domain/dates.d.ts +1 -1
  134. package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/CardListItem.d.ts +26 -1
  135. package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/EventItem.d.ts +17 -3
  136. package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCardListContent.d.ts +9 -1
  137. package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts +49 -21
  138. package/dist/_dts/blocks/src/system/runtime/nodes/form.fields.d.ts +5 -2
  139. package/dist/_dts/blocks/src/system/runtime/nodes/form.interactive.d.ts +11 -79
  140. package/dist/_dts/blocks/src/system/runtime/nodes/form.parts.d.ts +7 -0
  141. package/dist/_dts/blocks/src/system/runtime/nodes/form.server.d.ts +2 -13
  142. package/dist/_dts/blocks/src/system/runtime/nodes/gifting.interactive.d.ts +8 -0
  143. package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.interactive.d.ts +8 -72
  144. package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.parts.d.ts +6 -6
  145. package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.types.d.ts +3 -2
  146. package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview-catalogue.d.ts +5 -3
  147. package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview-content.d.ts +4 -2
  148. package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview.d.ts +2 -2
  149. package/dist/_dts/blocks/src/system/runtime/nodes/shared/contract-schemas.d.ts +2 -2
  150. package/dist/_dts/blocks/src/system/runtime/nodes/shop.interactive.d.ts +14 -0
  151. package/dist/_dts/blocks/src/system/runtime/shared/components/CheckboxChoice.d.ts +3 -1
  152. package/dist/_dts/blocks/src/system/runtime/shared/components/SiteTermsAgreementField.d.ts +13 -0
  153. package/dist/_dts/blocks/src/system/runtime/shared/siteTermsAgreement.d.ts +81 -0
  154. package/dist/_dts/blocks/src/system/runtime/shared/siteTermsCheckoutApi.d.ts +14 -0
  155. package/dist/_dts/blocks/src/system/transforms/registry/_utils/surfaceForegroundStyles.d.ts +3 -0
  156. package/dist/_dts/blocks/src/system/transforms/registry/boxStyles.d.ts +2 -0
  157. package/dist/_dts/blocks/src/system/transforms/registry/footerArrangement.d.ts +6 -0
  158. package/dist/_dts/blocks/src/system/transforms/registry/layout.d.ts +0 -11
  159. package/dist/_dts/blocks/src/system/transforms/typed.d.ts +3 -10
  160. package/dist/_dts/blocks/src/system/types/link.d.ts +2 -0
  161. package/dist/_dts/calendar/src/icsRenderer.d.ts +23 -0
  162. package/dist/_dts/calendar/src/index.d.ts +2 -0
  163. package/dist/_dts/commerce/src/purchase/checkoutErrorCodes.d.ts +1 -1
  164. package/dist/_dts/commerce/src/purchase/orderConfirmationPlanning.d.ts +1 -0
  165. package/dist/_dts/commerce/src/purchase/types.d.ts +5 -0
  166. package/dist/_dts/content-editor/src/FooterComposerOverview.d.ts +5 -2
  167. package/dist/_dts/content-editor/src/FooterComposerPanel.d.ts +1 -1
  168. package/dist/_dts/content-editor/src/FooterNavigationLayoutControl.d.ts +6 -3
  169. package/dist/_dts/content-editor/src/controller/EntryControllerProvider.d.ts +3 -1
  170. package/dist/_dts/content-editor/src/controller/editorLeaseParticipation.d.ts +1 -1
  171. package/dist/_dts/content-editor/src/controller/publicationDate.d.ts +5 -0
  172. package/dist/_dts/content-editor/src/footerComposer.d.ts +2 -1
  173. package/dist/_dts/content-editor/src/footerComposerPanelTypes.d.ts +3 -1
  174. package/dist/_dts/content-editor/src/footerNavigationLayoutState.d.ts +56 -0
  175. package/dist/_dts/content-editor/src/footerPreviewRuntime.d.ts +2 -1
  176. package/dist/_dts/content-editor/src/useFooterComposerState.d.ts +3 -4
  177. package/dist/_dts/content-editor/src/useFooterNavigationLayout.d.ts +11 -8
  178. package/dist/_dts/content-model/src/content-types/entryValidation.d.ts +6 -5
  179. package/dist/_dts/content-model/src/content-types/schema.d.ts +4 -0
  180. package/dist/_dts/content-model/src/contentManifest.d.ts +10 -2
  181. package/dist/_dts/content-model/src/definitions/shared.d.ts +2 -0
  182. package/dist/_dts/core/src/booking-date-time.d.ts +5 -0
  183. package/dist/_dts/core/src/booking-refunds.d.ts +43 -0
  184. package/dist/_dts/core/src/branded.d.ts +6 -0
  185. package/dist/_dts/core/src/date-display.d.ts +90 -0
  186. package/dist/_dts/core/src/date-time-formatter.d.ts +2 -0
  187. package/dist/_dts/core/src/footer-arrangement.d.ts +8 -1
  188. package/dist/_dts/core/src/footer-composition-types.d.ts +6 -1
  189. package/dist/_dts/core/src/footer-composition.d.ts +1 -1
  190. package/dist/_dts/core/src/footer-navigation-layout.d.ts +3 -0
  191. package/dist/_dts/core/src/index.d.ts +4 -1
  192. package/dist/_dts/core/src/mailing-list-setup.d.ts +3 -0
  193. package/dist/_dts/core/src/mailing-list-submission.d.ts +6 -1
  194. package/dist/_dts/core/src/public-profile.d.ts +3 -1
  195. package/dist/_dts/core/src/scheduled-date-time.d.ts +69 -0
  196. package/dist/_dts/core/src/site-terms.d.ts +94 -0
  197. package/dist/_dts/core/src/whole-series-run-schedule.d.ts +2 -0
  198. package/dist/_dts/db/src/generated/supabase/database.types.d.ts +356 -9
  199. package/dist/_dts/db/src/schemas/forms.d.ts +32 -32
  200. package/dist/_dts/editor/src/chrome/EditorChrome.d.ts +2 -2
  201. package/dist/_dts/editor/src/chrome/EditorStatusBar.d.ts +3 -2
  202. package/dist/_dts/editor/src/chrome/statusBarPresentation.d.ts +2 -2
  203. package/dist/_dts/editor-blocks/src/widgets/link/LinkContentList.d.ts +2 -1
  204. package/dist/_dts/editor-blocks/src/widgets/link/LinkPicker.d.ts +3 -0
  205. package/dist/_dts/editor-blocks/src/widgets/link/LinkPickerDialog.d.ts +1 -1
  206. package/dist/_dts/editor-blocks/src/widgets/link/LinkWidget.d.ts +3 -0
  207. package/dist/_dts/editor-blocks/src/widgets/link/draft.d.ts +6 -1
  208. package/dist/_dts/editor-blocks/src/widgets/link/index.d.ts +1 -0
  209. package/dist/_dts/preview-next/src/client/blocks/ArrangementBlockToolbar.d.ts +2 -1
  210. package/dist/_dts/preview-next/src/client/blocks/arrangementControlsModel.d.ts +8 -1
  211. package/dist/_dts/preview-next/src/client/blocks/previewCustomizeControlPlan.d.ts +4 -1
  212. package/dist/_dts/preview-next/src/client/preview/PreviewEntryControllerProvider.d.ts +3 -1
  213. package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts +3 -0
  214. package/dist/_dts/preview-next/src/client/preview/PreviewShellLayout.d.ts +1 -0
  215. package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts +4 -1
  216. package/dist/_dts/preview-next/src/client/preview/siteChromeSavePlan.d.ts +27 -5
  217. package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts +2 -0
  218. package/dist/_dts/preview-next/src/client/preview/useConfirmedPreferenceRecord.d.ts +12 -0
  219. package/dist/_dts/preview-next/src/client/preview/usePersistedFooterPreferences.d.ts +26 -0
  220. package/dist/_dts/preview-next/src/client/preview/usePersistedHeaderPreferences.d.ts +40 -2
  221. package/dist/_dts/preview-next/src/client/sdk/SdkPreviewMode.d.ts +2 -0
  222. package/dist/_dts/sdk/src/config/typed-entry-links.test-d.d.ts +1 -0
  223. package/dist/_dts/sdk/src/config/validation.d.ts +3 -3
  224. package/dist/_dts/sdk/src/contracts/system-block-content.d.ts +4 -46
  225. package/dist/_dts/sdk/src/date-time/index.d.ts +2 -68
  226. package/dist/_dts/sdk/src/public-api/contracts.d.ts +4 -2
  227. package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts +1 -0
  228. package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts +3 -1
  229. package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts +7 -4
  230. package/dist/_dts/sdk/src/rendering/helpers/pageRuntimeSupport.d.ts +3 -1
  231. package/dist/_dts/sdk/src/rendering/islands/types.d.ts +1 -1
  232. package/dist/_dts/sdk/src/version.d.ts +1 -1
  233. package/dist/_dts/theme-core/src/ThemeFontLoader.d.ts +1 -0
  234. package/dist/_dts/theme-core/src/buttons/buttonColourContract.d.ts +2 -0
  235. package/dist/_dts/theme-core/src/buttons/resolveButtonColourStates.d.ts +2 -0
  236. package/dist/_dts/theme-core/src/buttons/styles/recipes/lanternRecipes.d.ts +60 -0
  237. package/dist/_dts/theme-core/src/buttons/styles/recipes/quietArrow.d.ts +12 -8
  238. package/dist/_dts/theme-core/src/buttons/styles/registry.d.ts +69 -8
  239. package/dist/_dts/theme-core/src/buttons/styles/selection.d.ts +22 -1
  240. package/dist/_dts/theme-core/src/buttons/types.d.ts +358 -46
  241. package/dist/_dts/theme-core/src/buttons/typography.d.ts +24 -0
  242. package/dist/_dts/theme-core/src/cards/types.d.ts +8 -8
  243. package/dist/_dts/theme-core/src/footer/effectiveNavLinkStyle.d.ts +1 -1
  244. package/dist/_dts/theme-core/src/footer/generateFooterCss.d.ts +4 -1
  245. package/dist/_dts/theme-core/src/footer/mode.d.ts +2 -11
  246. package/dist/_dts/theme-core/src/generated/containerResponsiveThemeCss.d.ts +1 -1
  247. package/dist/_dts/theme-core/src/header/containerSchema.d.ts +1 -0
  248. package/dist/_dts/theme-core/src/header/generateHeaderCss.d.ts +3 -0
  249. package/dist/_dts/theme-core/src/inputs/checkable.d.ts +6 -0
  250. package/dist/_dts/theme-core/src/mock-themes/all.d.ts +249 -147
  251. package/dist/_dts/theme-core/src/navigation/types.d.ts +4 -4
  252. package/dist/_dts/theme-core/src/schema.d.ts +321 -192
  253. package/dist/_dts/theme-core/src/site-styles/accessibleSurfaces.d.ts +2 -0
  254. package/dist/_dts/theme-core/src/site-styles/appearancePresetTypes.d.ts +24 -7
  255. package/dist/_dts/theme-core/src/site-styles/backgroundAppearance.d.ts +2 -2
  256. package/dist/_dts/theme-core/src/site-styles/compilationPlan.d.ts +4 -6
  257. package/dist/_dts/theme-core/src/site-styles/compileFooterAgainstRow.d.ts +121 -0
  258. package/dist/_dts/theme-core/src/site-styles/curatedSiteStyles.d.ts +81 -1
  259. package/dist/_dts/theme-core/src/site-styles/footerLookDefaults.d.ts +45 -0
  260. package/dist/_dts/theme-core/src/site-styles/footerLookRecipe.d.ts +50 -0
  261. package/dist/_dts/theme-core/src/site-styles/footerLooks.d.ts +9 -35
  262. package/dist/_dts/theme-core/src/site-styles/footerPreferences.d.ts +29 -0
  263. package/dist/_dts/theme-core/src/site-styles/generatedSchemas.d.ts +4 -2
  264. package/dist/_dts/theme-core/src/site-styles/headerOpeningForeground.d.ts +4 -0
  265. package/dist/_dts/theme-core/src/site-styles/headerPreferencesPersistence.d.ts +2 -3
  266. package/dist/_dts/theme-core/src/site-styles/headerStyleRecipe.d.ts +13 -1
  267. package/dist/_dts/theme-core/src/site-styles/index.d.ts +4 -0
  268. package/dist/_dts/theme-core/src/site-styles/lookResolution.d.ts +2 -2
  269. package/dist/_dts/theme-core/src/site-styles/previewCompiler.d.ts +1 -1
  270. package/dist/_dts/theme-core/src/site-styles/runtimeBackgroundResolution.d.ts +5 -0
  271. package/dist/_dts/theme-core/src/site-styles/siteChromeBackgrounds.d.ts +8 -0
  272. package/dist/_dts/theme-core/src/site-styles/siteStyleTypography.d.ts +46 -0
  273. package/dist/_dts/theme-core/src/site-styles/themeParity.d.ts +1 -1
  274. package/dist/_dts/theme-core/src/site-styles/tokenRecipes.d.ts +1 -1
  275. package/dist/_dts/theme-core/src/status/generateStatusCss.d.ts +4 -1
  276. package/dist/_dts/theme-core/src/surfaces/resolveSurfaceForeground.d.ts +2 -0
  277. package/dist/_dts/theme-core/src/typography/schema.d.ts +9 -0
  278. package/dist/_dts/ui/src/calendar.d.ts +6 -1
  279. package/dist/_dts/ui/src/card.d.ts +1 -1
  280. package/dist/_dts/ui/src/index.d.ts +1 -1
  281. package/dist/client/{BookingMailingListNote-DrchYW1m.mjs → BookingMailingListNote-CiW1dsz7.mjs} +3 -3
  282. package/dist/client/{CardListItem-CC_GVmF6.mjs → CardListItem-DVYTlYpS.mjs} +70 -13
  283. package/dist/client/CheckboxChoice-CUnPrBlC.mjs +44 -0
  284. package/dist/client/DemoBookingPortalAccess-DEsn5F2C.mjs +770 -0
  285. package/dist/client/{EventCombined.client-DyN0v0Xk.mjs → EventCombined.client-BdctbwnV.mjs} +5 -5
  286. package/dist/client/{EventEmbeddedCheckoutStep-CgfpKc3n.mjs → EventEmbeddedCheckoutStep-DAhQs6Jb.mjs} +2 -5
  287. package/dist/client/{EventListing.client-CuOuvYMz.mjs → EventListing.client-BviZXfAE.mjs} +2 -2
  288. package/dist/client/{mailingListSignupCopy-DZSHZrm6.mjs → FieldValidationMessage-AYanWFb-.mjs} +1 -14
  289. package/dist/client/{LeafletStaticMap-B0WhRr3j.mjs → LeafletStaticMap-BLTECfjU.mjs} +1 -1
  290. package/dist/client/{RichText-C1fIXBzA.mjs → RichText-D3oE1_pw.mjs} +77 -44
  291. package/dist/client/ThemedButton-Ckj0Rfr_.mjs +1256 -0
  292. package/dist/client/{accordion-DCDVWSye.mjs → accordion-yBx6d4O2.mjs} +1 -1
  293. package/dist/client/{bookingForm-BJ3C4GlM.mjs → bookingForm-CPDEsQci.mjs} +64 -35
  294. package/dist/client/bookings.mjs +19252 -15228
  295. package/dist/client/carousel-DCqjwd2s.mjs +71 -0
  296. package/dist/client/{carousel.client-GEtOGsxo.mjs → carousel.client-Bx7XMF8-.mjs} +114 -39
  297. package/dist/client/{cart-Yv-aAtck.mjs → cart-DWJXrQxs.mjs} +3 -3
  298. package/dist/client/{checkout-B9xDkl30.mjs → checkout-CH4ypSLS.mjs} +3 -3
  299. package/dist/client/client.mjs +13559 -7353
  300. package/dist/client/{context-BOGe3rIA.mjs → context-BOs0m_iw.mjs} +16 -12
  301. package/dist/client/{eventCalendar-D6M0T9hs.mjs → eventCalendar-CRylMllc.mjs} +8 -319
  302. package/dist/client/{eventCombined-NM4UFBq8.mjs → eventCombined-DohTS3kp.mjs} +4 -4
  303. package/dist/client/{eventDetails-f_FhV4O8.mjs → eventDetails-qf-u9zcF.mjs} +108 -36
  304. package/dist/client/{eventListing-WLkfAROh.mjs → eventListing-Cg__X2vy.mjs} +4 -4
  305. package/dist/client/{eventRegistration-D3ejfLvW.mjs → eventRegistration-CybWxswy.mjs} +215 -237
  306. package/dist/client/{form-D5Or2Jyu.mjs → form-C-SGk6nq.mjs} +115 -51
  307. package/dist/client/{headerSection-hWgnv27V.mjs → headerSection-BdzPaHqo.mjs} +3 -3
  308. package/dist/client/hooks.mjs +3280 -1362
  309. package/dist/client/{locationMap-Di1K0O2S.mjs → locationMap-CEwIKmMb.mjs} +3 -3
  310. package/dist/client/mailingListSignupCopy-DS-_ePzG.mjs +14 -0
  311. package/dist/client/{media-D29-F1u_.mjs → media-V_ShXXru.mjs} +3 -3
  312. package/dist/client/{mediaContext-CwbbimYB.mjs → mediaContext-D-0tNVxE.mjs} +1 -1
  313. package/dist/client/{newsletterForm-CwxcwTNO.mjs → newsletterForm-CmwTltoS.mjs} +52 -15
  314. package/dist/client/{productDetail-BLSnhPdA.mjs → productDetail-DjIzUwg3.mjs} +3 -3
  315. package/dist/client/{productList-oGytONOX.mjs → productList-D6JGFnMF.mjs} +3 -3
  316. package/dist/client/{propsDecoder-lf_dTeZS.mjs → propsDecoder-BRKz13eg.mjs} +17944 -14861
  317. package/dist/client/{renderableMediaAssetAdmission-CHkXYDC_.mjs → renderableMediaAssetAdmission-Cd3JSw2H.mjs} +3 -1
  318. package/dist/client/rendering/client.mjs +15893 -11685
  319. package/dist/client/rendering/islands.mjs +19 -19
  320. package/dist/client/rendering.mjs +14451 -8139
  321. package/dist/client/{routeIslandApiConfig-Bc_WVPS8.mjs → routeIslandApiConfig-slAAILQ5.mjs} +1 -1
  322. package/dist/client/{shop-BQ3bR7fA.mjs → shop-C45K96_0.mjs} +178 -157
  323. package/dist/client/{shop-commerce-DDPll6ZC.mjs → shop-commerce-oGBiKT5d.mjs} +23 -10
  324. package/dist/client/{shop-commerce-store-DO-e1pTe.mjs → shop-commerce-store-H_HFPFZ8.mjs} +1 -1
  325. package/dist/client/{shopShared-BylM9jh1.mjs → shopShared-D54T_LAV.mjs} +5 -5
  326. package/dist/client/{useDiscountCodeUi-B1Puub2v.mjs → useDiscountCodeUi-Dm2EUa03.mjs} +1 -1
  327. package/dist/client/{useEventPagination-BBhkmQaT.mjs → useEventPagination-0l_A8CxG.mjs} +62 -24
  328. package/dist/preview-next/before-render.mjs +134 -51
  329. package/dist/preview-next/client/runtime.mjs +3 -3
  330. package/dist/preview-next/editor-chrome.css +5 -2
  331. package/dist/preview-next/keepAlive.mjs +134 -51
  332. package/dist/preview-next/middleware.mjs +134 -51
  333. package/dist/{sdk-runtime-DWCvhJGu.mjs → sdk-runtime-CjTM32Ah.mjs} +1 -1
  334. package/dist/server/components.mjs +15231 -10855
  335. package/dist/server/config-validation.mjs +3153 -1323
  336. package/dist/server/config.mjs +3119 -1321
  337. package/dist/server/data.mjs +3201 -1329
  338. package/dist/server/date-time.mjs +270 -117
  339. package/dist/server/index.mjs +137 -52
  340. package/dist/server/next.mjs +14713 -10388
  341. package/dist/server/page-converter.mjs +2642 -1073
  342. package/dist/server/prebuild.mjs +1 -1
  343. package/dist/server/rendering/server.mjs +14674 -10630
  344. package/dist/server/rendering.mjs +15055 -10670
  345. package/dist/server/routing.mjs +3483 -1488
  346. package/dist/server/server.mjs +3620 -1740
  347. package/dist/server/theme-bridge.mjs +2694 -189
  348. package/dist/server/theme.mjs +422 -67
  349. package/dist/{spinner-BYM-Y81w.mjs → spinner-KVVZh8jd.mjs} +1 -1
  350. package/dist/src-BgmWy3P1.mjs +1667 -0
  351. package/dist/styles/index.css +1196 -2
  352. package/package.json +1 -1
  353. package/dist/_dts/blocks/src/system/blocks/events/shared/layout.d.ts +0 -12
  354. package/dist/client/CheckboxChoice-Dq30m3DO.mjs +0 -24
  355. package/dist/client/DemoBookingPortalAccess-ojwbVUmx.mjs +0 -344
  356. package/dist/client/ThemedButton-B7HFqFBg.mjs +0 -411
  357. package/dist/client/carousel-BSCBhfHY.mjs +0 -38
@@ -91,6 +91,8 @@ export type SurfaceSpec = Readonly<{
91
91
  buttonContext?: Readonly<{
92
92
  primary: import('../buttons/types').OpaqueButtonColourToken;
93
93
  }>;
94
+ /** Foreground candidates the shared check validates on this paint; a candidate that fails falls back as usual. */
95
+ foreground?: SurfaceForegroundCandidates;
94
96
  }> | Readonly<{
95
97
  kind: 'tint';
96
98
  base: string;
@@ -4,7 +4,7 @@ import type { ContentFrameIntent, EyebrowTreatment, EventListTreatment, HeroComp
4
4
  import type { ItemRole } from '../cards/types';
5
5
  import type { AppearancePresetId } from './types';
6
6
  import type { LookOption, LookOptionGroup } from './lookOptionGroups';
7
- export type AppearancePresetTarget = 'hero' | 'intro' | 'body-text' | 'offerings' | 'feature-cards' | 'events' | 'media-text' | 'testimonials' | 'faq' | 'contact-form' | 'newsletter' | 'cta';
7
+ export type AppearancePresetTarget = 'hero' | 'intro' | 'body-text' | 'offerings' | 'feature-cards' | 'events' | 'media-text' | 'image-gallery' | 'testimonials' | 'faq' | 'contact-form' | 'newsletter' | 'cta';
8
8
  export type BlockAppearanceDesign = Readonly<{
9
9
  sectionSurface: SiteStyleSurfaceIntent;
10
10
  contentFrame: ContentFrameIntent;
@@ -55,7 +55,9 @@ export declare const cardListKnobs: readonly ["actionStyle", "showPhotos", "card
55
55
  export declare const lookKnobBlocks: {
56
56
  readonly actionStyle: readonly [...("block.feature-cards" | "block.appointment-services" | "block.offerings-preview")[], "block.event-calendar"];
57
57
  readonly titleSize: "block.hero";
58
- readonly imagePosition: "block.hero";
58
+ readonly imagePosition: readonly ["block.hero", "block.intro", "block.media-text"];
59
+ readonly imageShape: readonly ["block.intro", "block.media-text"];
60
+ readonly aspectRatio: "block.media-text";
59
61
  readonly stickerLine: "block.hero";
60
62
  readonly smallCaption: "block.hero";
61
63
  readonly candleGlow: "block.hero";
@@ -65,7 +67,7 @@ export declare const lookKnobBlocks: {
65
67
  readonly dates: "block.offerings-preview";
66
68
  readonly showCapacity: "block.event-calendar";
67
69
  readonly quoteCount: "block.testimonials";
68
- readonly archFrame: "block.testimonials";
70
+ readonly archFrame: readonly ["block.testimonials", "block.newsletter-signup", "block.form"];
69
71
  readonly tilt: "block.testimonials";
70
72
  };
71
73
  export type LookKnobId = keyof typeof lookKnobBlocks;
@@ -104,7 +106,7 @@ type AppearancePresetIdentity = Readonly<{
104
106
  id: string;
105
107
  target: AppearancePresetTarget;
106
108
  label: string;
107
- blockKinds: readonly ('block.hero' | 'block.intro' | 'block.offerings-preview' | 'block.feature-cards' | 'block.event-calendar' | 'block.event-listing' | 'block.event-details' | 'block.media-text' | 'block.testimonials' | 'block.faq' | 'block.form' | 'block.appointment-booking' | 'block.appointment-services' | 'block.cta-full')[];
109
+ blockKinds: readonly ('block.hero' | 'block.intro' | 'block.body-text' | 'block.offerings-preview' | 'block.feature-cards' | 'block.event-calendar' | 'block.event-listing' | 'block.event-details' | 'block.media-text' | 'block.image-gallery' | 'block.newsletter-signup' | 'block.testimonials' | 'block.faq' | 'block.form' | 'block.appointment-booking' | 'block.appointment-services' | 'block.cta-full')[];
108
110
  }>;
109
111
  export type LegacyBlockAppearancePreset = AppearancePresetIdentity & Readonly<{
110
112
  /**
@@ -135,12 +137,12 @@ export declare function isArrangementAppearancePreset(preset: BlockAppearancePre
135
137
  export declare function lookModes(look: ArrangementBlockAppearancePreset): readonly (string | null)[];
136
138
  export type AppearancePreset = BlockAppearancePreset;
137
139
  export type BlockAppearancePresetTarget = BlockAppearancePreset['target'];
138
- export declare const appearancePresetTargets: readonly ["hero", "intro", "body-text", "offerings", "feature-cards", "events", "media-text", "testimonials", "faq", "contact-form", "newsletter", "cta"];
140
+ export declare const appearancePresetTargets: readonly ["hero", "intro", "body-text", "offerings", "feature-cards", "events", "media-text", "image-gallery", "testimonials", "faq", "contact-form", "newsletter", "cta"];
139
141
  export declare function cardListKnobDefaults(block: string, arrangement: string, knobs: readonly LookKnobId[], defaults: ArrangementBlockAppearancePreset['structure']['knobDefaults']): {
140
142
  knobs?: undefined;
141
143
  knobDefaults?: undefined;
142
144
  } | {
143
- knobs: ("dates" | "actionStyle" | "showPhotos" | "cardMarker" | "titleSize" | "imagePosition" | "stickerLine" | "smallCaption" | "candleGlow" | "columnGuides" | "showCapacity" | "quoteCount" | "archFrame" | "tilt")[];
145
+ knobs: ("dates" | "actionStyle" | "showPhotos" | "cardMarker" | "titleSize" | "imagePosition" | "imageShape" | "aspectRatio" | "stickerLine" | "smallCaption" | "candleGlow" | "columnGuides" | "showCapacity" | "quoteCount" | "archFrame" | "tilt")[];
144
146
  knobDefaults: {
145
147
  dates?: string | undefined;
146
148
  actionStyle: string;
@@ -148,6 +150,8 @@ export declare function cardListKnobDefaults(block: string, arrangement: string,
148
150
  cardMarker?: string | undefined;
149
151
  titleSize?: string | undefined;
150
152
  imagePosition?: string | undefined;
153
+ imageShape?: string | undefined;
154
+ aspectRatio?: string | undefined;
151
155
  stickerLine?: string | undefined;
152
156
  smallCaption?: string | undefined;
153
157
  candleGlow?: string | undefined;
@@ -158,6 +162,19 @@ export declare function cardListKnobDefaults(block: string, arrangement: string,
158
162
  tilt?: string | undefined;
159
163
  };
160
164
  };
161
- export declare function defineArrangementLook(id: string, block: 'hero' | 'feature-cards' | 'event-calendar' | 'testimonials' | 'event-details', name: string, arrangement: string, knobs: readonly LookKnobId[], input?: Partial<Pick<ArrangementBlockAppearancePreset['structure'], 'itemRoles' | 'slotRoles' | 'actionSize' | 'whenMissing' | 'styleFallback' | 'forcedKnobs' | 'knobValues' | 'knobDefaults' | 'knobDescriptions'>>): ArrangementBlockAppearancePreset;
165
+ declare const arrangementLookTargets: {
166
+ readonly hero: "hero";
167
+ readonly intro: "intro";
168
+ readonly 'feature-cards': "feature-cards";
169
+ readonly 'event-calendar': "events";
170
+ readonly testimonials: "testimonials";
171
+ readonly 'event-details': "events";
172
+ readonly 'media-text': "media-text";
173
+ readonly 'image-gallery': "image-gallery";
174
+ readonly 'newsletter-signup': "newsletter";
175
+ readonly form: "contact-form";
176
+ readonly 'body-text': "body-text";
177
+ };
178
+ export declare function defineArrangementLook(id: string, block: keyof typeof arrangementLookTargets, name: string, arrangement: string, knobs: readonly LookKnobId[], input?: Partial<Pick<ArrangementBlockAppearancePreset['structure'], 'itemRoles' | 'slotRoles' | 'actionSize' | 'whenMissing' | 'styleFallback' | 'forcedKnobs' | 'knobValues' | 'knobDefaults' | 'knobDescriptions'>>): ArrangementBlockAppearancePreset;
162
179
  export declare function defineCardListLook(id: string, name: string, arrangement: string, requires: readonly CardListItemPart[], knobs: readonly LookKnobId[], input?: NonNullable<Parameters<typeof defineArrangementLook>[5]>): ArrangementBlockAppearancePreset;
163
180
  export {};
@@ -2,6 +2,6 @@ import { type ThemeColorToken } from '../tokens';
2
2
  export declare const backgroundAppearanceQuickColorTokenNames: readonly ["background", "surface", "muted", "primary", "secondary", "accent"];
3
3
  export declare const backgroundAppearanceBaseColorTokenNames: readonly ["background", "surface", "surfaceAlt", "muted", "primary", "secondary", "accent", "neutral"];
4
4
  export declare const backgroundAppearanceShadeableColorTokenNames: readonly ["primary", "secondary", "accent", "neutral"];
5
- export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
6
- export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "neutral-500" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
5
+ export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "secondary-950" | "primary-800" | "primary-100" | "neutral-500" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
6
+ export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "neutral-600" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "secondary-950" | "primary-800" | "primary-100" | "neutral-500" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
7
7
  export declare function parseBackgroundAppearanceColorToken(value: unknown): ThemeColorToken | null;
@@ -1,3 +1,4 @@
1
+ import { type FooterPreferences } from './footerPreferences';
1
2
  import type { Theme } from '../schema';
2
3
  import type { ButtonSystem } from '../buttons/types';
3
4
  import type { ButtonStyleSelection } from '../buttons/styles/selection';
@@ -53,12 +54,7 @@ export type HeaderPreserveDirective = Readonly<{
53
54
  }>;
54
55
  export type HeaderCompilationDirective = HeaderPreserveDirective | HeaderRecompileDirective;
55
56
  export type FooterCompilationDirective = Readonly<{
56
- kind: 'preserve';
57
- footer: Theme['footer'];
58
- footerLookId: FooterLookId | null;
59
- }> | Readonly<{
60
- kind: 'apply-look';
61
- footer: Theme['footer'];
57
+ preferences: FooterPreferences;
62
58
  footerLookId: FooterLookId | null;
63
59
  }>;
64
60
  export type ButtonUpdateRecompileReason = 'selection-change' | 'missing-applied-buttons';
@@ -88,6 +84,7 @@ export type SiteThemeCompilationPlan = Readonly<{
88
84
  buttons: ReplacementButtonRecompileDirective;
89
85
  header: HeaderRecompileDirective;
90
86
  footerLookId: FooterLookId | null;
87
+ footerPreferences: FooterPreferences;
91
88
  }> | Readonly<{
92
89
  kind: 'update-selection';
93
90
  buttons: ButtonCompilationDirective;
@@ -98,6 +95,7 @@ export declare function replaceSiteStyleCompilationPlan(input: Readonly<{
98
95
  headerSelection: HeaderLayoutStyleSelection;
99
96
  buttonStyleSelection?: ButtonStyleSelection | null;
100
97
  footerLookId?: FooterLookId | null;
98
+ footerPreferences?: FooterPreferences;
101
99
  headerLogo?: HeaderLogoContext;
102
100
  }>): Extract<SiteThemeCompilationPlan, {
103
101
  kind: 'replace-site-style';
@@ -0,0 +1,121 @@
1
+ import type { Theme } from '../schema';
2
+ import type { CuratedSiteStyle } from './curatedSiteStyles';
3
+ import { type FooterPreferences } from './footerPreferences';
4
+ import { type FooterLookId } from './footerLooks';
5
+ /** The one footer composition: offered selection → recipe → whole intent record. */
6
+ export declare function compileFooterAgainstRow<TTheme extends Theme>(input: Readonly<{
7
+ theme: TTheme;
8
+ siteStyle: CuratedSiteStyle | null;
9
+ lookId: FooterLookId | null;
10
+ preferences: FooterPreferences;
11
+ }>): {
12
+ theme: TTheme & {
13
+ footer: {
14
+ variant: "split" | "simple" | "centred";
15
+ maxWidth: "full" | "container";
16
+ background: {
17
+ type: "image" | "color" | "gradient";
18
+ contentOwner?: "site-chrome-editor" | undefined;
19
+ color?: string | null | undefined;
20
+ gradient?: {
21
+ type: "linear" | "radial" | "conic";
22
+ stops: {
23
+ color: string;
24
+ position: number;
25
+ }[];
26
+ angle?: number | undefined;
27
+ shape?: "circle" | "ellipse" | undefined;
28
+ position?: string | undefined;
29
+ } | null | undefined;
30
+ image?: import("../../../media-core/src/index").Media | null | undefined;
31
+ textColor?: string | null | undefined;
32
+ };
33
+ navStyle: "scale" | "solid" | "underline" | "minimal" | "underline-grow" | "capsule" | "frosted";
34
+ navWeight: "bold" | "medium" | "regular" | "semibold";
35
+ navColor?: string | null | undefined;
36
+ navLinkStyle?: {
37
+ colorToken: string;
38
+ padding: "none" | "compact" | "default";
39
+ borderRadius: "none" | "full" | "md" | "sm";
40
+ typography: "heading" | "body";
41
+ fontWeight: "bold" | "medium" | "regular" | "semibold";
42
+ textTransform: "none" | "uppercase" | "capitalize";
43
+ italic: boolean;
44
+ textSize?: "base" | "lg" | "xl" | "xs" | "sm" | undefined;
45
+ letterSpacing?: "normal" | "wide" | "wider" | "widest" | undefined;
46
+ contrastTreatment?: "none" | "soft-glow" | undefined;
47
+ hoverColorToken?: string | null | undefined;
48
+ paddingX?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
49
+ effects?: {
50
+ base?: {
51
+ effectId: string;
52
+ options?: Record<string, any> | undefined;
53
+ }[] | undefined;
54
+ hover?: {
55
+ effectId: string;
56
+ options?: Record<string, any> | undefined;
57
+ }[] | undefined;
58
+ active?: {
59
+ effectId: string;
60
+ options?: Record<string, any> | undefined;
61
+ }[] | undefined;
62
+ focus?: {
63
+ effectId: string;
64
+ options?: Record<string, any> | undefined;
65
+ }[] | undefined;
66
+ } | undefined;
67
+ name?: string | undefined;
68
+ } | undefined;
69
+ bottomTextLinkStyle?: {
70
+ colorToken?: string | undefined;
71
+ hoverColorToken?: string | null | undefined;
72
+ decorationColorToken?: string | null | undefined;
73
+ underline?: boolean | undefined;
74
+ } | undefined;
75
+ navLayout?: {
76
+ layout?: "stack" | "inline-wrap" | "inline" | undefined;
77
+ } | undefined;
78
+ logo?: {
79
+ size?: "md" | "lg" | "xl" | "sm" | undefined;
80
+ maxHeight?: "md" | "lg" | "xl" | "sm" | undefined;
81
+ align?: "start" | "end" | "center" | undefined;
82
+ } | undefined;
83
+ bottomBar?: {
84
+ enabled?: boolean | undefined;
85
+ fullBleed?: boolean | undefined;
86
+ background?: {
87
+ type: "image" | "color" | "gradient";
88
+ contentOwner?: "site-chrome-editor" | undefined;
89
+ color?: string | null | undefined;
90
+ gradient?: {
91
+ type: "linear" | "radial" | "conic";
92
+ stops: {
93
+ color: string;
94
+ position: number;
95
+ }[];
96
+ angle?: number | undefined;
97
+ shape?: "circle" | "ellipse" | undefined;
98
+ position?: string | undefined;
99
+ } | null | undefined;
100
+ image?: import("../../../media-core/src/index").Media | null | undefined;
101
+ textColor?: string | null | undefined;
102
+ } | undefined;
103
+ textColor?: string | null | undefined;
104
+ textAlign?: "left" | "right" | "center" | undefined;
105
+ paddingY?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
106
+ paddingX?: "none" | "compact" | "default" | "tight" | "relaxed" | "spacious" | undefined;
107
+ borderTop?: {
108
+ colorToken?: string | null | undefined;
109
+ width?: "none" | "medium" | "thin" | "thick" | undefined;
110
+ } | undefined;
111
+ } | undefined;
112
+ };
113
+ };
114
+ lookId: FooterLookId;
115
+ preferences: Readonly<{
116
+ background: import("../../../blocks/src/index").SiteChromeBackgroundOverride;
117
+ navigationLayout: "inline-wrap" | "stack";
118
+ }>;
119
+ };
120
+ /** Style switches retain an offered choice; otherwise use the style's first choice. */
121
+ export declare function resolveFooterLookIdForStyle(siteStyle: Pick<CuratedSiteStyle, 'recommendedFooterLookIds'> | null, current: FooterLookId | null): FooterLookId;
@@ -1,3 +1,4 @@
1
+ import { type FooterLookRecipeOverrides } from './footerLookDefaults';
1
2
  import type { SiteStyleLooks } from './lookResolution';
2
3
  import { type ButtonStyleSelection } from '../buttons/styles';
3
4
  import { type CuratedPalette, type KnownCuratedPaletteValueKey } from '../palette/curated';
@@ -12,7 +13,7 @@ import { type SiteStyleHeroTypography } from './siteStyleTypography';
12
13
  import { type ComponentRuntimeRules, type DesignRuntimeRules } from './runtimeCompiler';
13
14
  export declare const SOFT_EARTH_SITE_STYLE_ID_VALUE: "site-style:soft-earth";
14
15
  export declare const SOFT_EARTH_SITE_STYLE_ID: SiteStyleId;
15
- export declare const curatedSiteStyleIdValues: readonly ["site-style:clarity-zen-blue", "site-style:soft-earth", "site-style:south-west-twerk-school", "site-style:kirtan-ornate", "site-style:original-joy", "site-style:fulcrum", "site-style:grounded-practice", "site-style:poster", "site-style:lantern", "site-style:measure"];
16
+ export declare const curatedSiteStyleIdValues: readonly ["site-style:clarity-zen-blue", "site-style:soft-earth", "site-style:south-west-twerk-school", "site-style:kirtan-ornate", "site-style:original-joy", "site-style:fulcrum", "site-style:grounded-practice", "site-style:poster", "site-style:lantern", "site-style:measure", "site-style:folio"];
16
17
  export type CuratedSiteStyleIdValue = (typeof curatedSiteStyleIdValues)[number];
17
18
  type CuratedSiteStyleBodyTextOverrides = Readonly<{
18
19
  intro?: NonNullable<NonNullable<Theme['bodyText']>['intro']>;
@@ -115,6 +116,10 @@ export type SiteStyleOfferingAudience = Readonly<{
115
116
  audience: 'generation';
116
117
  }> | Readonly<{
117
118
  audience: 'lab';
119
+ }> | Readonly<{
120
+ audience: 'local-demo';
121
+ environment: 'local-development' | 'deployed';
122
+ siteSlug?: string | null;
118
123
  }>;
119
124
  export type SiteStyleOfferingDecision = Readonly<{
120
125
  kind: 'offered';
@@ -168,6 +173,8 @@ export type CuratedSiteStyle = Readonly<{
168
173
  * docs/guides/site-styles.md.
169
174
  */
170
175
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
176
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
177
+ footerLookRecipes?: FooterLookRecipeOverrides;
171
178
  recommendedFooterLookIds: readonly FooterLookId[];
172
179
  /** Authored picker choices. First item is the default/fallback. */
173
180
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -233,6 +240,59 @@ export declare const curatedSiteStyles: readonly [Readonly<{
233
240
  * docs/guides/site-styles.md.
234
241
  */
235
242
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
243
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
244
+ footerLookRecipes?: FooterLookRecipeOverrides;
245
+ recommendedFooterLookIds: readonly FooterLookId[];
246
+ /** Authored picker choices. First item is the default/fallback. */
247
+ buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
248
+ /** Authored picker choices. First item is the default/fallback. */
249
+ paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
250
+ /** Concrete typography applied when this site style is selected. */
251
+ typography: Theme["typography"];
252
+ /** Optional concrete hero typography applied with the site style. */
253
+ heroTypography?: SiteStyleHeroTypography;
254
+ }>, Readonly<{
255
+ id: SiteStyleId;
256
+ name: string;
257
+ description: string;
258
+ generationBrief: string;
259
+ selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
260
+ offering: SiteStyleOffering;
261
+ template: DesignSystemTemplate;
262
+ themeOverrides?: CuratedSiteStyleThemeOverrides;
263
+ /**
264
+ * Optional Theme V2 runtime rules owned by the style. These translate
265
+ * semantic section surfaces into block runtime fields such as background
266
+ * and foreground tokens.
267
+ */
268
+ designRuntimeRules?: DesignRuntimeRules;
269
+ /** Resolves semantic frames/items into this style's shape and depth language. */
270
+ componentRuntimeRules: ComponentRuntimeRules;
271
+ defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
272
+ /**
273
+ * Site-wide heading decoration signature (family + colour). Applied to
274
+ * eligible block headings as a single consistent mark; alignment is inherited
275
+ * from the heading. The factory defaults this to the short centre rule.
276
+ */
277
+ headingDecoration: HeadingDecoration;
278
+ looks: SiteStyleLooks;
279
+ /** Used only when creating a default content template, never at render time. */
280
+ contentTemplateDefaults?: Readonly<{
281
+ event: "event-header";
282
+ }>;
283
+ headerCuration: HeaderCuration;
284
+ /**
285
+ * Header appearance this style owns outright, keyed by catalogue style id.
286
+ * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
287
+ * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
288
+ *
289
+ * No curated style authors one yet (ledger D5): the seam ships empty and
290
+ * adoption follows real site work, per the "do not pre-author" rule in
291
+ * docs/guides/site-styles.md.
292
+ */
293
+ headerStyleRecipes?: HeaderStyleRecipeOverrides;
294
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
295
+ footerLookRecipes?: FooterLookRecipeOverrides;
236
296
  recommendedFooterLookIds: readonly FooterLookId[];
237
297
  /** Authored picker choices. First item is the default/fallback. */
238
298
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -282,6 +342,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
282
342
  * docs/guides/site-styles.md.
283
343
  */
284
344
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
345
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
346
+ footerLookRecipes?: FooterLookRecipeOverrides;
285
347
  recommendedFooterLookIds: readonly FooterLookId[];
286
348
  /** Authored picker choices. First item is the default/fallback. */
287
349
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -331,6 +393,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
331
393
  * docs/guides/site-styles.md.
332
394
  */
333
395
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
396
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
397
+ footerLookRecipes?: FooterLookRecipeOverrides;
334
398
  recommendedFooterLookIds: readonly FooterLookId[];
335
399
  /** Authored picker choices. First item is the default/fallback. */
336
400
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -380,6 +444,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
380
444
  * docs/guides/site-styles.md.
381
445
  */
382
446
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
447
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
448
+ footerLookRecipes?: FooterLookRecipeOverrides;
383
449
  recommendedFooterLookIds: readonly FooterLookId[];
384
450
  /** Authored picker choices. First item is the default/fallback. */
385
451
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -429,6 +495,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
429
495
  * docs/guides/site-styles.md.
430
496
  */
431
497
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
498
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
499
+ footerLookRecipes?: FooterLookRecipeOverrides;
432
500
  recommendedFooterLookIds: readonly FooterLookId[];
433
501
  /** Authored picker choices. First item is the default/fallback. */
434
502
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -478,6 +546,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
478
546
  * docs/guides/site-styles.md.
479
547
  */
480
548
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
549
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
550
+ footerLookRecipes?: FooterLookRecipeOverrides;
481
551
  recommendedFooterLookIds: readonly FooterLookId[];
482
552
  /** Authored picker choices. First item is the default/fallback. */
483
553
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -527,6 +597,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
527
597
  * docs/guides/site-styles.md.
528
598
  */
529
599
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
600
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
601
+ footerLookRecipes?: FooterLookRecipeOverrides;
530
602
  recommendedFooterLookIds: readonly FooterLookId[];
531
603
  /** Authored picker choices. First item is the default/fallback. */
532
604
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -576,6 +648,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
576
648
  * docs/guides/site-styles.md.
577
649
  */
578
650
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
651
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
652
+ footerLookRecipes?: FooterLookRecipeOverrides;
579
653
  recommendedFooterLookIds: readonly FooterLookId[];
580
654
  /** Authored picker choices. First item is the default/fallback. */
581
655
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -625,6 +699,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
625
699
  * docs/guides/site-styles.md.
626
700
  */
627
701
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
702
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
703
+ footerLookRecipes?: FooterLookRecipeOverrides;
628
704
  recommendedFooterLookIds: readonly FooterLookId[];
629
705
  /** Authored picker choices. First item is the default/fallback. */
630
706
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -674,6 +750,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
674
750
  * docs/guides/site-styles.md.
675
751
  */
676
752
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
753
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
754
+ footerLookRecipes?: FooterLookRecipeOverrides;
677
755
  recommendedFooterLookIds: readonly FooterLookId[];
678
756
  /** Authored picker choices. First item is the default/fallback. */
679
757
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -724,6 +802,8 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
724
802
  * docs/guides/site-styles.md.
725
803
  */
726
804
  headerStyleRecipes?: HeaderStyleRecipeOverrides;
805
+ /** Whole footer recipes owned by this style; omitted entries use the catalogue default. */
806
+ footerLookRecipes?: FooterLookRecipeOverrides;
727
807
  recommendedFooterLookIds: readonly FooterLookId[];
728
808
  /** Authored picker choices. First item is the default/fallback. */
729
809
  buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -0,0 +1,45 @@
1
+ import type { FooterLookIdValue } from './footerLooks';
2
+ import type { FooterLookRecipe } from './footerLookRecipe';
3
+ export type FooterLookRecipeOverrides = Partial<Record<FooterLookIdValue, FooterLookRecipe>>;
4
+ export type FooterLookRecipeOwner = Readonly<{
5
+ footerLookRecipes?: FooterLookRecipeOverrides;
6
+ }>;
7
+ export declare const defaultFooterLookRecipes: {
8
+ readonly 'footer-centred-name': {
9
+ readonly arrangement: "centred";
10
+ readonly ground: {
11
+ readonly kind: "token";
12
+ readonly token: "surface";
13
+ };
14
+ readonly nav: {
15
+ readonly weight: "regular";
16
+ readonly colorToken: "text";
17
+ readonly hoverColorToken: "primary";
18
+ readonly typography: "body";
19
+ };
20
+ readonly legal: {
21
+ readonly kind: "separate";
22
+ readonly bar: null;
23
+ };
24
+ readonly brandAlign: "center";
25
+ };
26
+ readonly 'footer-links-row': {
27
+ readonly arrangement: "simple";
28
+ readonly ground: {
29
+ readonly kind: "token";
30
+ readonly token: "surface";
31
+ };
32
+ readonly nav: {
33
+ readonly weight: "regular";
34
+ readonly colorToken: "text";
35
+ readonly hoverColorToken: "primary";
36
+ readonly typography: "body";
37
+ };
38
+ readonly legal: {
39
+ readonly kind: "integrated";
40
+ };
41
+ readonly brandAlign: "start";
42
+ };
43
+ };
44
+ /** A whole authored recipe replaces the default; facets are never deep-merged. */
45
+ export declare function resolveFooterLookRecipe(style: FooterLookRecipeOwner | null, id: FooterLookIdValue): FooterLookRecipe;
@@ -0,0 +1,50 @@
1
+ import type { Theme } from '../schema';
2
+ import type { PaletteTokenName, themeColorShadeSteps } from '../tokens';
3
+ import type { SiteStyleLooks } from './lookResolution';
4
+ export type FooterRecipeColorToken = PaletteTokenName | `${PaletteTokenName}-${(typeof themeColorShadeSteps)[number]}`;
5
+ export type FooterGround = Readonly<{
6
+ kind: 'token';
7
+ token: FooterRecipeColorToken;
8
+ }> | Readonly<{
9
+ kind: 'style-surface';
10
+ surface: string;
11
+ }>;
12
+ export type FooterBarPaint = Readonly<{
13
+ fullBleed: boolean;
14
+ background: FooterGround;
15
+ textColor: FooterRecipeColorToken;
16
+ textAlign: 'left' | 'center' | 'right';
17
+ paddingY: 'none' | 'tight' | 'compact' | 'default' | 'relaxed' | 'spacious';
18
+ paddingX: 'none' | 'tight' | 'compact' | 'default' | 'relaxed' | 'spacious';
19
+ borderTop: Readonly<{
20
+ width: 'none' | 'thin' | 'medium' | 'thick';
21
+ colorToken?: FooterRecipeColorToken;
22
+ }>;
23
+ }>;
24
+ export type FooterLookRecipe = Readonly<{
25
+ arrangement: 'simple' | 'split' | 'centred';
26
+ ground: FooterGround;
27
+ nav: Readonly<{
28
+ weight: 'regular' | 'medium' | 'semibold' | 'bold';
29
+ colorToken: FooterRecipeColorToken;
30
+ hoverColorToken: FooterRecipeColorToken;
31
+ typography: 'body' | 'heading';
32
+ }>;
33
+ legal: Readonly<{
34
+ kind: 'integrated';
35
+ }> | Readonly<{
36
+ kind: 'separate';
37
+ bar: FooterBarPaint | null;
38
+ linkStyle?: Theme['footer']['bottomTextLinkStyle'];
39
+ }>;
40
+ brandAlign: 'start' | 'center' | 'end';
41
+ /** A style's fixed brand height; otherwise derived from the header. */
42
+ brandLogoSize?: 'sm' | 'md' | 'lg' | 'xl';
43
+ }>;
44
+ export type FooterRecipeSurfaceOwner = Readonly<{
45
+ looks: SiteStyleLooks;
46
+ }>;
47
+ /** Construct appearance from its owners; persisted footer bytes are never inputs. */
48
+ export declare function compileFooterRecipe(recipe: FooterLookRecipe, theme: Theme, style: FooterRecipeSurfaceOwner): Theme['footer'];
49
+ /** Reject undeclared references when the curated catalogue is loaded, before rendering. */
50
+ export declare function validateFooterRecipeSurfaces(style: FooterRecipeSurfaceOwner, recipe: FooterLookRecipe): void;
@@ -1,6 +1,5 @@
1
- import type { Theme } from '../schema';
2
1
  import { type Brand } from './types';
3
- export declare const footerLookIdValues: readonly ["footer-links-quiet", "footer-links-emphasized"];
2
+ export declare const footerLookIdValues: readonly ["footer-links-row", "footer-centred-name"];
4
3
  export type FooterLookIdValue = (typeof footerLookIdValues)[number];
5
4
  export type FooterLookId = Brand<FooterLookIdValue, 'FooterLookId'>;
6
5
  export declare function asFooterLookId(value: FooterLookIdValue): FooterLookId;
@@ -17,46 +16,21 @@ export declare function parsePersistedFooterLookId(value: string): Exclude<Persi
17
16
  kind: 'empty';
18
17
  }>;
19
18
  export declare function parsePersistedFooterLookId(value: string | null | undefined): PersistedFooterLookIdParseResult;
20
- export type FooterArrangementBlockAppearancePreset = Readonly<{
19
+ export type FooterLookDefinition = Readonly<{
21
20
  id: FooterLookId;
22
21
  label: string;
23
22
  description: string;
24
- compile: (theme: Theme) => Theme['footer'];
25
- }>;
26
- export type FooterSelectionResult = Readonly<{
27
- selectedLookId: FooterLookId;
28
- selectedLook: FooterArrangementBlockAppearancePreset;
29
- footer: Theme['footer'];
30
- rejected: readonly [];
31
- }>;
32
- export type FooterLookDiagnostics = Readonly<{
33
- surface: Readonly<{
34
- kind: 'site-footer';
35
- }>;
36
- selectedLookId: FooterLookId;
37
- rejected: readonly [];
38
- }>;
39
- export type FooterLookResolutionInput = Readonly<{
40
- theme: Theme;
41
- recommendedLookIds: readonly FooterLookId[];
42
23
  }>;
43
24
  export declare const guaranteedFallbackFooterLookId: FooterLookId;
44
- declare function quietFooterLinks(theme: Theme): Theme['footer'];
45
- declare function emphasizedFooterLinks(theme: Theme): Theme['footer'];
46
25
  export declare const footerLookCatalog: readonly [{
47
26
  readonly id: FooterLookId;
48
- readonly label: "Quiet links";
49
- readonly description: "Regular-weight footer navigation with a restrained hover.";
50
- readonly compile: typeof quietFooterLinks;
27
+ readonly label: "Links in a row";
28
+ readonly description: "Your links in a row, with the other footer sections in columns beside them.";
51
29
  }, {
52
30
  readonly id: FooterLookId;
53
- readonly label: "Emphasized links";
54
- readonly description: "Medium-weight footer navigation with a clearer emphasis.";
55
- readonly compile: typeof emphasizedFooterLinks;
31
+ readonly label: "Centred name, links beneath";
32
+ readonly description: "Your site name centred, with your links, contact details and social links beneath it.";
56
33
  }];
57
- export declare function getFooterLook(id: FooterLookId): FooterArrangementBlockAppearancePreset | null;
58
- export declare function findFooterLook(id: FooterLookId): FooterArrangementBlockAppearancePreset | undefined;
59
- export declare function getFooterLookOrThrow(id: FooterLookId): FooterArrangementBlockAppearancePreset;
60
- export declare function resolveFooterLook(input: FooterLookResolutionInput): FooterSelectionResult;
61
- export declare function footerLookDiagnosticsFromSelectionResult(result: FooterSelectionResult): FooterLookDiagnostics;
62
- export {};
34
+ export declare function getFooterLook(id: FooterLookId): FooterLookDefinition | null;
35
+ export declare function findFooterLook(id: FooterLookId): FooterLookDefinition | undefined;
36
+ export declare function getFooterLookOrThrow(id: FooterLookId): FooterLookDefinition;
@@ -0,0 +1,29 @@
1
+ import { z } from 'zod';
2
+ import type { Theme, ThemeFooter } from '../schema';
3
+ import { type SiteChromeBackgroundOverride } from './siteChromeBackgrounds';
4
+ export type FooterPreferences = Readonly<{
5
+ background: SiteChromeBackgroundOverride;
6
+ navigationLayout: 'inline-wrap' | 'stack';
7
+ }>;
8
+ export declare const defaultFooterPreferences: FooterPreferences;
9
+ export declare const footerPreferencesSchema: z.ZodType<FooterPreferences>;
10
+ /** Quick controls express background only; the composer owns navigation intent. */
11
+ export declare const footerPreferencesWireSchema: z.ZodObject<{
12
+ background: z.ZodDiscriminatedUnion<[z.ZodObject<{
13
+ kind: z.ZodLiteral<"default">;
14
+ }, z.core.$strict>, z.ZodObject<{
15
+ kind: z.ZodLiteral<"color">;
16
+ token: z.ZodType<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown, z.core.$ZodTypeInternals<import("../../../blocks/src/index").SiteChromeBackgroundColorToken, unknown>>;
17
+ }, z.core.$strict>], "kind">;
18
+ }, z.core.$strict>;
19
+ export type PersistedFooterPreferences = Readonly<{
20
+ kind: 'present';
21
+ preferences: FooterPreferences;
22
+ }> | Readonly<{
23
+ kind: 'invalid';
24
+ issues: readonly string[];
25
+ }>;
26
+ export declare function parsePersistedFooterPreferences(value: unknown): PersistedFooterPreferences;
27
+ /** One-time backfill rule, also exercised against the migration SQL. Not a runtime fallback. */
28
+ export declare function readFooterPreferences(theme: unknown): FooterPreferences;
29
+ export declare function applyFooterPreferences(theme: Theme, footer: ThemeFooter, preferences: FooterPreferences): ThemeFooter;