@riverbankcms/sdk 0.107.0 → 0.109.0

package/dist/_dts/blocks/src/system/node/fragments/styledContainer.d.ts

@@ -30,15 +30,15 @@ export type StyledContainerConfig = {
      * Base CSS classes always applied to the container element.
      *
      * This element is the containing block for absolute-positioned background layers.
-     * We default to `rb-overflow-hidden` so background layers clip correctly
-     * (especially with rounded corners + scaled images).
+     * Decorative background layers clip in their own absolute frame so this
+     * foreground root can leave focus rings and editor chrome visible.
      *
-     * @default 'rb-relative rb-isolate rb-overflow-hidden'
+     * @default 'rb-relative rb-isolate rb-overflow-visible'
      */
     baseClassName?: string;
     /**
      * CSS class to apply to background image layer.
-     * @default 'rb-absolute rb-z-neg-10'
+     * @default 'rb-absolute rb-z-0'
      */
     imageClassName?: string;
     /**

package/dist/_dts/blocks/src/system/node/fragments/styledSection.d.ts

@@ -37,13 +37,13 @@ export type StyledSectionConfig = {
     background?: string;
     /**
      * Path to the section styles data in the content (e.g., '_sectionStyles').
-     * This path is used for binding className, allowOverflow, and background layers.
+     * This path is used for binding className and background layers.
      * @default '_sectionStyles'
      */
     bindFrom?: string;
     /**
      * CSS class to apply to background image layer.
-     * @default 'rb-absolute rb-z-neg-10'
+     * @default 'rb-absolute rb-z-0'
      */
     imageClassName?: string;
     /**
@@ -63,15 +63,6 @@ export type StyledSectionConfig = {
      * Browser fetch priority hint for the automatic background image layer.
      */
     backgroundImageFetchPriority?: MediaImageFetchPriority;
-    /**
-     * Force section overflow visible instead of deriving it from the background.
-     *
-     * Useful for layouts with animated foreground elements where no clipped
-     * section background image is being rendered.
-     *
-     * @default false
-     */
-    allowOverflow?: boolean;
     /**
      * Optional path to a boolean flag in block content that should trigger
      * full-width section behavior (removing horizontal `rb-px-*` classes).
@@ -88,7 +79,7 @@ export type StyledSectionConfig = {
  * - Creating a section wrapper with background theme
  * - Adding background color/gradient/image layers
  * - Binding className to section styles with transform
- * - Binding allowOverflow for background positioning
+ * - Keeping foreground overflow visible while decorative backgrounds clip independently
  * - Wrapping content children
  *
  * Use this helper to eliminate 25+ lines of boilerplate section setup code.

package/dist/_dts/blocks/src/system/node/validation-constants.d.ts

@@ -20,7 +20,7 @@ export type AllowedNodeType = (typeof ALLOWED_NODE_TYPES)[number];
  * $bind.transforms within custom block layouts. Transform IDs
  * not in this list will be rejected during validation.
  */
-export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "value.mapToken", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.headerSectionBackground", "layout.classicNavMode", "layout.footerRootStyle", "ui.headerNavLinkClass", "ui.headingClassFromAlignment", "ui.bodyClassFromAlignment", "ui.stackAlignFromAlignment", "ui.sectionStateTone", "ui.heroContentWrapperClass", "ui.heroCtaJustify", "ui.heroStackJustifyFromVerticalAlignment", "ui.heroGridClassFromVerticalAlignment", "ui.conditionalClass", "ui.twoColumnContainerClass", "ui.twoColumnFlexBasis", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveAllowOverflow", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "boxStyles.cardVariantClass", "containerStyles.resolveBoxClassName"];
+export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "value.mapToken", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.headerSectionBackground", "layout.classicNavMode", "layout.footerRootStyle", "ui.headerNavLinkClass", "ui.headingClassFromAlignment", "ui.bodyClassFromAlignment", "ui.stackAlignFromAlignment", "ui.sectionStateTone", "ui.heroContentWrapperClass", "ui.heroCtaJustify", "ui.heroStackJustifyFromVerticalAlignment", "ui.heroGridClassFromVerticalAlignment", "ui.conditionalClass", "ui.twoColumnContainerClass", "ui.twoColumnFlexBasis", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveFrameClassName", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "boxStyles.cardVariantClass", "containerStyles.resolveBoxClassName"];
 export type AllowedTransformId = (typeof ALLOWED_TRANSFORM_IDS)[number];
 /**
  * Set for O(1) lookup of allowed node types.

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -2463,7 +2463,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -2543,7 +2543,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             className: string | null;
                             titleText: string;
                             bodyText: string;
-                            stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                            stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                             summaryButtonText: string;
                         }>;
                         hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -2555,7 +2555,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             className: string | null;
                             titleText: string;
                             bodyText: string;
-                            stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                            stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                             summaryButtonText: string;
                         }>;
                         hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -2606,7 +2606,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         className: string | null;
                         titleText: string;
                         bodyText: string;
-                        stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                        stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                         summaryButtonText: string;
                     }>;
                     hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -2686,7 +2686,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 className: string | null;
                                 titleText: string;
                                 bodyText: string;
-                                stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                                stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                                 summaryButtonText: string;
                             }>;
                             hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -2698,7 +2698,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 className: string | null;
                                 titleText: string;
                                 bodyText: string;
-                                stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                                stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                                 summaryButtonText: string;
                             }>;
                             hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -1250,7 +1250,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1330,7 +1330,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             className: string | null;
                             titleText: string;
                             bodyText: string;
-                            stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                            stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                             summaryButtonText: string;
                         }>;
                         hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1342,7 +1342,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             className: string | null;
                             titleText: string;
                             bodyText: string;
-                            stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                            stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                             summaryButtonText: string;
                         }>;
                         hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;

package/dist/_dts/blocks/src/system/runtime/nodes/shared/contract-schemas.d.ts

@@ -20,8 +20,8 @@ export declare const eventLayoutSchema: z.ZodEnum<{
     compact: "compact";
 }>;
 export declare const eventCalendarDisplayModeSchema: z.ZodEnum<{
-    list: "list";
     calendar: "calendar";
+    list: "list";
     combined: "combined";
     timetable: "timetable";
     "week-board": "week-board";
@@ -36,8 +36,8 @@ export declare const columnOptionSchema: z.ZodEnum<{
     4: "4";
 }>;
 export declare const weekStartSchema: z.ZodEnum<{
-    sunday: "sunday";
     monday: "monday";
+    sunday: "sunday";
 }>;
 export declare const filterAutoShowSchema: z.ZodEnum<{
     auto: "auto";

package/dist/_dts/blocks/src/system/types/link.d.ts

@@ -68,8 +68,8 @@ export declare const internalResolvedLinkSchema: z.ZodObject<{
     routeId: z.ZodString;
     entityId: z.ZodString;
     entityType: z.ZodEnum<{
-        page: "page";
         content: "content";
+        page: "page";
     }>;
     href: z.ZodString;
     title: z.ZodString;
@@ -83,8 +83,8 @@ export declare const internalLinkSchema: z.ZodUnion<readonly [z.ZodObject<{
     routeId: z.ZodString;
     entityId: z.ZodString;
     entityType: z.ZodEnum<{
-        page: "page";
         content: "content";
+        page: "page";
     }>;
     href: z.ZodString;
     title: z.ZodString;
@@ -118,8 +118,8 @@ export declare const linkSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.Zod
     routeId: z.ZodString;
     entityId: z.ZodString;
     entityType: z.ZodEnum<{
-        page: "page";
         content: "content";
+        page: "page";
     }>;
     href: z.ZodString;
     title: z.ZodString;

package/dist/_dts/content-editor/src/FooterComposerPanel.d.ts

@@ -0,0 +1,14 @@
+import type { ApiClient } from '../../api/src/request';
+import { type FooterEditorTarget } from './footerComposer';
+export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageSettingsHref, legalRegion, initialTarget, variant, canEdit, onSaved, }: {
+    apiClient: ApiClient;
+    siteId: string;
+    customFooterMode: 'default' | 'blocks' | 'default+blocks' | 'none';
+    manageLinksHref: string;
+    manageSettingsHref: string;
+    legalRegion?: 'integrated' | 'separate';
+    initialTarget?: FooterEditorTarget;
+    variant?: 'full' | 'sidebar';
+    canEdit?: boolean;
+    onSaved?: () => void;
+}): import("react").JSX.Element;

package/dist/_dts/content-editor/src/controller/EntryControllerProvider.d.ts

@@ -3,7 +3,7 @@ import type { EditorBlockId } from '../../../core/src/index';
 import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
 import { type ReactNode } from 'react';
 import { type PublishOptions } from '../hooks/useEntryActions';
-import { type ApiClient } from '../services';
+import { type ApiClient, type ContentEditorServices } from '../services';
 import type { DraftWorkflowStatus } from '../types';
 import { type EditorUiState } from '../ui/editorUiStore';
 import type { ResolveBlockManifest } from '../ui/blockValidationView';
@@ -47,12 +47,16 @@ export type EntryRecoveryConflictState = Readonly<{
     discardRecoveredChanges: () => void;
 }>;
 /** Actions returned by useEntryActions */
-export type EntryActions = {
+export type EntryActions = Readonly<{
+    kind: 'entryLifecycle';
     saveDraft: () => Promise<void>;
     publish: (options?: PublishOptions) => Promise<void>;
     discardDraft: () => Promise<void>;
     deleteEntry: () => Promise<void>;
-};
+}> | Readonly<{
+    kind: 'pageSurfaceDraft';
+    saveDraft: () => Promise<void>;
+}>;
 export type EntryControllerContextValue = {
     entry: ContentEntrySnapshot;
     baseline: Record<string, unknown>;
@@ -68,7 +72,6 @@ type BaseInternalProps = {
     children: ReactNode;
     apiClient: ApiClient;
     siteId: string;
-    entryId: string;
     routeId?: string;
     type: string;
     schema: ContentTypeSchema;
@@ -84,17 +87,33 @@ type BaseInternalProps = {
     historyShortcutsEnabled?: boolean;
     resolveBlockManifest?: ResolveBlockManifest;
 };
-type PageInternalProps = BaseInternalProps & {
+type EditorOwnerServiceProps = Readonly<{
+    owner: {
+        kind: 'contentEntry';
+        contentEntryId: string;
+    };
+    services?: Extract<ContentEditorServices, {
+        kind: 'entryLifecycle';
+    }>;
+}> | Readonly<{
+    owner: {
+        kind: 'pageSurface';
+        pageSurfaceId: string;
+    };
+    services: Extract<ContentEditorServices, {
+        kind: 'pageSurfaceDraft';
+    }>;
+}>;
+type PageInternalProps = {
     kind: 'page';
     initialStatus?: 'draft' | 'scheduled' | 'published';
-} & {
     initialBlocks?: BlockItem[];
 };
-type ContentInternalProps = BaseInternalProps & {
+type ContentInternalProps = {
     kind: 'content';
     initialBlocks?: BlockItem[];
 };
-type EntryControllerProviderProps = PageInternalProps | ContentInternalProps;
+type EntryControllerProviderProps = BaseInternalProps & EditorOwnerServiceProps & (PageInternalProps | ContentInternalProps);
 /**
  * Entry Controller Provider
  *

package/dist/_dts/content-editor/src/footerComposer.d.ts

@@ -0,0 +1,56 @@
+import { type FooterArrangementPlan, type FooterCompositionV1, type FooterModuleId, type FooterNavigationRole, type FooterSection, type PublicProfile } from '../../core/src/index';
+export type FooterEditorTarget = Readonly<{
+    kind: 'overview';
+}> | Readonly<{
+    kind: 'module';
+    moduleId: FooterModuleId;
+}> | Readonly<{
+    kind: 'shared-profile';
+    section: 'contact' | 'opening-hours' | 'social-links';
+}>;
+export type FooterEditorSource = Readonly<{
+    kind: 'footer-local';
+    description: string;
+}> | Readonly<{
+    kind: 'site-identity';
+    description: string;
+}> | Readonly<{
+    kind: 'footer-menu';
+    role: FooterNavigationRole;
+    description: string;
+}> | Readonly<{
+    kind: 'business-address';
+    description: string;
+}> | Readonly<{
+    kind: 'public-profile';
+    section: 'contact' | 'opening-hours' | 'social-links';
+    description: string;
+}>;
+export type FooterEditorSectionPlan = Readonly<{
+    section: FooterSection;
+    label: string;
+    selected: boolean;
+    source: FooterEditorSource;
+    availability: 'ready' | 'missing-source';
+    status: string | null;
+    actions: readonly ('edit' | 'hide' | 'show' | 'manage-links' | 'repair')[];
+}>;
+export type FooterEditorViewPlan = Readonly<{
+    scopeLabel: 'All pages';
+    shown: readonly FooterEditorSectionPlan[];
+    available: readonly FooterEditorSectionPlan[];
+    arrangement: FooterArrangementPlan;
+}>;
+type FooterEditorViewPlanInput = Readonly<{
+    composition: FooterCompositionV1;
+    publicProfile: PublicProfile;
+    hasBusinessAddress: boolean;
+    hasLogo?: boolean;
+    hasMainNavigation?: boolean;
+    hasLegalPolicyNavigation?: boolean;
+    canEdit: boolean;
+    legalRegion?: 'integrated' | 'separate';
+}>;
+export declare function footerModuleLabel(section: FooterSection): string;
+export declare function planFooterEditorView(input: FooterEditorViewPlanInput): FooterEditorViewPlan;
+export {};

package/dist/_dts/content-editor/src/hooks/useEntryActions.d.ts

@@ -3,7 +3,7 @@ import type { EditorUiStoreInstance } from '../ui/editorUiStore';
 import type { PublishEntryResult } from '../services/contentEntryServices';
 /** Services interface for entry operations */
 export type EntryServices = {
-    deleteEntry: () => Promise<void>;
+    deleteEntry?: () => Promise<void>;
 };
 export type PublishOptions = {
     mode?: 'default' | 'now';

package/dist/_dts/content-editor/src/hooks/useEntryMutations.d.ts

@@ -1,11 +1,11 @@
-import type { ContentEntrySnapshot } from "../../../content-model/src/index";
-import type { EditorUiState } from "../ui/editorUiStore";
-import type { PublishEntryResult } from "../services/contentEntryServices";
+import type { ContentEntrySnapshot } from '../../../content-model/src/index';
+import type { EditorUiState } from '../ui/editorUiStore';
+import type { PublishEntryResult } from '../services/contentEntryServices';
 type StoreApi<T> = {
     getState: () => T;
 };
 export declare function usePublishEntryMutation<TEntry extends ContentEntrySnapshot = ContentEntrySnapshot, TPublishPayload = unknown>({ publishFn, siteId, type, entryId, isPage, pageId, uiStore, }: {
-    publishFn: (payload: TPublishPayload | undefined) => Promise<PublishEntryResult<TEntry>>;
+    publishFn?: (payload: TPublishPayload | undefined) => Promise<PublishEntryResult<TEntry>>;
     siteId: string;
     type: string;
     entryId: string;
@@ -18,7 +18,7 @@ export declare function usePublishEntryMutation<TEntry extends ContentEntrySnaps
     publishedBlocks?: readonly import("../../../api/src/index").PublishedBlockBaseline[];
 }>, Error, TPublishPayload | undefined, unknown>;
 export declare function useDiscardDraftMutation<TEntry = unknown>({ discardFn, siteId, type, entryId, isPage, pageId, }: {
-    discardFn: () => Promise<TEntry>;
+    discardFn?: () => Promise<TEntry>;
     siteId: string;
     type: string;
     entryId: string;

package/dist/_dts/content-editor/src/index.d.ts

@@ -23,6 +23,8 @@ export { PreviewTextEditor } from './primitives/PreviewTextEditor';
 export { PreviewInlineTextEditor } from './primitives/PreviewInlineTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { recordsEqual as editorValuesEqual } from './ui/stores/utils';
+export { footerModuleLabel, planFooterEditorView, type FooterEditorSectionPlan, type FooterEditorSource, type FooterEditorTarget, type FooterEditorViewPlan, } from './footerComposer';
+export { FooterComposerPanel } from './FooterComposerPanel';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
 export * from './ai/overlayHelpers';

package/dist/_dts/content-editor/src/primitives/PreviewRichTextEditor.d.ts

@@ -1,12 +1,14 @@
 import type { RichTextPrimitiveProps } from "../../../blocks/src/index";
 import type { PreviewLinkedEntryFieldBinding } from '../../../blocks/src/system/data/index';
+import { type ReactNode } from 'react';
 type PreviewRichTextEditorProps = RichTextPrimitiveProps & {
     onLinkedEntryFieldFocus?: (binding: PreviewLinkedEntryFieldBinding) => void;
     onBlockFieldFocus?: (path: string) => void;
+    renderToolbarHost?: (toolbar: ReactNode) => ReactNode;
 };
 /**
  * Memoized version to prevent unnecessary re-renders.
  * Only re-renders when path, doc, variant, or className props actually change.
  */
-export declare const PreviewRichTextEditor: import("react").MemoExoticComponent<({ path, linkedEntryField, onLinkedEntryFieldFocus, onBlockFieldFocus, className, doc, variant, placeholder, ariaLabel, }: PreviewRichTextEditorProps) => import("react").JSX.Element>;
+export declare const PreviewRichTextEditor: import("react").MemoExoticComponent<({ path, linkedEntryField, onLinkedEntryFieldFocus, onBlockFieldFocus, className, doc, as: Comp, variant, placeholder, ariaLabel, renderToolbarHost, }: PreviewRichTextEditorProps) => import("react").JSX.Element>;
 export {};

package/dist/_dts/content-editor/src/services/contentEntryServices.d.ts

@@ -1,7 +1,7 @@
-import { type ContentTypeKey, type ApiClient, type PublishedBlockBaseline } from "../../../api/src/content-editor";
-import type { ContentEntrySnapshot } from "../../../content-model/src/index";
+import { type ContentTypeKey, type ApiClient, type PublishedBlockBaseline, type RouteMetadataPayload } from '../../../api/src/content-editor';
+import type { ContentEntrySnapshot } from '../../../content-model/src/index';
 export type { ApiClient };
-export type ContentEntryServiceConfig<TResponse, TSnapshot extends ContentEntrySnapshot> = {
+export type ContentEntryServiceConfig<TResponse extends object, TSnapshot extends ContentEntrySnapshot> = {
     type: ContentTypeKey;
     siteId: string;
     entryId: string;
@@ -15,36 +15,20 @@ export type PublishEntryResult<TSnapshot extends ContentEntrySnapshot> = Readonl
     publishedContent?: Record<string, unknown> | null;
     publishedBlocks?: readonly PublishedBlockBaseline[];
 }>;
-export declare function createContentEntryServices<TResponse, TMetadataPayload extends Record<string, unknown>, TPublishPayload, TSnapshot extends ContentEntrySnapshot>(apiClient: ApiClient, config: ContentEntryServiceConfig<TResponse, TSnapshot>): {
-    saveContent(content: Record<string, unknown>): Promise<TResponse>;
-    saveMetadata(payload: TMetadataPayload): Promise<{
-        id: string;
-        siteId: string;
-        nodeId: string | null;
-        nodeType: "page" | "content_entry" | null;
-        draftTitle: string | null;
-        draftPath: string | null;
-        draftStatus: string | null;
-        publishedTitle: string | null;
-        publishedPath: string | null;
-        status: string | null;
-        publishedAt: string | null;
-        scheduledPublishAt: string | null;
-        draftMetaTitle: string | null;
-        draftMetaDescription: string | null;
-        canonicalUrl: string | null;
-        publishedMetaTitle: string | null;
-        publishedMetaDescription: string | null;
-        ogImageId: string | null;
-        draftUpdatedAt: string | null;
-        updatedBy: string | null;
-    }>;
-    publishDetailed: (payload: TPublishPayload | undefined) => Promise<{
-        snapshot: TSnapshot;
-        publishedContent: Record<string, unknown> | undefined;
-        publishedBlocks: PublishedBlockBaseline[] | undefined;
-    }>;
-    publish(payload: TPublishPayload | undefined): Promise<TSnapshot>;
-    discardDraft(): Promise<TSnapshot>;
-    deleteEntry(): Promise<void>;
-};
+type ContentEditorDraftServices<TSnapshot extends ContentEntrySnapshot = ContentEntrySnapshot, TMetadataPayload extends Record<string, unknown> = RouteMetadataPayload> = Readonly<{
+    saveContent: (content: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    saveMetadata: (payload: TMetadataPayload) => Promise<Record<string, unknown>>;
+}>;
+export type ContentEditorServices<TSnapshot extends ContentEntrySnapshot = ContentEntrySnapshot, TMetadataPayload extends Record<string, unknown> = RouteMetadataPayload> = ContentEditorDraftServices<TSnapshot, TMetadataPayload> & (Readonly<{
+    kind: 'entryLifecycle';
+    publishDetailed: (payload: unknown) => Promise<PublishEntryResult<TSnapshot>>;
+    publish: (payload: unknown) => Promise<TSnapshot>;
+    discardDraft: () => Promise<TSnapshot>;
+    deleteEntry: () => Promise<void>;
+}> | Readonly<{
+    kind: 'pageSurfaceDraft';
+}>);
+export type EntryLifecycleContentEditorServices<TSnapshot extends ContentEntrySnapshot = ContentEntrySnapshot, TMetadataPayload extends Record<string, unknown> = RouteMetadataPayload> = Extract<ContentEditorServices<TSnapshot, TMetadataPayload>, {
+    kind: 'entryLifecycle';
+}>;
+export declare function createContentEntryServices<TResponse extends object, TMetadataPayload extends Record<string, unknown>, TPublishPayload, TSnapshot extends ContentEntrySnapshot>(apiClient: ApiClient, config: ContentEntryServiceConfig<TResponse, TSnapshot>): EntryLifecycleContentEditorServices<TSnapshot, TMetadataPayload>;

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

@@ -112,6 +112,7 @@ export type EditorBlockMeta = Readonly<{
     purpose: string | null;
     orderIndex: number | null;
     publishedContent: EditorBlockValues | null;
+    optimisticHash: string | null;
 }>;
 export type EditorDraftSnapshot = EditorStructuralDraftSnapshot;
 export type DraftBlockInitMetaInput = EditorDraftBlockInitMetaInput;
@@ -127,6 +128,7 @@ export type EditorBlockItem = Readonly<{
     publishedContent?: EditorValueRecord | null;
     bindings?: EditorValueRecord | null;
     purpose?: string | null;
+    optimisticHash?: string | null;
 }>;
 type NormalizedEditorBlockBase = Readonly<{
     kind: string;
@@ -136,6 +138,7 @@ type NormalizedEditorBlockBase = Readonly<{
     publishedContent: EditorBlockValues | null;
     bindings: EditorBlockValues | null;
     purpose: string | null;
+    optimisticHash: string | null;
 }>;
 export type PersistedEditorBlockItem = EditorPersistedBlock;
 export type PendingEditorBlockItem = NormalizedEditorBlockBase & Readonly<{
@@ -226,6 +229,7 @@ export type EditorSystemOperation = {
     blockId: EditorBlockId;
     savedValues: EditorBlockValues | null;
     acknowledgedVersion: number;
+    optimisticHash: string | null;
 } | {
     type: 'autosave-draft-failed';
     blockId: EditorBlockId;
@@ -293,7 +297,7 @@ export declare function initNewDraftBlock(snapshot: EditorHistorySnapshot, block
 export declare function updateDraftBlockBaseline(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, baseline: DraftBlockBaselineInput, meta?: DraftBlockBaselineUpdateMetaInput): EditorHistorySnapshot;
 export declare function removeDraftBlock(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function setDraftPublishedBaselines(snapshot: EditorHistorySnapshot, blocks: readonly BlockPublishedBaselineInput[]): EditorHistorySnapshot;
-export declare function autosaveDraftSucceeded(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, savedValues: EditorBlockValues | null, acknowledgedVersion: number): EditorHistorySnapshot;
+export declare function autosaveDraftSucceeded(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, savedValues: EditorBlockValues | null, acknowledgedVersion: number, optimisticHash: string | null): EditorHistorySnapshot;
 export declare function autosaveDraftFailed(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, message?: string): EditorHistorySnapshot;
 export declare function clearDraftError(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function setDraftPending(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;

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/entryValidation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Entry-instance validator, compiled from the content-type field DSL.
+ *
+ * `ContentTypeSchemaZ` validates schema DOCUMENTS; this validates entry DATA
+ * against a schema: required-field presence, rejection of unfilled placeholder
+ * sentinels (shared vocabulary in `sentinels.ts`), and basic per-type shape
+ * checks. It is intentionally lightweight — enough to power scaffold diagnostics
+ * and a CLI pre-flight — not a replacement for server-side write validation.
+ */
+import type { ContentTypeSchema } from './schema';
+export type EntryValidationCode = 'missing_required' | 'unfilled_placeholder' | 'wrong_type' | 'invalid_option';
+export interface EntryValidationError {
+    /** Dotted path to the offending value (e.g. `hero.cta.link`, `items[0].label`). */
+    path: string;
+    /** The field's DSL type. */
+    fieldType: string;
+    code: EntryValidationCode;
+    message: string;
+}
+export interface EntryValidationResult {
+    valid: boolean;
+    errors: EntryValidationError[];
+}
+/**
+ * Validate entry data against a content-type schema. Returns all errors so
+ * callers can list everything an agent must fix in one pass.
+ */
+export declare function validateEntryInstance(input: {
+    schema: ContentTypeSchema;
+    data: Record<string, unknown>;
+}): EntryValidationResult;