@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/_dts/blocks/src/system/blocks/event-registration.d.ts

@@ -100,28 +100,7 @@ export declare const eventRegistrationManifest: import("..").DefinedBlockManifes
         readonly multiline: false;
         readonly defaultValue: "Complete Registration";
         readonly maxLength: 40;
-    }, {
-        readonly id: "buttonVariant";
-        readonly type: "select";
-        readonly label: "Button style";
-        readonly description: "Choose a button style from your theme";
-        readonly required: false;
-        readonly multiple: false;
-        readonly defaultValue: "primary";
-        readonly options: [{
-            readonly value: "primary";
-            readonly label: "Primary";
-        }, {
-            readonly value: "secondary";
-            readonly label: "Secondary";
-        }, {
-            readonly value: "outline";
-            readonly label: "Outline";
-        }];
-        readonly ui: {
-            readonly intent: "style";
-        };
-    }];
+    }, import("../../../../block-form/src/backend/index").FieldDefinition];
 }>;
 export type EventRegistrationContent = {
     heading?: string | null;

package/dist/_dts/blocks/src/system/blocks/file-download.d.ts

@@ -5,6 +5,9 @@ export declare const fileDownloadManifest: import("..").DefinedBlockManifest<imp
     readonly title: "File Download";
     readonly titleSource: ["title", "file.filename"];
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly description: "Add a simple public download link for a document, ZIP, or audio file.";
     readonly tags: readonly ["file", "download", "document", "zip", "media"];
     readonly icon: "Download";

package/dist/_dts/blocks/src/system/blocks/form.d.ts

@@ -78,6 +78,9 @@ export declare const formManifest: import("..").DefinedBlockManifest<import(".."
         readonly paletteHidden: false;
     };
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly tags: readonly ["form", "contact", "input", "submit", "fields", "signup", "lead-capture"];
     readonly icon: "FormInput";
 }>>;

package/dist/_dts/blocks/src/system/blocks/image-gallery.d.ts

@@ -6,6 +6,9 @@ export declare const imageGalleryManifest: import("..").DefinedBlockManifest<imp
     readonly id: "block.image-gallery";
     readonly title: "Image Gallery";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly previewCustomize: {
         readonly quickFieldPriority: ["aspectRatio", "slidesToShow", "fullBleed", "marqueeSpeed", "marqueePauseOnHover"];
     };

package/dist/_dts/blocks/src/system/blocks/media-text.d.ts

@@ -31,6 +31,9 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
     readonly id: "block.media-text";
     readonly title: "Media and Text";
     readonly category: "layout";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly includeContainerStyles: true;
     readonly titleSource: "title";
     readonly previewCustomize: {

package/dist/_dts/blocks/src/system/blocks/newsletter-signup.d.ts

@@ -8,6 +8,9 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
     readonly titleSource: "title";
     readonly description: "Newsletter subscription form with configurable field presets.";
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{

package/dist/_dts/blocks/src/system/blocks/site-header.d.ts

@@ -4,6 +4,9 @@ export declare const siteHeaderManifest: import("..").DefinedBlockManifest<impor
     readonly id: "block.site-header";
     readonly title: "Site Header";
     readonly category: "layout";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly additionalFields: readonly [{
         readonly id: "mode";
         readonly type: "select";

package/dist/_dts/blocks/src/system/blocks/team-members.d.ts

@@ -13,6 +13,9 @@ export declare const teamMembersManifest: import("..").DefinedBlockManifest<impo
     readonly id: "block.team-members";
     readonly title: "Team Members";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "mixed";
+    };
     readonly titleSource: "heading";
     readonly additionalFields: readonly [import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, import("../../../../block-form/src/backend/index").FieldDefinition, {
         readonly ui: {

package/dist/_dts/blocks/src/system/blocks/testimonials.d.ts

@@ -5,6 +5,9 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
     readonly id: "block.testimonials";
     readonly title: "Testimonials";
     readonly category: "marketing";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly includeContainerStyles: true;
     readonly previewCustomize: {
         readonly quickFieldPriority: ["avatarLayout", "gridColumns", "slidesToShow", "maxEntries", "autoplay"];

package/dist/_dts/blocks/src/system/blocks/video-grid.d.ts

@@ -4,6 +4,9 @@ export declare const videoGridManifest: import("..").DefinedBlockManifest<import
     readonly id: "block.video-grid";
     readonly title: "Video Grid";
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly skipSectionStyles: true;
     readonly additionalFields: import("../../../../block-form/src/backend/index").FieldDefinition[];
     readonly layout: NodeDefinition;

package/dist/_dts/blocks/src/system/constants/background.d.ts

@@ -54,7 +54,7 @@ export declare const BACKGROUND_POSITION_PRESETS: readonly [{
     readonly value: "right bottom";
     readonly label: "Right Bottom";
 }];
-export declare const BACKGROUND_POSITION_PRESET_VALUES: ("bottom" | "left" | "right" | "top" | "center" | "right center" | "top left" | "top right" | "bottom left" | "bottom right" | "top center" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
+export declare const BACKGROUND_POSITION_PRESET_VALUES: ("left" | "right" | "bottom" | "top" | "center" | "right center" | "top center" | "top left" | "top right" | "bottom left" | "bottom right" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
 /**
  * Maps position keywords to rb-* anchor positioning classes.
  * Used for positioning scaled/overflow images within their containers.

package/dist/_dts/blocks/src/system/customize/backgrounds.d.ts

@@ -1,15 +1,14 @@
 import { type MediaAssetId } from '../../../../core/src/index';
 import { type ThemeBackgroundTextLegibilityPlan, type AppearancePresetId, type LayoutVariantKey, type PageDesignEditorBackgroundSupport } from '../../../../theme-core/src/site-styles/index';
 import type { ThemeColorToken } from '../../../../theme-core/src/tokens/index';
+import { type GradientPresetId } from '../../../../theme-core/src/gradients/index';
 import type { RenderableMediaAsset } from '../../../../media-core/src/index';
+export { isGradientPresetId, parseGradientPresetId, type GradientPresetId, } from '../../../../theme-core/src/gradients/index';
 export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
 export type BackgroundModeCycleDirection = 'prev' | 'next';
 export type BackgroundColorToken = ThemeColorToken & {
     readonly __backgroundColorTokenBrand: 'BackgroundColorToken';
 };
-export type GradientPresetId = string & {
-    readonly __brand: 'GradientPresetId';
-};
 export type BackgroundOverride = Readonly<{
     kind: 'default';
 }> | Readonly<{
@@ -31,6 +30,15 @@ export type ParsedBackgroundOverride = Readonly<{
     reason: LegacyBackgroundReason;
     background: Readonly<Record<string, unknown>>;
 }>;
+export type CanonicalSectionBackground = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'block-authored';
+    background: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    kind: 'page-design-override';
+    parsed: ParsedBackgroundOverride;
+}>;
 export type BackgroundImagePoolSource = 'current' | 'generated-ambient' | 'previous-background' | 'general-media';
 export type BackgroundImagePoolMediaAsset = RenderableMediaAsset;
 type BaseBackgroundImagePoolItem = Readonly<{
@@ -169,8 +177,6 @@ export declare function isBackgroundColorToken(value: unknown): value is Backgro
 export declare function foregroundTokenForBackgroundColorToken(token: BackgroundColorToken): string;
 export declare function planBackgroundColorTextLegibility(token: BackgroundColorToken): ThemeBackgroundTextLegibilityPlan;
 export declare function dedupeBackgroundColorTokensByPalette(tokens: readonly BackgroundColorToken[], palette: BackgroundColorPalette): readonly BackgroundColorToken[];
-export declare function parseGradientPresetId(value: unknown): GradientPresetId | null;
-export declare function isGradientPresetId(value: unknown): value is GradientPresetId;
 export declare function backgroundModeForOverride(override: BackgroundOverride): BackgroundMode;
 export declare function backgroundOverrideEquals(left: BackgroundOverride, right: BackgroundOverride): boolean;
 export declare function imagePoolForOverride(override: BackgroundOverride): readonly BackgroundImagePoolItem[];
@@ -178,6 +184,11 @@ export declare function defaultBackgroundOverrideForMode(mode: BackgroundMode, c
 export declare function resolveBackgroundCapability(input: ResolveBackgroundCapabilityInput): BackgroundCapability;
 export declare function backgroundCapabilityFromModes(modeCapabilities: readonly BackgroundModeCapability[]): BackgroundCapability;
 export declare function parseBackgroundOverrideFromContent(content: BackgroundCustomizeContent): ParsedBackgroundOverride;
+/**
+ * Classifies persisted content before runtime Look decoration is considered.
+ * Only the explicit owner marker can make a background a page-design override.
+ */
+export declare function parseCanonicalSectionBackground(content: BackgroundCustomizeContent): CanonicalSectionBackground;
 export declare function parseBackgroundOverride(value: unknown): ParsedBackgroundOverride;
 export declare function serializeBackgroundOverride(override: BackgroundOverride): Record<string, unknown> | null;
 export declare function applyBackgroundOverrideContentPatch(content: BackgroundCustomizeContent, override: BackgroundOverride): BackgroundCustomizeContent;
@@ -187,4 +198,3 @@ export declare function rankBackgroundImagePoolItems(items: readonly BackgroundI
 export declare function enabledBackgroundModes(capability: BackgroundCapability): readonly BackgroundMode[];
 export declare function backgroundColorTokensForValueCycling(capability: BackgroundCapability): readonly BackgroundColorToken[];
 export declare function canCycleBackgroundOverrideValue(override: BackgroundOverride, capability: BackgroundCapability): boolean;
-export {};

package/dist/_dts/blocks/src/system/defineBlock.d.ts

@@ -1,4 +1,4 @@
-import type { BlockManifest, BlockCategory, PreviewCustomizeManifestCuration, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
+import type { BlockManifest, BlockCategory, BlockContentSource, PreviewCustomizeManifestCuration, StyleTokenConfig, BehaviourConfig } from './manifest/schema';
 import type { NodeDefinition } from './node';
 import { type FragmentFieldConfigInput, type FragmentConfigInputOf, type FragmentDefinition } from './fragments';
 /**
@@ -72,6 +72,14 @@ export type BlockConfig = {
     previewCustomize?: PreviewCustomizeManifestCuration;
     /** Content types this block is compatible with */
     contentTypes?: readonly string[];
+    /**
+     * Explicit content-source classification for this block: whether its rendered
+     * content is authored inline, comes from content-type entries, or both.
+     * Declared per block (not inferred) and REQUIRED — a system block cannot be
+     * defined without classifying itself, and a registry-wide test double-checks
+     * the assembled manifests.
+     */
+    contentSource: BlockContentSource;
 };
 declare const BlockInput: unique symbol;
 type PickConfigProperty<C, K extends keyof BlockConfig> = K extends keyof C ? {

package/dist/_dts/blocks/src/system/fields/ctas.d.ts

@@ -7,6 +7,14 @@ type CtasOptions = {
     minItems?: number;
     maxItems?: number;
     button?: ButtonOptions;
+    /**
+     * Explicit default value for the repeater. Pass `[]` to guarantee the CTA
+     * repeater materializes with NO seeded row (see 8.1: onboarding must not leave
+     * placeholder `label:"Label"` CTA stubs). Without this the repeater still
+     * defaults to `[]` via `minItems: 0`, but declaring it makes the no-seed
+     * contract explicit and regression-proof against a future `minItems` change.
+     */
+    defaultValue?: readonly Record<string, unknown>[];
 };
 type CtasOptionId<O> = O extends {
     id: infer Id extends string;

package/dist/_dts/blocks/src/system/manifest/schema.d.ts

@@ -4845,6 +4845,29 @@ export declare const blockCategoryEnum: z.ZodEnum<{
     interactive: "interactive";
 }>;
 export type BlockCategory = z.infer<typeof blockCategoryEnum>;
+/**
+ * Explicit authoring classification of where a block's rendered content comes from.
+ *
+ * - `inline`  — all content is authored inline in the block's own fields.
+ * - `entries` — the block renders content-type entries; `contentType` names the backing type.
+ * - `mixed`   — the block has inline fields AND renders entries; `contentType` names the
+ *               backing type when a single one applies.
+ *
+ * This is EXPLICIT metadata declared on every block definition (not inferred from
+ * dataLoaders/field types), so the catalog can classify entry-backed vs inline blocks
+ * honestly. A registry-wide test asserts every registered block declares it.
+ */
+export declare const blockContentSourceKinds: readonly ["inline", "entries", "mixed"];
+export type BlockContentSourceKind = (typeof blockContentSourceKinds)[number];
+export declare const blockContentSourceSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        entries: "entries";
+        mixed: "mixed";
+        inline: "inline";
+    }>;
+    contentType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BlockContentSource = z.infer<typeof blockContentSourceSchema>;
 export declare const manifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
@@ -4939,6 +4962,14 @@ export declare const manifestSchema: z.ZodObject<{
         interactive: "interactive";
     }>>;
     contentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contentSource: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            entries: "entries";
+            mixed: "mixed";
+            inline: "inline";
+        }>;
+        contentType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     icon: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

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

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;