@riverbankcms/sdk 0.81.0 → 0.82.0

package/dist/_dts/preview-next/src/client/preview/SiteChromeCustomizeContext.d.ts

@@ -1,9 +1,9 @@
-import { type ReactNode } from 'react';
+import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
-import type { BrandDisplayMode, FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
 import { type SiteChromeLookOption } from './siteChromeLookRows';
@@ -44,6 +44,13 @@ type SiteChromeQuickControlApplyOutcome = Readonly<{
     kind: 'skipped';
     reason: SiteChromeQuickControlHistorySkipReason | 'superseded';
 }> | SiteChromeQuickControlHistoryFailure;
+export type SiteChromeBackgroundControlState = Readonly<{
+    available: boolean;
+    current: SiteChromeBackgroundOverride;
+    currentLabel: string;
+    quickTokens: readonly SiteChromeBackgroundColorToken[];
+    advancedTokens: readonly SiteChromeBackgroundColorToken[];
+}>;
 type SiteChromeCustomizeSurfaceState = Readonly<{
     kind: 'unavailable';
 }> | Readonly<{
@@ -61,6 +68,7 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     logoSize: LogoSizePolicy;
     logoSizeOptions: readonly HeaderLogoSizeOption[];
     diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
     failure: string | null;
     applyAllowed: boolean;
 }> | Readonly<{
@@ -71,6 +79,7 @@ type SiteChromeCustomizeSurfaceState = Readonly<{
     currentLabel: string;
     options: readonly SiteChromeLookOption<FooterLookId | null>[];
     diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
     failure: string | null;
     applyAllowed: boolean;
 }>;
@@ -80,6 +89,8 @@ type SiteChromeCustomizeContextValue = Readonly<{
     cycleSurfaceLayout: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     setHeaderBrandDisplay: (value: BrandDisplayMode) => void;
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
+    cycleSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
+    chooseSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, override: SiteChromeBackgroundOverride) => void;
     siteStyleHistory: SiteStyleHistoryController;
     quickControlHistory: SiteChromeQuickControlHistoryController;
 }>;
@@ -110,6 +121,6 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
     footerSelectionContext?: Partial<FooterSelectionContext>;
     siteStyleAccess?: SiteStyleAccess;
 }>;
-export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, siteStyleAccess, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
 export {};

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
 import { type ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
@@ -37,4 +38,4 @@ export type StyleConfiguratorProps = Readonly<{
     }> | null;
     siteStyleAccess: VisibleSiteStyleAccess;
 }>;
-export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;
+export declare function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, footerSelectionContext, expandedRowRequest, siteStyleAccess, }: StyleConfiguratorProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/preview/SubrouteNoticePanel.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { SubrouteNoticeModel } from './subrouteNotice';
 type SubrouteNoticeProps = {
     model: SubrouteNoticeModel;
@@ -9,5 +10,5 @@ type SubrouteNoticeProps = {
  * Render-only — all wording and the CTA target are produced by
  * {@link resolveSubrouteNotice}.
  */
-export declare function SubrouteNotice({ model }: SubrouteNoticeProps): import("react/jsx-runtime").JSX.Element;
+export declare function SubrouteNotice({ model }: SubrouteNoticeProps): React.JSX.Element;
 export {};

package/dist/_dts/preview-next/src/client/preview/linkedEntryEditEvents.d.ts

@@ -1,5 +1,9 @@
-import type { LinkedContentEditTarget } from '../../../../blocks/src/system/data/index';
+import type { LinkedContentEditTarget, PreviewLinkedEntryFieldBinding } from '../../../../blocks/src/system/data/index';
 export declare const LINKED_ENTRY_EDIT_EVENT: "riverbank:preview:linked-entry-edit";
+export declare const LINKED_ENTRY_FIELD_FOCUS_EVENT: "riverbank:preview:linked-entry-field-focus";
 export type LinkedEntryEditEvent = CustomEvent<LinkedContentEditTarget>;
+export type LinkedEntryFieldFocusEvent = CustomEvent<PreviewLinkedEntryFieldBinding>;
 export declare function dispatchLinkedEntryEditEvent(target: LinkedContentEditTarget): void;
+export declare function dispatchLinkedEntryFieldFocusEvent(binding: PreviewLinkedEntryFieldBinding): void;
 export declare function isLinkedEntryEditEvent(event: Event): event is LinkedEntryEditEvent;
+export declare function isLinkedEntryFieldFocusEvent(event: Event): event is LinkedEntryFieldFocusEvent;

package/dist/_dts/preview-next/src/client/preview/previewChromePlacement.d.ts

@@ -17,6 +17,11 @@ export type PreviewChromeFloatingPlacement = Readonly<{
     kind: 'anchor-top-right';
     topPx: number;
     rightPx: number;
+}> | Readonly<{
+    kind: 'anchor-top-right-clamped';
+    topPx: number;
+    rightPx: number;
+    minTopPx: number;
 }> | Readonly<{
     kind: 'viewport-top-right';
     topPx: number;

package/dist/_dts/preview-next/src/client/preview/previewCustomizeControls.d.ts

@@ -1,4 +1,4 @@
-import { type KeyboardEvent, type MouseEvent, type ReactNode, type Ref } from 'react';
+import React, { type KeyboardEvent, type MouseEvent, type ReactNode, type Ref } from 'react';
 export type CustomizeControlUnavailableReason = 'single-option' | 'preview-only';
 export type CustomizeControlAvailability = Readonly<{
     kind: 'available';
@@ -31,7 +31,7 @@ export type CustomizePillButtonProps = Readonly<{
     onClick: (event: MouseEvent<HTMLButtonElement>) => void;
     disabled?: boolean;
 }>;
-export declare function CustomizePillButton({ buttonRef, ariaLabel, open, controlsId, onClick, disabled, }: CustomizePillButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function CustomizePillButton({ buttonRef, ariaLabel, open, controlsId, onClick, disabled, }: CustomizePillButtonProps): React.JSX.Element;
 export type CustomizePopoverShellProps = Readonly<{
     panelId: string;
     descriptionId: string;
@@ -45,7 +45,7 @@ export type CustomizePopoverShellProps = Readonly<{
     spacing?: 'normal' | 'compact';
     children: ReactNode;
 }>;
-export declare function CustomizePopoverShell({ panelId, descriptionId, dialogLabel, eyebrow, title, dialogRef, closeButtonRef, onClose, onKeyDown, spacing, children, }: CustomizePopoverShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function CustomizePopoverShell({ panelId, descriptionId, dialogLabel, eyebrow, title, dialogRef, closeButtonRef, onClose, onKeyDown, spacing, children, }: CustomizePopoverShellProps): React.JSX.Element;
 export type CustomizeCycleRowProps = Readonly<{
     label: string;
     valueLabel: string;
@@ -59,7 +59,7 @@ export type CustomizeCycleControlPlan = CustomizeCycleRowProps;
 export type CustomizePopoverControlPlan = Readonly<{
     cycleRows: readonly CustomizeCycleControlPlan[];
 }>;
-export declare function CustomizeCycleRow({ label, valueLabel, previousLabel, nextLabel, availability, onPrevious, onNext, }: CustomizeCycleRowProps): import("react/jsx-runtime").JSX.Element;
+export declare function CustomizeCycleRow({ label, valueLabel, previousLabel, nextLabel, availability, onPrevious, onNext, }: CustomizeCycleRowProps): React.JSX.Element;
 export declare function cycleAvailability(input: CustomizeCycleAvailabilityInput): CustomizeControlAvailability;
 export declare function cycleUnavailableReasonLabel(reason: CustomizeControlUnavailableReason): string;
 export declare function cycleAvailabilityFromFlags(input: Readonly<{

package/dist/_dts/preview-next/src/client/preview/siteChromeQuickControlHistoryState.d.ts

@@ -1,5 +1,5 @@
 import { type HistoryState } from '../../../../content-editor/src/index';
-import { type BrandDisplayMode, type FooterLookId, type LogoSizePolicy } from '../../../../theme-core/src/site-styles/index';
+import { type BrandDisplayMode, type FooterLookId, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
 type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
@@ -16,6 +16,14 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'footer-look';
     previous: FooterLookId | null;
     next: FooterLookId | null;
+}> | Readonly<{
+    kind: 'header-background';
+    previous: SiteChromeBackgroundOverride;
+    next: SiteChromeBackgroundOverride;
+}> | Readonly<{
+    kind: 'footer-background';
+    previous: SiteChromeBackgroundOverride;
+    next: SiteChromeBackgroundOverride;
 }> | Readonly<{
     kind: 'header-brand-display';
     previous: BrandDisplayMode;
@@ -28,8 +36,14 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
 export type SiteChromeQuickControlHistoryPresent = Readonly<{
     selection: SelectionSnapshot;
     headerBrandPreferences: HeaderBrandPreferences;
+    backgroundPreferences: SiteChromeBackgroundPreferences;
     entry: SiteChromeQuickControlHistoryEntry | null;
 }>;
+type SiteChromeQuickControlHistoryPresentInput = Readonly<{
+    selection: SelectionSnapshot;
+    headerBrandPreferences: HeaderBrandPreferences;
+    backgroundPreferences?: SiteChromeBackgroundPreferences;
+}>;
 export type SiteChromeQuickControlReplayPlan = Readonly<{
     kind: 'selection';
     surface: 'header' | 'footer';
@@ -37,6 +51,9 @@ export type SiteChromeQuickControlReplayPlan = Readonly<{
 }> | Readonly<{
     kind: 'brand-preferences';
     preferences: HeaderBrandPreferences;
+}> | Readonly<{
+    kind: 'background-preferences';
+    preferences: SiteChromeBackgroundPreferences;
 }>;
 export type SiteChromeQuickControlHistoryMutation = Readonly<{
     kind: 'idle';
@@ -78,17 +95,19 @@ export type SiteChromeQuickControlHistoryFailure = Readonly<{
 }>;
 export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-look';
 export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
-export declare function createSiteChromeQuickControlHistoryState(present: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>): SiteChromeQuickControlHistoryState;
+export type SiteChromeQuickControlBackgroundTarget = 'header-background' | 'footer-background';
+export declare function createSiteChromeQuickControlHistoryState(present: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;
 export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChromeQuickControlHistoryState, input: Readonly<{
     entry: SiteChromeQuickControlHistoryEntry;
-    previous?: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>;
-    persisted: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>;
+    previous?: SiteChromeQuickControlHistoryPresentInput;
+    persisted: SiteChromeQuickControlHistoryPresentInput;
 }>): SiteChromeQuickControlHistoryState;
 export declare function quickControlHistoryEntryFromSelectionChange(previous: SelectionSnapshot, next: SelectionSnapshot, target: SiteChromeQuickControlSelectionTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBrandPreferenceChange(previous: HeaderBrandPreferences, next: HeaderBrandPreferences, target: SiteChromeQuickControlBrandTarget): SiteChromeQuickControlHistoryEntry | null;
+export declare function quickControlHistoryEntryFromBackgroundPreferenceChange(previous: SiteChromeBackgroundPreferences, next: SiteChromeBackgroundPreferences, target: SiteChromeQuickControlBackgroundTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function beginSiteChromeQuickControlHistoryUndo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function beginSiteChromeQuickControlHistoryRedo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
-export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: Omit<SiteChromeQuickControlHistoryPresent, 'entry'>): SiteChromeQuickControlHistoryState;
+export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;
 export declare function rejectSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, failure: SiteChromeQuickControlHistoryFailure): SiteChromeQuickControlHistoryState;
 export declare function cancelSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, mutation: Extract<SiteChromeQuickControlHistoryMutation, {
     kind: 'undoing' | 'redoing';

package/dist/_dts/preview-next/src/client/preview/siteChromeSavePlan.d.ts

@@ -1,6 +1,6 @@
 import type { APIEndpoints } from '../../../../api/src/index';
 import type { Theme } from '../../../../blocks/src/index';
-import type { FooterSelectionContext, HeaderSelectionContext } from '../../../../theme-core/src/site-styles/index';
+import type { FooterSelectionContext, HeaderSelectionContext, SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import { type SiteStylePreviewPlan } from './siteStylePreviewPlanner';
@@ -20,10 +20,11 @@ export type BuildSiteChromeSavePlanInput = Readonly<{
     headerSelectionContext: Partial<HeaderSelectionContext> | undefined;
     footerSelectionContext: Partial<FooterSelectionContext> | undefined;
     headerBrandPreferences: HeaderBrandPreferences;
+    backgroundPreferences: SiteChromeBackgroundPreferences;
     themeId: string | null;
     selectionId: string | null;
     baseSelectionUpdatedAt: string | null;
 }>;
-export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
+export declare function buildSiteChromeSavePlan({ surface, siteStyle, selection, baseTheme, headerSelectionContext, footerSelectionContext, headerBrandPreferences, backgroundPreferences, themeId, selectionId, baseSelectionUpdatedAt, }: BuildSiteChromeSavePlanInput): SiteChromeSavePlan;
 export declare function siteChromeSavePlanBodyForBaseRevision(plan: SiteChromeSavePlan, baseSelectionUpdatedAt: string | null): SaveSiteChromeLookSelectionBody;
 export {};

package/dist/_dts/preview-next/src/client/preview/themeOverlay.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import React, { type ReactNode } from 'react';
 import type { Theme } from '../../../../blocks/src/index';
 import { type Rfc6902Op } from '../utils/rfc6902';
 type ThemePatchOp = Rfc6902Op;
@@ -32,6 +32,6 @@ type PreviewThemeOverlayContextValue = {
 export declare function PreviewThemeOverlayProvider({ baseTheme, children }: {
     baseTheme: Theme;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 export declare function usePreviewThemeOverlay(): PreviewThemeOverlayContextValue;
 export {};

package/dist/_dts/preview-next/src/client/sdk/SdkPreviewModeRuntime.d.ts

@@ -1,2 +1,3 @@
+import React from 'react';
 import type { SdkPreviewModeProps } from './SdkPreviewMode';
-export declare function SdkPreviewModeRuntime(props: SdkPreviewModeProps): import("react/jsx-runtime").JSX.Element;
+export declare function SdkPreviewModeRuntime(props: SdkPreviewModeProps): React.JSX.Element;

package/dist/_dts/preview-next/src/client/widgets/widgetOverrides.d.ts

@@ -1,19 +1,20 @@
 import { type ReactNode } from 'react';
 import type { ApiClient } from '../../../../api/src/request';
-import { type MediaAssetIndexItem, type Theme } from '../../../../blocks/src/index';
+import { type BookingOfferingPresetSummary, type MediaAssetIndexItem, type Theme } from '../../../../blocks/src/index';
 import type { FieldWidgetComponent } from '../../../../block-form/src/client/index';
 import type { SdkConfigForBlockPicker } from '../../../../editor-blocks/src/index';
 import { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters } from './widgetAdapters';
-export declare function PreviewFormProvider({ siteId: rawSiteId, theme, previewClient, bearerToken, supabaseUrl, mediaAssets, sdkConfig, children, }: {
+export declare function PreviewFormProvider({ siteId: rawSiteId, theme, previewClient, bearerToken, supabaseUrl, mediaAssets, bookingOfferingPresets, sdkConfig, children, }: {
     siteId: string;
     theme?: Theme | null;
     previewClient: ApiClient;
     bearerToken?: string | null;
     supabaseUrl?: string;
     mediaAssets?: MediaAssetIndexItem[];
+    bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     sdkConfig?: SdkConfigForBlockPicker | null;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare const previewWidgetOverrides: {
     readonly link: FieldWidgetComponent;
     readonly file: FieldWidgetComponent;
@@ -25,6 +26,7 @@ export declare const previewWidgetOverrides: {
     readonly entryPicker: FieldWidgetComponent;
     readonly iconPicker: FieldWidgetComponent;
     readonly buttonVariant: FieldWidgetComponent;
+    readonly offeringGroupOrder: FieldWidgetComponent;
     readonly siteOptionPicker: FieldWidgetComponent;
 };
 export type { FieldWidgetComponent };

package/dist/_dts/sdk/src/__mocks__/next-cache.d.ts

@@ -1,6 +1,7 @@
 /**
  * Mock implementation of next/cache for testing
  */
-export declare const revalidateTag: import("vitest").Mock<(...args: any[]) => any>;
-export declare const revalidatePath: import("vitest").Mock<(...args: any[]) => any>;
-export declare const unstable_cache: import("vitest").Mock<(fn: Function) => Function>;
+import { vi } from 'vitest';
+export declare const revalidateTag: ReturnType<typeof vi.fn<(tag: string, profile?: string) => void>>;
+export declare const revalidatePath: ReturnType<typeof vi.fn<(path: string) => void>>;
+export declare const unstable_cache: <T extends (...args: never[]) => unknown>(fn: T) => T;

package/dist/_dts/sdk/src/cli/commands/pull-dry-run.d.ts

@@ -49,7 +49,7 @@ export declare function formatHumanArrayDiff<TRemote, TLocal>(args: {
     detailText: string;
 };
 export declare function calculateThemePullDiff(args: {
-    remoteTheme: unknown | null;
+    remoteTheme: unknown;
     localTheme: LocalTheme | null;
 }): {
     type: DryRunDiffType;

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -4,7 +4,7 @@
  * Reads content from the file system for push operations.
  * Mirrors the structure created by writer.ts.
  */
-import type { NavigationLinkInput } from '../../../../api/src/index';
+import type { NavigationAuthoringLinkInput, NavigationLocalItemInput } from '../../../../api/src/navigation';
 import type { Theme } from '../../contracts';
 export interface LocalEntry {
     identifier: string;
@@ -42,20 +42,12 @@ export interface LocalPage {
 /**
  * Navigation link types for local navigation files.
  *
- * These types accept the SDK config/file dropdown sentinel. Push command
- * compilation lowers dropdown containers to linkless management inputs.
+ * These types are aligned with the shared navigation authoring boundary.
+ * SDK files may use an explicit dropdown sentinel, which is normalized
+ * before command/API management validation.
  */
-export type LocalNavigationLinkType = NavigationLinkInput | {
-    kind: 'dropdown';
-};
-export interface LocalNavigationItem {
-    label: string;
-    /** Link configuration. Required for non-dropdown items. */
-    link?: LocalNavigationLinkType;
-    /** Whether this item should render as a CTA-style navigation action. */
-    isCta?: boolean;
-    children?: LocalNavigationItem[];
-}
+export type LocalNavigationLinkType = NavigationAuthoringLinkInput;
+export type LocalNavigationItem = NavigationLocalItemInput;
 export interface LocalNavigationMenu {
     identifier?: string | null;
     name: string;

package/dist/_dts/sdk/src/cli/site-commands/commandSurfaceDispatch.d.ts

@@ -11,8 +11,8 @@ export type CommandSurfaceDispatchInput = Readonly<{
     diff: ContentDiff;
     local: LocalContent;
     client: ManagementClient;
-    blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
     customBlocks?: Parameters<typeof compilePagePushCommands>[0]['customBlocks'];
+    blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
     onEntryCommandCount?: (commandCount: number) => void;
     onFormCommandCount?: (commandCount: number) => void;
     onNavigationCommandCount?: (commandCount: number) => void;

package/dist/_dts/sdk/src/cli/site-commands/localBlockManifestResolver.d.ts

@@ -0,0 +1,31 @@
+import type { BlockFieldExtensionsMap, FieldDefinition, SdkCustomBlock } from '../../config/types';
+export type LocalBlockManifest = Readonly<{
+    name: string;
+    fields: readonly FieldDefinition[];
+}> & Record<string, unknown>;
+export type LocalBlockManifestResolution = Readonly<{
+    kind: 'builtin_found';
+    manifest: LocalBlockManifest;
+    extensionFields: readonly FieldDefinition[];
+}> | Readonly<{
+    kind: 'custom_found';
+    manifest: LocalBlockManifest;
+    extensionFields: readonly FieldDefinition[];
+}> | Readonly<{
+    kind: 'extension_only_custom_found';
+    manifest: LocalBlockManifest;
+}> | Readonly<{
+    kind: 'unknown_builtin';
+}> | Readonly<{
+    kind: 'unknown_custom';
+}>;
+export type ResolveLocalBlockManifestInput = Readonly<{
+    kind: string;
+    customBlocks?: readonly SdkCustomBlock[];
+    blockFieldExtensions?: BlockFieldExtensionsMap;
+}>;
+export type ResolveLocalBlockManifestFromSourcesInput = ResolveLocalBlockManifestInput & Readonly<{
+    builtInManifest?: LocalBlockManifest;
+}>;
+export declare function resolveLocalBlockManifest(input: ResolveLocalBlockManifestInput): LocalBlockManifestResolution;
+export declare function resolveLocalBlockManifestFromSources(input: ResolveLocalBlockManifestFromSourcesInput): LocalBlockManifestResolution;

package/dist/_dts/sdk/src/cli/site-commands/pageCommands.d.ts

@@ -29,8 +29,8 @@ export type CliPageCommandCompileInput = Readonly<{
     targetEnv: EnvTarget;
     diff: Pick<ContentDiff, 'pages'>;
     local: Pick<LocalContent, 'pages'>;
-    blockFieldExtensions?: BlockFieldExtensionsMap;
     customBlocks?: readonly SdkCustomBlock[];
+    blockFieldExtensions?: BlockFieldExtensionsMap;
 }>;
 export type CliPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject> & Readonly<{
     warnings: readonly string[];
@@ -78,7 +78,7 @@ export declare function pageCommandExecutionToReport(input: Readonly<{
 }>): PageCommandExecutionReport;
 export declare function preflightPageCommandPlanAsReport(input: Readonly<{
     compiledPlan: PageCommandCompiledPlan;
-    blockFieldExtensions?: BlockFieldExtensionsMap;
     customBlocks?: readonly SdkCustomBlock[];
+    blockFieldExtensions?: BlockFieldExtensionsMap;
 }>): PageCommandExecutionReport;
 export declare function pageCommandReportToSyncResult(report: PageCommandExecutionReport): SyncResult;

package/dist/_dts/sdk/src/cli/site-commands/pushExecution.d.ts

@@ -17,8 +17,8 @@ export type ContentPushExecutionInput = Readonly<{
     diff: ContentDiff;
     local: LocalContent;
     client: ManagementClient;
-    blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
     customBlocks?: Parameters<typeof compilePagePushCommands>[0]['customBlocks'];
+    blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
     output: OutputContext;
     onEntryCommandCount?: (commandCount: number) => void;
     onFormCommandCount?: (commandCount: number) => void;

package/dist/_dts/sdk/src/cli/sync/validation.d.ts

@@ -7,9 +7,9 @@
  * - Invalid field values (wrong types, malformed structures)
  */
 import type { FieldDefinition } from '../../config/types';
-type BlockManifest = {
-    fields: FieldDefinition[];
-} & Record<string, unknown>;
+type BlockManifest = Readonly<{
+    fields: readonly FieldDefinition[];
+}> & Record<string, unknown>;
 export interface ValidationWarning {
     type: 'unknown_field' | 'missing_required' | 'invalid_content';
     field: string;
@@ -29,7 +29,7 @@ export interface BlockValidationResult {
  * - repeater: has schema.fields (monomorphic) or itemTypes (polymorphic)
  * - tabGroup: has tabs[].fields
  */
-export declare function extractFieldIds(fields: FieldDefinition[]): Set<string>;
+export declare function extractFieldIds(fields: readonly FieldDefinition[]): Set<string>;
 /**
  * Extract required field IDs from a block manifest.
  *
@@ -37,7 +37,7 @@ export declare function extractFieldIds(fields: FieldDefinition[]): Set<string>;
  * within groups/repeaters are not validated at this level since their
  * presence depends on parent field structure.
  */
-export declare function extractRequiredFieldIds(fields: FieldDefinition[]): Set<string>;
+export declare function extractRequiredFieldIds(fields: readonly FieldDefinition[]): Set<string>;
 /**
  * Validate block content values against the manifest schema using Zod.
  *
@@ -49,7 +49,7 @@ export declare function extractRequiredFieldIds(fields: FieldDefinition[]): Set<
  * @param customFields - Optional custom fields from config (blockFieldExtensions)
  * @returns Array of validation warnings for invalid content
  */
-export declare function validateBlockContent(data: Record<string, unknown>, manifest: BlockManifest, customFields?: FieldDefinition[]): ValidationWarning[];
+export declare function validateBlockContent(data: Record<string, unknown>, manifest: BlockManifest, customFields?: readonly FieldDefinition[]): ValidationWarning[];
 /**
  * Validate block data against its manifest schema.
  *
@@ -60,7 +60,7 @@ export declare function validateBlockContent(data: Record<string, unknown>, mani
  * @param manifest - The block manifest with field definitions
  * @param customFields - Optional custom fields from config (blockFieldExtensions)
  */
-export declare function validateBlockData(data: Record<string, unknown>, manifest: BlockManifest, customFields?: FieldDefinition[]): BlockValidationResult;
+export declare function validateBlockData(data: Record<string, unknown>, manifest: BlockManifest, customFields?: readonly FieldDefinition[]): BlockValidationResult;
 /**
  * Format validation result for display.
  */

package/dist/_dts/sdk/src/client/types.d.ts

@@ -64,11 +64,26 @@ export interface GetEntriesBaseParams extends SdkMethodOptions {
     order?: 'newest' | 'oldest' | 'title' | 'manual';
     /** If true, includes draft entries (requires API key with site access) */
     preview?: boolean;
-    /** Selection mode: 'query' for automatic, 'manual' for specific entry IDs */
+    /** Selection mode: 'query' for automatic, 'manual' for specific entry refs */
     mode?: 'query' | 'manual';
-    /** Entry IDs to fetch when mode is 'manual' */
+    /** Entry UUIDs, stable identifiers, or slugs to fetch when mode is 'manual' */
     entryIds?: string[];
 }
+export type GetEntriesByIdentifiersParams = {
+    /** The site ID */
+    siteId: string;
+    /** The content type key (e.g., 'blog-post', 'meditation') */
+    contentType: string;
+    /**
+     * Stable entry references to resolve in order.
+     *
+     * Each value may be an entry UUID, `content_entries.identifier`, or route slug.
+     * Empty values are ignored and duplicate refs collapse to their first occurrence.
+     */
+    identifiers: readonly string[];
+    /** If true, includes draft entries (requires API key with site access) */
+    preview?: boolean;
+} & SdkMethodOptions;
 /**
  * Source of the data returned by a resilient fetch
  */
@@ -327,7 +342,7 @@ export interface RiverbankClient {
      * @param params.order - Sort order: 'newest' (published_at desc) or 'oldest' (published_at asc)
      * @param params.preview - If true, includes draft entries (requires API key with site access)
      * @param params.mode - 'query' for automatic fetching, 'manual' for specific entry IDs
-     * @param params.entryIds - Array of entry IDs to fetch (only used when mode is 'manual')
+     * @param params.entryIds - Array of entry refs to fetch (only used when mode is 'manual')
      * @param params.includeMeta - If true, returns pagination metadata with the response
      *
      * @example
@@ -350,7 +365,7 @@ export interface RiverbankClient {
      * });
      * // page3.entries, page3.total, page3.hasMore, page3.currentPage
      *
-     * // Fetch specific entries by ID (manual mode)
+     * // Fetch specific entries by stable refs (manual mode)
      * const specific = await client.getEntries({
      *   siteId: 'site-id',
      *   contentType: 'blog-post',
@@ -370,6 +385,23 @@ export interface RiverbankClient {
     getEntries(params: GetEntriesBaseParams & {
         includeMeta?: boolean;
     }): Promise<EntriesResponse | EntriesResponseWithMeta>;
+    /**
+     * Fetch a manually ordered set of content entries by stable refs.
+     *
+     * Refs resolve as entry UUIDs, stable entry identifiers, then route slugs. Missing
+     * refs are omitted. Returned entries preserve the order of the requested refs
+     * after empty values and duplicates are removed.
+     *
+     * @example
+     * ```ts
+     * const { entries } = await client.getEntriesByIdentifiers({
+     *   siteId: 'site-id',
+     *   contentType: 'meditation',
+     *   identifiers: ['metta-meditation', 'resting-in-compassion'],
+     * });
+     * ```
+     */
+    getEntriesByIdentifiers(params: GetEntriesByIdentifiersParams): Promise<EntriesResponse>;
     /**
      * Fetch a specific content entry by slug
      */

package/dist/_dts/sdk/src/client.d.ts

@@ -30,4 +30,4 @@ export { Page } from './rendering/components/Page';
 export type { PageProps } from './rendering/components/Page';
 export type { ContentEntryData } from './rendering/helpers/loadContent';
 export { createRiverbankClient } from './client/index';
-export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, GetEntriesByIdentifiersParams, SdkCorrelationHeaderName, SdkCorrelationHeaders, } from './client/types';

package/dist/_dts/sdk/src/config/content-types.d.ts

@@ -9,7 +9,7 @@
  */
 import type { FieldDefinition } from './field-definitions';
 import type { BlockKind } from '../types';
-import type { NavigationLinkInput } from '../public-api/contracts';
+import type { NavigationAuthoringLinkInput, NavigationConfigItemInput } from '../../../api/src/navigation';
 import type { BindingTransformName } from '../contracts/bindings';
 export type { FieldDefinition } from './field-definitions';
 export declare const TEMPLATE_BINDING_META_PATHS: readonly ["title", "slug", "publishedAt", "createdAt", "updatedAt"];
@@ -259,9 +259,7 @@ export interface EntryConfig {
 /**
  * Navigation link types for menu items.
  */
-export type NavigationLinkType = NavigationLinkInput | {
-    kind: 'dropdown';
-};
+export type NavigationLinkType = NavigationAuthoringLinkInput;
 /**
  * Navigation item definition.
  *
@@ -276,16 +274,7 @@ export type NavigationLinkType = NavigationLinkInput | {
  * }
  * ```
  */
-export interface NavigationItemConfig {
-    /** Display label */
-    label: string;
-    /** Link configuration */
-    link: NavigationLinkType;
-    /** Is this a CTA button? */
-    isCta?: boolean;
-    /** Child items (for dropdown menus, max 1 level) */
-    children?: NavigationItemConfig[];
-}
+export type NavigationItemConfig = NavigationConfigItemInput;
 /**
  * Navigation menu definition.
  *