@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/adapters/prod-types.d.ts

@@ -0,0 +1,546 @@
+/**
+ * PROD SHAPES — the production schema language and stored values, typed locally so the kit stays a package that could
+ * leave the repo (it may not import @bettercms-ai/types, and the dashboard's pin predates F1 / F1.x-props anyway).
+ *
+ * Mirrors the backend at F1 + F1.x-props + link objects + tags / rating / code (72ea2b68d), then reference props
+ * (73a120c50), validation parity (dd021ceba), option meta (ab15fe893), V2 chrome keys and types (98e48b9e3, 324580b2e),
+ * the V2 icon vocabulary (e126bf33d) and the localized flag (279a10490) — origin/dev 81f385ff3:
+ *   packages/types/src/content-model.ts, component.ts, link-value.ts, button-look.ts, dock-icon-names.ts, video-value.ts
+ *   src/lib/validation/schemas/content.ts (baseField, fieldUiSchema, chromeUiProblems, fieldsets, MAX_FIELD_DEPTH)
+ *   src/lib/validation/schemas/components.ts (componentPropDefSchema, subFieldSchema, propUiSchema, propValidationHardening)
+ *   src/lib/content/validation-parity.ts, src/lib/content/dock-vocabulary.ts (TAB_MAX, TAB_NAME_MAX)
+ * When the backend widens, widen these and the adapters together; the round-trip test then shrinks the lossy ledger.
+ */
+/** Field levels one schema may nest (a top-level field, or a prop, is level 1). */
+export declare const MAX_FIELD_DEPTH = 10;
+/** Tabs (`kind: "tab"` fieldsets) one screen may hold, and a tab name's length. */
+export declare const TAB_MAX = 3;
+export declare const TAB_NAME_MAX = 40;
+export declare const FIELDSETS_MAX = 30;
+export declare const FIELDSET_NAME_MAX = 60;
+export declare const FIELDSET_DESCRIPTION_MAX = 500;
+export declare const FIELD_HELP_MAX = 500;
+export declare const PROP_HELP_MAX = 200;
+export declare const PROP_PLACEHOLDER_MAX = 120;
+export declare const HELP_MORE_MAX = 2000;
+export declare const LOCK_REASON_MAX = 200;
+export declare const ITEM_LABEL_MAX = 24;
+export declare const PREVIEW_FALLBACK_MAX = 60;
+export declare const PROP_GROUP_LABEL_MAX = 32;
+export declare const PATTERN_MAX = 200;
+/** A tags value's tag length (TAG_VALUE_MAX_LENGTH), a code value's length (CODE_MAX_LENGTH), a rating's max with none set. */
+export declare const TAG_VALUE_MAX_LENGTH = 64;
+export declare const CODE_MAX_LENGTH = 100000;
+export declare const RATING_DEFAULT_MAX = 5;
+/** ratingConfigSchema: config.max a whole 1–10; (max − min) / step whole and at most this many stops. */
+export declare const RATING_MAX = 10;
+export declare const RATING_MAX_STOPS = 100;
+/** tagsConfigSchema: config.min 0–500, config.max 1–500. */
+export declare const TAGS_ITEMS_MAX = 500;
+/** A choice option's description (OPTION_DESCRIPTION_MAX): one line. */
+export declare const OPTION_DESCRIPTION_MAX = 140;
+/** config.patternMessage (PATTERN_MESSAGE_MAX), config.unit on a number (NUMBER_UNIT_MAX). */
+export declare const PATTERN_MESSAGE_MAX = 200;
+export declare const NUMBER_UNIT_MAX = 24;
+/** fieldUiSchema: ui.rows 1–40, ui.placeholder 1–120, ui.itemTitle 1–60, ui.synced.from 1–64. */
+export declare const UI_ROWS_MAX = 40;
+export declare const UI_PLACEHOLDER_MAX = 120;
+export declare const ITEM_TITLE_MAX = 60;
+export declare const SYNCED_FROM_MAX = 64;
+/** ui.itemName is an identifier: a letter, then letters, digits or _ (≤ 64). */
+export declare const ITEM_NAME_RE: RegExp;
+/** propUiSchema group: description 1–200, order 0–99. */
+export declare const PROP_GROUP_DESCRIPTION_MAX = 200;
+export declare const PROP_GROUP_ORDER_MAX = 99;
+/** propUiSchema tab: at most 8 distinct tabs per component, an id 1–40, a label ≤ TAB_NAME_MAX trimmed, order 0–99. */
+export declare const PROP_TAB_MAX = 8;
+export declare const PROP_TAB_ID_MAX = 40;
+/** numberScaleSchema: token value 1–32, label 1–24, title 1–60, css 1–60; 1–50 steps; at most 20 presets. */
+export declare const SCALE_TOKEN_VALUE_MAX = 32;
+export declare const SCALE_LABEL_MAX = 24;
+export declare const SCALE_TITLE_MAX = 60;
+export declare const SCALE_CSS_MAX = 60;
+export declare const SCALE_STEPS_MAX = 50;
+export declare const SCALE_PRESETS_MAX = 20;
+/** The video block's transcript cap (VIDEO_TRANSCRIPT_MAX). */
+export declare const VIDEO_TRANSCRIPT_MAX = 100000;
+export declare const DOCK_ICON_NAMES: readonly ["abc", "access-denied", "activity", "add", "add-circle", "add-comment", "add-document", "add-user", "address-book", "adjustments", "adjustments-horizontal", "alarm", "alert-triangle", "align-left", "api", "app-window", "apple", "apps", "archive", "arrow-back-up", "arrow-down", "arrow-guide", "arrow-left", "arrow-right", "arrow-top-right", "arrow-up", "arrows-diagonal", "arrows-down", "arrows-exchange", "arrows-horizontal", "arrows-left-right", "arrows-shuffle", "arrows-sort", "article", "aspect-ratio", "asterisk", "award", "axis-x", "backpack", "badge", "badge-cc", "badges", "bar-chart", "basket", "bell", "bill", "binary-document", "block-content", "block-element", "blockquote", "bold", "bolt", "book", "book-2", "bookmark", "bookmark-filled", "books", "bottle", "box", "brand-dribbble", "brand-facebook", "brand-instagram", "brand-linkedin", "brand-pinterest", "brand-tiktok", "brand-x", "brand-youtube", "briefcase", "broadcast", "browser", "bug", "building", "building-skyscraper", "building-store", "bulb-filled", "bulb-outline", "calculator", "calendar", "calendar-dollar", "calendar-event", "calendar-exclamation", "calendar-off", "calendar-plus", "calendar-star", "calendar-time", "camera", "campfire", "carousel-horizontal", "case", "cash", "category", "category-2", "chart-area", "chart-arrows", "chart-bar", "chart-bar-popular", "chart-donut", "chart-dots", "chart-line", "chart-upward", "check", "checkbox", "checklist", "checkmark", "checkmark-circle", "chef-hat", "chevron-down", "chevron-left", "chevron-right", "chevron-up", "chevrons-right", "circle", "circle-check", "circle-dot", "circle-number-1", "circle-plus", "click", "clipboard", "clipboard-image", "clipboard-text", "clock", "clock-check", "clock-hour-4", "close", "close-circle", "code", "code-block", "cog", "collapse", "color-wheel", "columns", "columns-2", "columns-3", "comment", "component", "compose", "compose-sparkles", "confetti", "controls", "cookie", "copy", "credit-card", "crop", "cube", "currency-dollar", "dashboard", "database", "database-search", "desktop", "device-desktop", "device-mobile", "device-tablet", "devices", "diamond", "discount", "document", "document-pdf", "document-remove", "document-sheet", "document-text", "document-video", "document-word", "document-zip", "documents", "door-exit", "dot", "double-chevron-down", "double-chevron-left", "double-chevron-right", "double-chevron-up", "double-quote", "download", "drag-handle", "drop", "droplet", "droplet-half", "earth-americas", "earth-globe", "edit", "egg", "ellipsis-horizontal", "ellipsis-vertical", "empty", "enter", "enter-right", "envelope", "equal", "error-filled", "error-outline", "error-screen", "expand", "eye-closed", "eye-off", "eye-open", "face-happy", "face-indifferent", "face-sad", "feather", "feedback", "file", "file-certificate", "file-code", "file-download", "file-text", "filter", "flag", "flame", "flask", "focus-2", "folder", "folders", "forms", "frame", "generate", "gift", "git-branch", "github", "grid-dots", "groq", "hammer", "hand-finger", "hanger", "hash", "headphones", "headset", "heart", "heart-filled", "heart-handshake", "help-circle", "highlight", "history", "home", "hourglass", "ice-cream", "id-badge", "id-badge-2", "image", "image-remove", "images", "inbox", "infinity", "info-circle", "info-filled", "info-outline", "info-square-rounded", "inline", "inline-element", "input-search", "insert-above", "insert-below", "italic", "joystick", "json", "language", "launch", "layout", "layout-align-center", "layout-board", "layout-board-split", "layout-bottombar", "layout-bottombar-expand", "layout-cards", "layout-columns", "layout-dashboard", "layout-grid", "layout-list", "layout-navbar", "layout-rows", "layout-sidebar", "layout-sidebar-right", "leaf", "leave", "lemon", "library-photo", "lifebuoy", "link", "link-removed", "linkedin", "list", "list-check", "list-details", "list-numbers", "list-tree", "lock", "logo-js", "logo-ts", "mail", "map-2", "map-pin", "map-pins", "marker", "marker-removed", "master-detail", "math-function", "meat", "menu", "message", "message-2", "message-check", "message-circle", "message-circle-2", "message-plus", "message-star", "microphone", "microphone-slash", "mobile-device", "mood-empty", "moon", "movie", "news", "notes", "number", "ok-hand", "olist", "overage", "package", "packages", "palette", "panel-left", "panel-right", "paperclip", "pause", "pencil", "phone", "photo", "photo-scan", "photo-search", "pig-money", "pin", "pin-filled", "pin-removed", "play", "player-play", "player-track-next", "playlist-add", "plug", "plug-connected", "plus-minus", "point", "presentation", "printer", "progress-50", "progress-75", "projects", "publish", "qrcode", "quote", "read-only", "receipt", "recycle", "redo", "refresh", "remove", "remove-circle", "repeat", "reset", "restore", "retrieve", "retry", "revert", "robot", "rocket", "rosette", "route", "ruler", "ruler-measure", "salad", "scale", "schema", "school", "search", "section", "select", "send", "server", "settings", "share", "shield-check", "shield-lock", "shopping-bag", "shopping-cart", "shopping-cart-plus", "signature", "sitemap", "slideshow", "sort", "sort-descending", "spacing-vertical", "sparkle", "sparkles", "speakerphone", "spinner", "split-horizontal", "split-vertical", "square", "stack", "stack-2", "stack-compact", "stairs", "stairs-up", "star", "star-filled", "stars", "stop", "strikethrough", "string", "subtask", "sun", "superscript", "sync", "table", "table-options", "tablet-device", "tag", "tags", "target", "task", "template", "tent", "terminal", "terminal-2", "text", "th-large", "th-list", "thumb-up", "thumbs-down", "thumbs-up", "ticket", "tiers", "timeline", "toggle-arrow-right", "toggle-right", "token", "tool", "tools-kitchen-2", "transfer", "translate", "trash", "trend-upward", "triangle-outline", "trolley", "truck", "truck-delivery", "truncate", "twitter", "typography", "ulist", "unarchive", "underline", "undo", "unknown", "unlink", "unlock", "unpublish", "upload", "user", "user-circle", "user-plus", "user-search", "user-star", "users", "users-group", "versions", "video", "vocabulary", "vs", "warning-filled", "warning-outline", "weight", "world", "wrench", "zoom-question"];
+export type DockIconName = (typeof DOCK_ICON_NAMES)[number];
+export declare const DOCK_ICON_NAME_SET: ReadonlySet<string>;
+export type ProdFieldType = "text" | "richtext" | "document" | "image" | "boolean" | "number" | "select" | "reference" | "multi-reference" | "multiReference" | "array" | "date" | "datetime" | "longtext" | "slug" | "email" | "phone" | "link" | "color" | "json" | "file" | "component-ref" | "modular" | "sections" | "location" | "button" | "multiselect" | "icon" | "object" | "tags" | "rating" | "code"
+/** V2 video: a URL string or `{ url, poster?, autoplay?, loop?, transcript? }` (VideoValue). */
+ | "video"
+/** Legacy input only: normalized to `array` + zones on write, still read. */
+ | "group" | "repeater";
+export type OpenMode = "inline" | "drill" | "popover" | "dialog";
+/** backend SHOW_IF_OPS (validation/schemas/content.ts). */
+export type ShowIfOp = "eq" | "neq" | "in" | "notIn" | "gt" | "lt" | "isSet" | "notEmpty" | "empty";
+export interface ShowIfRule {
+    field: string;
+    op: ShowIfOp;
+    value?: string | string[];
+}
+export interface ShowIf {
+    match: "all" | "any";
+    rules: ShowIfRule[];
+}
+export type UiLayout = "list" | "grid" | "table" | "rows" | "chips" | "gallery";
+/** ui.control (UI_CONTROLS): the leaf controls, the V2 control layouts among them. */
+export declare const UI_CONTROLS: readonly ["segmented", "slider", "rating", "dropdown", "radio", "cards", "grid", "switch", "checkbox"];
+export type UiControl = (typeof UI_CONTROLS)[number];
+/** The V2 control layouts and the types each fits (CONTROL_TYPES); segmented / slider / rating have their own rules. */
+export declare const CONTROL_TYPES: Readonly<Partial<Record<UiControl, readonly string[]>>>;
+/** A row preview: child keys or dotted paths (V2), a literal fallback, and an icon shown while there is no media. */
+export interface UiPreview {
+    title?: string;
+    subtitle?: string;
+    media?: string;
+    fallback?: string;
+    icon?: DockIconName;
+}
+export interface FieldUi {
+    collapsed?: boolean;
+    preview?: UiPreview;
+    layout?: UiLayout;
+    reorderable?: boolean;
+    control?: UiControl;
+    icon?: DockIconName;
+    itemLabel?: string;
+    /** text / longtext: the lines a text box opens with (1–40). */
+    rows?: number;
+    /** a field's placeholder when its config is strict (a prop keeps its own `placeholder`). */
+    placeholder?: string;
+    /** a list's item type: its identifier and its title (V2 `of[0].name` / `title`). */
+    itemName?: string;
+    itemTitle?: string;
+    /** the value comes from a global: an edit applies everywhere. */
+    synced?: {
+        from: string;
+    };
+    /** link / image / button: a plain string or the object. */
+    valueShape?: "string" | "object";
+    /** V2 field access (D58): the editor gates, the backend stores. */
+    access?: {
+        view?: "schema.view";
+        edit?: "schema.manage";
+    };
+    /** true = never shown in the form; false ≡ absent. */
+    hidden?: boolean;
+    /** modular: per block slug, how a row of that block type reads (V2 `of[i].icon` / `preview`). */
+    blocks?: Record<string, {
+        icon?: DockIconName;
+        preview?: UiPreview;
+    }>;
+    input?: {
+        name: string;
+        writes?: string[];
+    };
+}
+export type ScaleUnit = "px" | "%" | "rem" | "em" | "vw" | "vh";
+export interface ScaleCustomValue {
+    value: number;
+    unit: ScaleUnit;
+}
+export interface ScaleTokenStep {
+    value: string;
+    label: string;
+    title?: string;
+    px?: number;
+    css?: string;
+}
+export type ScaleBound = number | Partial<Record<ScaleUnit, number>>;
+/**
+ * A number's `config.scale` (CPO D41): a stepped range, numeric steps or token steps, units, presets, and the custom
+ * escape hatch (a boolean, or its bounds). A token scale stores the token string; a custom value `{ value, unit }`.
+ */
+export interface NumberScale {
+    steps: {
+        min: number;
+        max: number;
+        step?: number;
+    } | Array<{
+        value: number;
+        label?: string;
+    }> | ScaleTokenStep[];
+    units?: ScaleUnit[];
+    defaultUnit?: ScaleUnit;
+    allowCustom?: boolean | {
+        min?: ScaleBound;
+        max?: ScaleBound;
+        units?: ScaleUnit[];
+        step?: number;
+    };
+    presets?: Array<{
+        label?: string;
+        value: number | string | ScaleCustomValue;
+    }>;
+}
+export interface ArrayZoneConfig {
+    nonRepeatable?: ContentModelField[];
+    repeatable?: {
+        fields: ContentModelField[];
+        minItems?: number;
+        maxItems?: number;
+    };
+}
+/** One choice: a bare value, or `{ label, value }` with optional chrome (a dock icon, one line ≤ 140 under the label). */
+export interface ChoiceOption {
+    label: string;
+    value: string;
+    icon?: DockIconName;
+    description?: string;
+}
+export type SelectOption = string | ChoiceOption;
+/**
+ * A list of scalars' item settings (backend arrayItemSettingsSchema, an `array` prop's `config.item`): the V2 item field's
+ * description, locale chip, required, and a text / rich text item's length (a text item's pattern).
+ */
+export interface ArrayItemSettings {
+    helpText?: string;
+    localized?: boolean;
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    patternMessage?: string;
+}
+/** The typed keys of a field's `config` bag; the bag itself stays loose on scalar types. */
+export interface FieldConfig {
+    /** primitive array: scalars, or images, links or rich text (each item judged by its own type). */
+    itemType?: "text" | "number" | "date" | "image" | "link" | "richtext";
+    zones?: ArrayZoneConfig;
+    contentModelId?: string;
+    polymorphic?: boolean;
+    allowedModelSlugs?: string[];
+    /** reference / multi-reference (props): the non-entry targets, and a filter over the target's fields. */
+    targets?: ("page" | "form" | "collection")[];
+    filter?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    /** text / longtext: the message shown when the pattern does not match (≤ 200, needs `pattern`). */
+    patternMessage?: string;
+    /** number: the error bounds (V2 validation.min / max); they win over min / max. */
+    validation?: {
+        min?: number;
+        max?: number;
+    };
+    /** number: what it counts ("%", "USD"), 1–24 characters. */
+    unit?: string;
+    placeholder?: string;
+    includeTime?: boolean;
+    /** "site", an IANA zone name, true (the editor picks a zone) or false (none). */
+    timezone?: string | boolean;
+    blockSlugs?: string[];
+    minItems?: number;
+    maxItems?: number;
+    allowedSections?: string[];
+    componentIds?: string[];
+    /** slot (props): the V2 `of.allow` block names it takes, kept as written (backend slotAllowIssues). */
+    allow?: string[];
+    /** array (props): the item's own settings (backend arrayItemSettingsSchema). */
+    item?: ArrayItemSettings;
+    scale?: NumberScale;
+    /** multiselect: its choices; with `allowCustom` it is free tags. tags: its suggestions. */
+    options?: SelectOption[];
+    allowCustom?: boolean;
+    /** code: the language, and the languages an editor may pick (strict config, with tags' and rating's). */
+    language?: string;
+    languages?: string[];
+    /**
+     * text: "url" marks a text field the kit edits as a URL (V2 `url`). The backend keeps a text field's config as sent and
+     * enforces its minLength / maxLength / pattern, which a link field would not; it reads no other meaning into the key.
+     */
+    inputType?: "url";
+    [key: string]: unknown;
+}
+export interface ContentModelField {
+    key: string;
+    label: string;
+    type: ProdFieldType;
+    helpText?: string;
+    required?: boolean;
+    unique?: boolean;
+    defaultValue?: unknown;
+    /** select: strings or { label, value }. */
+    options?: SelectOption[];
+    config?: FieldConfig | null;
+    /** object (and legacy group / repeater): child fields. */
+    fields?: ContentModelField[];
+    openMode?: OpenMode;
+    helpMore?: string;
+    advanced?: boolean;
+    recommendedMax?: number;
+    fieldsetId?: string;
+    placement?: "cover" | "title" | "excerpt" | "body" | "inline" | "panel";
+    showIf?: ShowIf;
+    readOnly?: true | "developer";
+    lockReason?: string;
+    /** V2 per-field localization: once any field is marked, a translation owns only its localized values. */
+    localized?: boolean;
+    ui?: FieldUi;
+    searchable?: boolean;
+    [key: string]: unknown;
+}
+export type FieldsetKind = "group" | "row" | "tab";
+export interface Fieldset {
+    id: string;
+    name: string;
+    description?: string;
+    kind?: FieldsetKind;
+    icon?: DockIconName;
+    collapsed?: boolean;
+    tab?: string;
+    collapsible?: boolean;
+    columns?: 1 | 2;
+    layout?: "stack" | "breakpoints";
+}
+/** A content model as the adapters read and write it (server-owned ids and timestamps left out). */
+export interface ProdContentModel {
+    name: string;
+    slug: string;
+    description?: string;
+    kind?: "model" | "block";
+    fields: ContentModelField[];
+    fieldsets?: Fieldset[];
+}
+export declare const COMPONENT_PROP_TYPES: readonly ["text", "richtext", "image", "url", "boolean", "number", "select", "group", "table", "slot", "form", "link", "button", "date", "color", "file", "icon", "multiselect", "object", "datetime", "slug", "email", "phone", "json", "location", "tags", "rating", "code", "reference", "multi-reference", "video", "array", "longtext"];
+export type ComponentPropType = (typeof COMPONENT_PROP_TYPES)[number];
+export type ComponentSubFieldType = Exclude<ComponentPropType, "slot" | "form">;
+export declare const COMPONENT_CATEGORIES: readonly ["navbar", "footer", "button", "section", "slider", "tabs", "form", "custom", "hero", "content", "social-proof", "conversion"];
+export type ComponentCategory = (typeof COMPONENT_CATEGORIES)[number];
+export interface PropGroup {
+    id: string;
+    label?: string;
+    kind?: "group" | "row";
+    icon?: DockIconName;
+    collapsed?: boolean;
+    /** V2 fieldset keys, on the defining prop: a line under the header (≤ 200), side by side, a static header, a
+     * breakpoint switcher, and its place among the groups (0–99; absent = where its first prop sits). */
+    description?: string;
+    columns?: 1 | 2;
+    collapsible?: boolean;
+    layout?: "stack" | "breakpoints";
+    order?: number;
+}
+/**
+ * A top-level prop's tab. Defined once: the first top-level prop with an id carries its label / icon / order, later
+ * props carry `{ id }` only. A nested prop names one as `{ id }` only (tab_nested refuses a definition there; V2 and
+ * the dock ignore it); one ui.group's members share one tab.
+ */
+export interface PropTab {
+    id: string;
+    label?: string;
+    icon?: DockIconName;
+    /** its place among the tabs (0–99; absent = where its first prop sits). */
+    order?: number;
+}
+export type PropUi = FieldUi & {
+    group?: PropGroup;
+    tab?: PropTab;
+};
+export interface ComponentSubField {
+    key: string;
+    label: string;
+    type: ComponentSubFieldType;
+    defaultValue?: unknown;
+    required?: boolean;
+    /** null = no help on purpose (V2 has no description); absent = the platform's auto-help. */
+    helpText?: string | null;
+    placeholder?: string;
+    /** strings or { label, value } (subFieldOptionSchema). */
+    options?: SelectOption[];
+    helpMore?: string;
+    advanced?: boolean;
+    recommendedMax?: number;
+    /** on a table's sub-field: no two rows share it; on a list: no item repeats. */
+    unique?: boolean;
+    openMode?: OpenMode;
+    showIf?: ShowIf;
+    /** the prop's ui, inline group included (V2 fieldsets nest). */
+    ui?: PropUi;
+    readOnly?: true | "developer";
+    lockReason?: string;
+    localized?: boolean;
+    fields?: ComponentSubField[];
+    config?: {
+        fields?: ComponentSubField[];
+        options?: SelectOption[];
+    } & Record<string, unknown>;
+}
+export interface ComponentPropDef {
+    key: string;
+    label: string;
+    /**
+     * Where the override writes inside the component's blockJson. Binding, not schema: the V2 language has no twin, so
+     * fromTypeSchema leaves it unset and the host binds it (componentize lane) before the save.
+     */
+    target?: {
+        blockId: string;
+        path: string;
+    };
+    type: ComponentPropType;
+    defaultValue?: unknown;
+    required?: boolean;
+    /** null = no help on purpose (V2 has no description); absent = the platform's auto-help. */
+    helpText?: string | null;
+    placeholder?: string;
+    showIf?: ShowIf;
+    helpMore?: string;
+    advanced?: boolean;
+    recommendedMax?: number;
+    /** a list prop's items (a table's rows) distinct; refused on a top-level scalar (unique_prop_scope). */
+    unique?: boolean;
+    openMode?: OpenMode;
+    readOnly?: true | "developer";
+    lockReason?: string;
+    localized?: boolean;
+    config?: {
+        componentIds?: string[];
+        /** slot: the V2 block names it takes (`textBlock`), resolved to the project's components by the dock. */
+        allow?: string[];
+        /** array: the item's own settings. */
+        item?: ArrayItemSettings;
+        multiple?: boolean;
+        minItems?: number;
+        maxItems?: number;
+        options?: SelectOption[];
+        fields?: ComponentSubField[];
+        min?: number;
+        max?: number;
+        step?: number;
+        /** number: the error bounds (they win over min / max). */
+        validation?: {
+            min?: number;
+            max?: number;
+        };
+        /** text / url / longtext / richtext: length (richtext: its plain text). text / url / longtext: a pattern and its message. */
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        patternMessage?: string;
+        /** reference / multi-reference: the target model, or polymorphic with an allowlist of model slugs. */
+        contentModelId?: string;
+        polymorphic?: boolean;
+        allowedModelSlugs?: string[];
+        /** reference / multi-reference: page / form / collection targets (backend REF_TARGET_KINDS) and a filter over the target's fields. */
+        targets?: ("page" | "form" | "collection")[];
+        filter?: string;
+        /** array: what the list holds. */
+        itemType?: "text" | "number" | "date" | "image" | "link" | "richtext";
+        /** table with mode "types" (a polymorphic list): its item types, each row's `_type` naming one. */
+        itemTypes?: {
+            name: string;
+            label?: string;
+            fields: ComponentSubField[];
+            icon?: DockIconName;
+            preview?: UiPreview;
+        }[];
+    } & Record<string, unknown>;
+    ui?: PropUi;
+}
+/** A component as the adapters read and write it. */
+/**
+ * How ONE instance of a component reads as a row in a parent's slot list (backend `components.preview`, migration 0459;
+ * types ComponentPreview): V2's document-level `preview`. `title` / `subtitle` / `media` each name a TOP-LEVEL prop key
+ * (the API refuses any other: preview_key_unknown), `fallback` is the literal row label (trimmed, 1..120), `icon` a dock
+ * icon shown while the row has no media.
+ */
+export type ComponentPreview = UiPreview;
+/** backend componentPreviewSchema: a preview slot names a key of at most this many characters */
+export declare const COMPONENT_PREVIEW_KEY_MAX = 64;
+/** backend componentPreviewSchema: the row's literal fallback label, trimmed, at most this many characters */
+export declare const COMPONENT_PREVIEW_FALLBACK_MAX = 120;
+export interface ProdComponent {
+    name: string;
+    slug: string;
+    description?: string;
+    category?: ComponentCategory;
+    props: ComponentPropDef[];
+    preview?: ComponentPreview | null;
+    /** The component's dock icon (backend `components.icon`, dockIconSchema): V2's block icon. */
+    icon?: DockIconName | null;
+    /** The V2 tabs no top-level prop sits in (backend `components.tabs`, componentTabsSchema): declared, shown by none. */
+    tabs?: PropTab[] | null;
+}
+export declare const LINK_RELS: readonly ["nofollow", "sponsored", "ugc"];
+export type LinkRel = (typeof LINK_RELS)[number];
+export declare const LINK_VALUE_TYPES: readonly ["url", "page", "entry", "email", "phone", "anchor", "section", "file"];
+export type LinkValueType = (typeof LINK_VALUE_TYPES)[number];
+/** The F1 link object (link-value.ts). A bare href string stays valid too. */
+export interface ProdLinkValue {
+    type?: LinkValueType;
+    href: string;
+    title?: string;
+    newTab?: boolean;
+    target?: "_self" | "_blank";
+    rel?: LinkRel;
+    section?: string;
+    /** page / entry links: the target's id. */
+    ref?: string;
+}
+export declare const BUTTON_VARIANTS: readonly ["primary", "secondary", "tertiary", "brand", "dark", "light", "outline", "link"];
+export type ButtonVariant = (typeof BUTTON_VARIANTS)[number];
+export declare const BUTTON_SIZES: readonly ["sm", "md", "lg"];
+/** One button as one value (button-look.ts ButtonValue). */
+export interface ProdButtonValue {
+    label: string;
+    href: string | ProdLinkValue;
+    variant?: ButtonVariant;
+    size?: (typeof BUTTON_SIZES)[number];
+    arrow?: boolean;
+    icon?: DockIconName | null;
+    newTab?: boolean;
+    rel?: LinkRel;
+    /** Stretch across the column (backend button_full_width_invalid refuses a non-boolean a write brings). */
+    fullWidth?: boolean;
+}
+/** 0–1 fractions of the image cut from each edge. */
+export interface ProdImageCrop {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** The normalized image value (field-value-normalize.ts): other keys are dropped on write. */
+export interface ProdImageValue {
+    id?: string;
+    url: string;
+    name?: string;
+    altText?: string;
+    /** 0–1 fractions. */
+    focal?: {
+        x: number;
+        y: number;
+    };
+    crop?: ProdImageCrop;
+}
+/** The V2 video value's object form (video-value.ts): exactly the video block's props. A bare URL string is valid too. */
+export declare const VIDEO_VALUE_KEYS: readonly ["url", "poster", "autoplay", "loop", "transcript"];
+export interface ProdVideoValue {
+    url: string;
+    poster?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    transcript?: string;
+}
+/** A polymorphic reference value. */
+export interface ProdPolymorphicRef {
+    entryId: string;
+    modelSlug: string;
+}
+/**
+ * A page, form or collection pick on a prop reference that also takes entries (backend reference-target-config.ts
+ * targetRefOf): a bare string there is read as an entry id (acceptsEntries), so a non-entry pick names its kind.
+ */
+export interface ProdTargetRef {
+    kind: "page" | "form" | "collection";
+    id: string;
+}
+/** What a `form` prop stores. */
+export interface ProdFormRef {
+    formId: string;
+}