@riverbankcms/sdk 0.109.0 → 0.118.0

package/dist/_dts/blocks/src/system/transforms/typed.d.ts

@@ -123,7 +123,7 @@ export declare function bindProp(from: string, opts?: {
     pick?: "value" | "collection" | "context";
 }): {
     readonly $bind: {
-        readonly pick?: "value" | "collection" | "context" | undefined;
+        readonly pick?: "value" | "context" | "collection" | undefined;
         readonly fallback?: {} | null | undefined;
         readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "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" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "boxStyles.cardVariantClass" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitNavSingleClass" | "layout.footerSimpleRootClass" | "layout.footerSimpleNavClass" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible">[] | undefined;
         readonly from: string;

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

@@ -1,6 +1,7 @@
+import { type ReactNode } from 'react';
 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, }: {
+export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, customFooterMode, manageLinksHref, manageSettingsHref, legalRegion, initialTarget, variant, canEdit, onSaved, loadingFallback, }: {
     apiClient: ApiClient;
     siteId: string;
     customFooterMode: 'default' | 'blocks' | 'default+blocks' | 'none';
@@ -11,4 +12,5 @@ export declare function FooterComposerPanel({ apiClient, siteId: rawSiteId, cust
     variant?: 'full' | 'sidebar';
     canEdit?: boolean;
     onSaved?: () => void;
-}): import("react").JSX.Element;
+    loadingFallback: ReactNode;
+}): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;

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

@@ -1,4 +1,4 @@
-import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
+import { type BlockItem } from '../../../editor-blocks/src/index';
 import type { EditorUiState } from '../ui/editorUiStore';
 type StoreApi<T> = {
     getState: () => T;

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

@@ -9,11 +9,27 @@ export type BlockAutosaveOptions = {
     siteId: string;
     /** Whether this entry has a route (pages have blocks, content entries don't) */
     hasRoute: boolean;
+    owner: BlockAutosaveOwner;
 };
+export type BlockAutosaveOwner = Readonly<{
+    kind: 'contentEntry';
+}> | Readonly<{
+    kind: 'pageSurface';
+}>;
+export type BlockSaveRevisionPlan = Readonly<{
+    kind: 'bestEffort';
+    optimisticHash: string | null;
+}> | Readonly<{
+    kind: 'compareAndSet';
+    optimisticHash: string;
+}> | Readonly<{
+    kind: 'missingRequiredRevision';
+}>;
+export declare function planBlockSaveRevisionForOwner(owner: BlockAutosaveOwner, optimisticHash: string | null): BlockSaveRevisionPlan;
 /**
  * Hook to handle block autosave for pages.
  * Watches for pending block changes and debounces saves to the server.
  *
  * Only enabled for pages (hasRoute=true), as content entries don't have blocks.
  */
-export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;
+export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;

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

@@ -1,7 +1,7 @@
 export type DebouncedLatestSaveHandle = {
     trigger: () => void;
     cancel: () => void;
-    flush: () => void;
+    flush: () => Promise<void>;
     isPending: () => boolean;
 };
 export type DebouncedLatestSaveConfig<TSnapshot, TPayload, TResult> = {

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

@@ -37,7 +37,7 @@ type AutosaveConfig<TValues, TPayload> = {
 export type AutosaveHandle = {
     trigger: () => void;
     cancel: () => void;
-    flush: () => void;
+    flush: () => void | Promise<void>;
     isPending: () => boolean;
 };
 export declare function useSimpleAutosave<TValues = Record<string, unknown>, TPayload = unknown>(config: AutosaveConfig<TValues, TPayload>): AutosaveHandle;

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

@@ -1,24 +1,24 @@
 export * from './registry';
 export * from './services';
-export { useDebouncedLatestSave, type DebouncedLatestSaveConfig, type DebouncedLatestSaveHandle } from './hooks/useDebouncedLatestSave';
+export { useDebouncedLatestSave, type DebouncedLatestSaveConfig, type DebouncedLatestSaveHandle, } from './hooks/useDebouncedLatestSave';
 export { useSimpleAutosave, useMultiAutosave } from './hooks/useSimpleAutosave';
-export { useStoreAutosave, type StoreAutosaveConfig, type AutosaveScope } from './hooks/useStoreAutosave';
-export { useBlockAutosave, type BlockAutosaveOptions } from './hooks/useBlockAutosave';
+export { useStoreAutosave, type StoreAutosaveConfig, type AutosaveScope, } from './hooks/useStoreAutosave';
+export { useBlockAutosave, type BlockAutosaveOptions, } from './hooks/useBlockAutosave';
 export { collectPendingLinkedEntrySaves, useLinkedEntryAutosave, type LinkedEntryAutosaveOptions, type LinkedEntrySaveResult, type PendingLinkedEntrySave, } from './hooks/useLinkedEntryAutosave';
 export { unsafeAsLinkedContentEntryId, unsafeAsLinkedContentTypeKey, type LinkedContentEntryId, type LinkedContentTypeKey, } from './linkedEntries/domain';
-export { useEntryActions, type EntryActionsOptions } from './hooks/useEntryActions';
+export { useEntryActions, type EntryActionsOptions, } from './hooks/useEntryActions';
 export { useReactiveToolbar } from './hooks/useReactiveToolbar';
-export { isInvalidSaveability, selectHasInvalidBlocks } from './hooks/invalidBlockSelectors';
+export { isInvalidSaveability, selectHasInvalidBlocks, } from './hooks/invalidBlockSelectors';
 export { useHistoryShortcuts } from './hooks/useHistoryShortcuts';
-export { validateAllBlocks, type BlockValidationError } from './hooks/validateBlocksForPublish';
+export { validateAllBlocks, type BlockValidationError, } from './hooks/validateBlocksForPublish';
 export { EntryControllerProvider, useEntryEditorController, useEntryController, useAutosave, useEntryUiStore, } from './controller/EntryControllerProvider';
 export type { EntryDraftBlockPatch, EntryDraftCompositePatch, EntryDraftsActions, EntryDraftsSlice, } from './controller/EntryControllerProvider';
 export type { EntryEditorDriver } from './controller/driver';
-export { EditableBlockProvider, useBlockData } from './components/EditableBlockProvider';
-export { ContentFieldsForm, type ContentFieldsFormProps } from './components/ContentFieldsForm';
+export { EditableBlockProvider, useBlockData, } from './components/EditableBlockProvider';
+export { ContentFieldsForm, type ContentFieldsFormProps, } from './components/ContentFieldsForm';
 export { useUISelector } from './ui/useUISelector';
-export { EditorUiStoreProvider, useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore } from './ui/editorUiStore';
-export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, EditorPreviewInspectorStore, EditorLinkedEntrySnapshot, PreviewInspection, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
+export { EditorUiStoreProvider, useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore, } from './ui/editorUiStore';
+export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, EditorPreviewInspectorStore, EditorLinkedEntrySnapshot, PreviewDesignRow, PreviewDesignOpenRequest, PreviewEditorOpenIntent, PreviewInspection, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
 export { PreviewInlineTextEditor } from './primitives/PreviewInlineTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
@@ -28,12 +28,12 @@ export { FooterComposerPanel } from './FooterComposerPanel';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
 export * from './ai/overlayHelpers';
-export { diffPaths, isUnpublishedChangesDebugEnabled } from './debug/unpublishedChangesDebug';
+export { diffPaths, isUnpublishedChangesDebugEnabled, } from './debug/unpublishedChangesDebug';
 export { listManualEntryWorkflows } from './entryWorkflows';
 export { pageWorkflowDraftContent, pageWorkflowPublishedContent, type PageWorkflowDraftSource, type PageWorkflowPublishedSource, } from './pageWorkflowContent';
 export { contentTypeEditorContentReducer, createInitialContentTypeEditorContentState, type ContentTypeEditorContentAction, type ContentTypeEditorContentState, } from './contentTypeEditorContentState';
 export { buildFooterBlocksUpdatePayload, createInitialFooterBlocksEditorState, footerBlocksEditorReducer, selectFooterBlocksPreview, selectFooterBlocksStructuralChanges, type FooterBlocksEditorBlock, type FooterBlocksEditorAction, type FooterBlocksEditorLoadResponse, type FooterBlocksEditorReadyState, type FooterBlocksEditorState, type FooterBlocksPreviewState, } from './footerBlocksEditorState';
 export { asContentEntrySnapshotSource, createContentEntriesDefinitionPlan, createPageSnapshot, createPagesDefinitionPlan, createSnapshotDefaults, getDefaultEntityLabel, mapPageRecordToSnapshot, type ContentEntriesDefinitionPlanOptions, type ContentEntryDefinitionPlan, type DefinitionServices, type PageEntrySnapshot, type PagesDefinitionPlanOptions, type SnapshotDefaults, } from './definitions/factory';
 export { canRedoHistory, canUndoHistory, createHistoryState, unsafeAsEditorBlockId, pushHistoryEntry, redoHistory, replaceHistoryPresent, undoHistory, type HistoryState, type EditorBlockId, } from './ui/editorHistory';
-export { classifyHistoryShortcut, isNativeHistoryTarget, type HistoryShortcutCommand } from './historyShortcuts';
+export { classifyHistoryShortcut, isNativeHistoryTarget, type HistoryShortcutCommand, } from './historyShortcuts';
 export type { ContentEntryControllerOptions, ContentEntryControllerState, DraftWorkflowStatus, MetadataAutosaveConfig, MetadataKindConfig, } from './types';

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

@@ -1,4 +1,4 @@
-import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
+import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorDraftSaveFailureRecovery, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
 import { type LinkedContentEntryId, type LinkedContentTypeKey } from '../linkedEntries/domain';
 export { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
 export type EditorCommand = {
@@ -234,6 +234,7 @@ export type EditorSystemOperation = {
     type: 'autosave-draft-failed';
     blockId: EditorBlockId;
     message?: string;
+    recovery?: EditorDraftSaveFailureRecovery;
 } | {
     type: 'clear-draft-error';
     blockId: EditorBlockId;
@@ -298,7 +299,7 @@ export declare function updateDraftBlockBaseline(snapshot: 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, optimisticHash: string | null): EditorHistorySnapshot;
-export declare function autosaveDraftFailed(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, message?: string): EditorHistorySnapshot;
+export declare function autosaveDraftFailed(snapshot: EditorHistorySnapshot, blockId: EditorBlockId, message?: string, recovery?: EditorDraftSaveFailureRecovery): EditorHistorySnapshot;
 export declare function clearDraftError(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function setDraftPending(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;
 export declare function clearDraftPending(snapshot: EditorHistorySnapshot, blockId: EditorBlockId): EditorHistorySnapshot;

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

@@ -1,4 +1,4 @@
-import type { FooterModuleId } from '../../../core/src/index';
+import type { EditorDraftSaveFailureRecovery, FooterModuleId } from '../../../core/src/index';
 import { type EditorUnpublishedState } from '../controller/deriveEditorUnpublishedState';
 import { type AutosaveState } from './stores/autosaveStore';
 import { type GeneratedIconAssetsState } from './stores/generatedIconAssetsStore';
@@ -18,6 +18,20 @@ export type { EditorCommand, EditorBlockItem, EditorDraftSnapshot, EditorHistory
 export type MetadataSnapshot = EditorValueSnapshot<EditorMetadataValues | null>;
 export type ContentSnapshot = EditorValueSnapshot<EditorContentValues | null>;
 export type PreviewSidebarTab = 'editor' | 'assistant';
+export type PreviewDesignRow = 'header' | 'footer' | 'header-layout' | 'header-style';
+export type PreviewEditorOpenIntent = Readonly<{
+    kind: 'design';
+    row: PreviewDesignRow;
+}> | Readonly<{
+    kind: 'footer';
+    target: 'overview' | Readonly<{
+        moduleId: FooterModuleId;
+    }>;
+}>;
+export type PreviewDesignOpenRequest = Readonly<{
+    row: PreviewDesignRow;
+    requestId: number;
+}>;
 export type ActivePreviewField = (Readonly<{
     kind: 'block';
     blockId: EditorBlockId;
@@ -153,7 +167,7 @@ export type DraftsState = {
     clearPending: (blockId: EditorBlockId) => void;
     setFailed: (blockId: EditorBlockId, message?: string) => void;
     autosaveSucceeded: (blockId: EditorBlockId, content: Record<string, unknown> | null, acknowledgement?: AutosaveAcknowledgement) => void;
-    autosaveFailed: (blockId: EditorBlockId, message?: string) => void;
+    autosaveFailed: (blockId: EditorBlockId, message?: string, recovery?: EditorDraftSaveFailureRecovery) => void;
     setAtPath: (blockId: EditorBlockId, path: string, value: unknown) => void;
     getAtPath: <T = unknown>(blockId: EditorBlockId, path: string) => T | undefined;
     updateBlockOrder: (blockIds: EditorBlockId[]) => void;
@@ -186,15 +200,16 @@ export type EditorUiState = {
     drawerOpen: boolean;
     previewSidebarTab: PreviewSidebarTab;
     previewInspection: PreviewInspection;
+    previewDesignOpenRequest: PreviewDesignOpenRequest | null;
     activePreviewField: ActivePreviewField;
     focusRequest: FocusRequest;
     activeBlockId: EditorBlockId | null;
     setDrawerOpen: (open: boolean) => void;
     setPreviewSidebarTab: (tab: PreviewSidebarTab) => void;
+    openPreviewEditor: (intent: PreviewEditorOpenIntent) => void;
+    consumePreviewDesignOpenRequest: (requestId: number) => 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-editor/src/ui/stores/autosaveStore.d.ts

@@ -24,7 +24,7 @@ export type AutosaveState = {
      * Unlike flushAllPending(), this does not rely on a debounced callback being pending, so it
      * works for manual-save mode where background triggers are disabled.
      */
-    saveNow: (types: AutosaveType[]) => void;
+    saveNow: (types: AutosaveType[]) => Promise<void>;
     flushAllPending: () => void;
     cancelAllPending: () => void;
 };

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

@@ -8,7 +8,7 @@ export type AutosaveStatus = {
 export type AutosaveHandle = {
     trigger: () => void;
     cancel?: () => void;
-    flush: () => void;
+    flush: () => void | Promise<void>;
     isPending: () => boolean;
 };
 export type AutosaveType = 'metadata' | 'content' | 'blocks' | 'linkedEntries';

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

@@ -13,29 +13,17 @@
  * together. A schema edit updates the binding type surface without a
  * parallel hand-maintained interface.
  */
+import type { RichTextDoc } from '../../../blocks/src/system/manifest/richTextSchema';
 import { COURSE_CONTENT_TYPE_SCHEMA, EVENT_CONTENT_TYPE_SCHEMA, POST_CONTENT_TYPE_SCHEMA, PRODUCT_CATEGORY_CONTENT_TYPE_SCHEMA, PRODUCT_CONTENT_TYPE_SCHEMA, TEAM_MEMBER_CONTENT_TYPE_SCHEMA, TESTIMONIAL_CONTENT_TYPE_SCHEMA } from './builtin-schemas';
 export interface ContentMediaValue {
+    identifier: string;
     url?: string;
     alt?: string;
     width?: number;
     height?: number;
     readonly [key: string]: unknown;
 }
-/**
- * Canonical rich-text content shape stored on entries. Same structural shape
- * as `TipTapNode` from `@riverbankcms/blocks/system/manifest/richTextSchema`;
- * any value validated through {@link RichTextValueSchema} satisfies this.
- */
-export interface ContentRichText {
-    type: string;
-    content?: ContentRichText[];
-    text?: string;
-    attrs?: Record<string, unknown>;
-    marks?: Array<{
-        type: string;
-        attrs?: Record<string, unknown>;
-    }>;
-}
+export type ContentRichText = RichTextDoc;
 type DerivableContentField = Readonly<{
     id: string;
     type: string;

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

@@ -28,4 +28,6 @@ export interface EntryValidationResult {
 export declare function validateEntryInstance(input: {
     schema: ContentTypeSchema;
     data: Record<string, unknown>;
+    /** Validate present values while permitting required fields to remain unset in drafts. */
+    allowIncomplete?: boolean;
 }): EntryValidationResult;

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

@@ -16,11 +16,11 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         file: "file";
         media: "media";
         reference: "reference";
+        repeater: "repeater";
         group: "group";
         datetime: "datetime";
         button: "button";
         richText: "richText";
-        repeater: "repeater";
     }>;
     label: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;

package/dist/_dts/content-model/src/templates/defaults.d.ts

@@ -1,25 +1,5 @@
 import { type TemplateDefinition } from './types';
 import type { BuiltinContentTypeKey } from '../content-types/builtins';
-/**
- * Build a canonical TipTap doc from plain-text paragraphs.
- *
- * Local mirror of `createRichTextDoc` from
- * `@riverbankcms/blocks/system/manifest/richTextSchema` — content-model
- * doesn't depend on blocks (blocks sits downstream), but the shape both
- * functions produce is governed by the same Zod schema in blocks.
- *
- * Exported with `@internal` so the cross-package parity test
- * (`packages/dummy-content/src/richTextDoc-parity.test.ts`) can import
- * the *real* implementation rather than reimplement it — eliminates the
- * "test verifies two copies of itself" failure mode.
- *
- * Returns `Record<string, unknown>` rather than the canonical
- * `RichTextDoc` type because that type lives in blocks; downstream
- * consumers narrow it via the canonical schema.
- *
- * @internal
- */
-export declare function createRichTextDocInternal(paragraphs: ReadonlyArray<string>): Record<string, unknown>;
 /**
  * Built-in content type keys that intentionally ship without a default
  * template — they use the block editor directly rather than a templated
@@ -79,7 +59,7 @@ export declare const DEFAULT_TEMPLATE_DEFINITIONS: {
             readonly content: {
                 readonly eyebrow: "Stay in the loop";
                 readonly title: "Get the latest updates";
-                readonly content: Record<string, unknown>;
+                readonly content: import("../../../core/src/index").RichTextDoc;
                 readonly ctas: readonly [{
                     readonly label: "Subscribe now";
                     readonly link: {

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

@@ -22,6 +22,19 @@ export type EditorSyncState = {
     kind: 'failed';
     error: string;
 };
+export type EditorDraftSaveFailureRecovery = Readonly<{
+    kind: 'manualRetry';
+}> | Readonly<{
+    kind: 'rebaseOnNewRevision';
+    failedOptimisticHash: string | null;
+}>;
+export type EditorDraftSyncState = Exclude<EditorSyncState, {
+    kind: 'failed';
+}> | Readonly<{
+    kind: 'failed';
+    error: string;
+    recovery: EditorDraftSaveFailureRecovery;
+}>;
 export type EditorStructuralDraftMeta = Readonly<{
     kind: string;
     purpose: string | null;
@@ -34,7 +47,7 @@ export type EditorStructuralDraftSnapshot = Readonly<{
     version: number;
     baseline: EditorBlockValues | null;
     current: EditorBlockValues | null;
-    syncState: EditorSyncState;
+    syncState: EditorDraftSyncState;
     meta: EditorStructuralDraftMeta;
 }>;
 export type EditorBlockDataRowInput = Readonly<{

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

@@ -1,8 +1,9 @@
 import type { Brand } from './branded';
+import { type RichTextDoc } from './rich-text';
 import { type Result } from './result';
 export type FooterModuleId = Brand<string, 'FooterModuleId'>;
 export type FooterMembershipKey = Brand<string, 'FooterMembershipKey'>;
-export type FooterRichText = Readonly<Record<string, unknown>>;
+export type FooterRichText = RichTextDoc;
 export type FooterNavigationRole = 'main' | 'legal-policy';
 type FooterSectionBase<TKind extends string> = Readonly<{
     id: FooterModuleId;

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

@@ -30,6 +30,7 @@ export * from './participants';
 export * from './participant-identity';
 export * from './public-url-validation';
 export * from './public-profile';
+export * from './rich-text';
 export * from './footer-composition';
 export * from './number-input';
 export * from './field-errors';

package/dist/_dts/core/src/rich-text.d.ts

@@ -0,0 +1,16 @@
+export type TipTapMark = {
+    type: string;
+    attrs?: Record<string, unknown>;
+};
+export type TipTapNode = {
+    type: string;
+    content?: TipTapNode[];
+    text?: string;
+    attrs?: Record<string, unknown>;
+    marks?: TipTapMark[];
+};
+export type RichTextDoc = {
+    type: 'doc';
+    content: TipTapNode[];
+};
+export declare function isCanonicalRichTextDoc(value: unknown): value is RichTextDoc;