@riverbankcms/sdk 0.108.0 → 0.111.0

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

@@ -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;
@@ -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-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;

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

@@ -0,0 +1,58 @@
+/**
+ * Entry scaffold emitter.
+ *
+ * Produces a MACHINE-READABLE template for a content type from its normalized
+ * field DSL ({@link ContentTypeSchema}): required fields are stubbed with explicit
+ * placeholder sentinels (`"<REQUIRED: text>"`, `"<REQUIRED: media-identifier>"`, …
+ * per field type, from the shared vocabulary in `sentinels.ts`), optional fields
+ * are omitted.
+ *
+ * The `diagnostics` list is derived from the entry-instance {@link
+ * validateEntryInstance} run against the emitted template, so it can never drift
+ * from what the validator actually rejects — plus a sentinel sweep so every
+ * emitted placeholder is reported even where the schema-walk can't recurse.
+ *
+ * This is NOT itself a validator: an unfilled template is not upsert-valid. The
+ * contract is: replace every placeholder with a valid value and `entry upsert`
+ * accepts the result without structural edits (enforced by the validator, used
+ * both here and as a CLI pre-flight).
+ */
+import type { ContentTypeSchema } from './schema';
+/** Which existing site resource a field points at (must exist before upsert). */
+export type ScaffoldResourceKind = 'media' | 'file' | 'reference';
+/** One required field an agent must fill before the template is upsert-valid. */
+export interface EntryScaffoldDiagnostic {
+    /** Dotted path to the field within the entry data (e.g. `hero.cta.link`). */
+    path: string;
+    /** The field's DSL type. */
+    fieldType: string;
+    /** The site resource this field references, when applicable. */
+    needsResource?: ScaffoldResourceKind;
+    /** Short instruction for the agent. */
+    message: string;
+}
+export interface EntryScaffold {
+    /** Content-type key the template was generated for. */
+    contentType: string;
+    /**
+     * Template with required fields stubbed with placeholder sentinels and optional
+     * fields omitted. Replace every sentinel with a valid value before upsert.
+     */
+    template: Record<string, unknown>;
+    /** Required fields to fill, and which of them need existing site resources. */
+    diagnostics: EntryScaffoldDiagnostic[];
+    /**
+     * True when the template contains no placeholders (the type has no required
+     * fields) — such a template can be upserted structurally as-is.
+     */
+    ready: boolean;
+}
+/**
+ * Emit a placeholder template + diagnostics for a content type from its field DSL.
+ * Diagnostics come from the entry-instance validator run against the template,
+ * merged with a sentinel sweep so no emitted placeholder goes unreported.
+ */
+export declare function buildEntryScaffold(input: {
+    key: string;
+    schema: ContentTypeSchema;
+}): EntryScaffold;

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

@@ -0,0 +1,36 @@
+/**
+ * Placeholder sentinel vocabulary — the SINGLE source of truth shared by the
+ * scaffold emitter and the entry-instance validator so the two can never drift.
+ *
+ * Every sentinel is a string of the closed form `"<REQUIRED: …>"`. The emitter
+ * produces them with {@link buildSentinel}; the validator rejects any value the
+ * shared {@link isPlaceholderSentinel} predicate recognizes. Both sides import
+ * from here, so adding a field type or changing the shape updates both at once.
+ */
+import type { ContentFieldConfig } from './schema';
+/** Leaf field types that receive a placeholder sentinel (containers recurse). */
+export declare const SENTINEL_LEAF_TYPES: readonly ["text", "textarea", "richText", "number", "date", "datetime", "url", "link", "media", "file", "boolean", "select", "reference"];
+export type SentinelLeafType = (typeof SENTINEL_LEAF_TYPES)[number];
+/** Matches the closed sentinel shape `"<REQUIRED: …>"`. */
+export declare const SENTINEL_PATTERN: RegExp;
+/**
+ * True when a value is an unfilled placeholder sentinel. Shared by the emitter
+ * (self-check) and the validator (rejection) so recognition can't drift.
+ */
+export declare function isPlaceholderSentinel(value: unknown): value is string;
+/**
+ * The placeholder sentinel for a leaf field. Container types (group/button/
+ * repeater) do not have a leaf sentinel — they expand structurally — and calling
+ * this for them returns a generic marker only for completeness.
+ */
+export declare function buildSentinel(field: ContentFieldConfig): string;
+/** A placeholder sentinel found in entry data, with its dotted path. */
+export interface UnfilledSentinel {
+    path: string;
+    value: string;
+}
+/**
+ * Deep-scan arbitrary entry data for any unfilled placeholder sentinels. Needs no
+ * schema, so it powers the CLI's pre-HTTP upsert pre-flight.
+ */
+export declare function findUnfilledSentinels(data: unknown, pathPrefix?: string): UnfilledSentinel[];

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

@@ -7,6 +7,9 @@ export * from './routeTemplate';
 export * from './definitions/canonicalizePageRouteMetadata';
 export * from './definitions/shared';
 export * from './content-types/schema';
+export * from './content-types/sentinels';
+export * from './content-types/entryValidation';
+export * from './content-types/scaffold';
 export * from './content-types/defaults';
 export * from './content-types/builtins';
 export * from './content-types/builtin-schemas';

package/dist/_dts/core/src/booking-date-time.d.ts

@@ -108,6 +108,14 @@ export declare function toScheduledBookingDateRange(input: BookingRangeFormatInp
 export declare function formatBookingInstant(isoString: string, options: BookingInstantFormatOptions): string;
 export declare function formatBookingDate(input: ScheduledBookingDateTime, format?: Intl.DateTimeFormatOptions): string;
 export declare function formatBookingTime(input: ScheduledBookingDateTime, format?: Intl.DateTimeFormatOptions): string;
+/**
+ * Formats the compact English event-time presentation used by public surfaces.
+ *
+ * This intentionally owns the lowercase day-period token and zero-minute
+ * omission instead of depending on locale-specific spacing or punctuation.
+ * Callers must only use it for an English presentation contract.
+ */
+export declare function formatBookingCompactEnglishTime(input: ScheduledBookingDateTime): string;
 export declare function formatBookingDateTime(input: ScheduledBookingDateTime, format?: Intl.DateTimeFormatOptions): string;
 export declare function formatBookingDateParts(input: ScheduledBookingDateRange, options?: Readonly<{
     dateFormat?: Intl.DateTimeFormatOptions;