@bettercms-ai/types 1.51.0 → 1.53.0

package/dist/index.d.ts

@@ -4001,4 +4001,228 @@ type SectionPlanItem<B> = {
  */
 declare function planSections<B>(slots: readonly string[], blocks: readonly B[] | null | undefined): SectionPlanItem<B>[];
 
-export { type AlignToken, type AllowRule, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, BLOCK_BINDINGS, BODY_SCHEMA_ORIGINS, BREAKPOINTS, BUTTON_ACTIONS, BUTTON_FULL_WIDTH_INVALID, BUTTON_ICONS, BUTTON_ICON_NAMES, BUTTON_LOOK_KEYS, BUTTON_PLACEMENT_KEYS, BUTTON_SIZES, BUTTON_VARIANTS, type BetterCMSErrorCode, type BgToken, type BindingKind, type BlockBinding, type BlockHoverStyle, type BlockStyle, type BlockType, type BodySchema, type BodySchemaOrigin, type ButtonAction, type ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSiteLook, type ButtonSizeName, type ButtonValue, type ButtonVariant, CANVAS_GESTURE_NAMES, CODE_SLOT_PREFIX, COMPONENT_PROP_TYPES, CONTROL_HELP, type CanonicalInputDefinition, type CanvasGesture, type ChoiceOption, type CollectionBlock, type CollectionFilter, type CollectionProps, type ColorToken, type ColumnsBlock, type ColumnsProps, type Component, type ComponentBlock, type ComponentCategory, type ComponentFormPropRef, type ComponentPreview, type ComponentPropDef, type ComponentPropType, type ComponentPropUi, type ComponentProps, type ComponentSubField, type ComponentTab, type ComponentVariantGroup, type Content, type ContentBlock, type ContentEntry, type ContentModel, type ContentModelField, type ContentModelFieldType, type ContentModelFieldUi, type ContentPageResult, type ContentResponse, type ContentWidthToken, type ControlKind, type CornerToken, DIALOG_SELECTOR, DOCK_BUDGET, DOCK_ICON_NAMES, DOCK_ICON_NAME_SET, type DeepReadonly, type DeliveredLayout, type DeliveryComponent, type DeliveryEntry, type DeliveryEntrySeo, type DeliveryList, type DeliveryPage, type DerivedLocator, type DockBudget, type DockFieldLike, type DockFieldsetLike, type DockIconName, type DockInputRef, type DockLane, type DockNode, type DockPropGroupLike, type DockScreen, type ElementLike, type ExpandedBinding, FIELD_SIZE_ZOOM, FIELD_STYLE_KEYS, FOOTER_SECTION_ID, type FieldConfig, type FieldSize, type FieldStyle, type FieldStyleKey, type FieldStyles, type Fieldset, type FieldsetKind, type FieldsetUiBefore, type FontSizeToken, type FooterBlock, type FooterColumn, type FooterProps, type Form, type FormBlock, type FormField, type FormProps, type FormSubmission, HELP_MAX, type HeadingBlock, type HeadingProps, IMAGE_ASPECTS, IMAGE_FRAME_RADIUS, type ImageAspect, type ImageBlock, type ImageProps, LANDMARK_SELECTOR, LAYOUT_SECTION_ICONS, LAYOUT_SECTION_ICON_SET, LINK_RELS, LINK_VALUE_TYPES, LIST_ITEMS_CAP, LOCATOR_PATH, type LandmarkChainElement, type LandmarkElement, type LayoutComponentItem, type LayoutDataDocument, type LayoutFieldDefinition, type LayoutFieldItem, type LayoutFieldType, type LayoutScalarFieldType, type LayoutSection, type LayoutSectionIcon, type LayoutSectionItem, type LayoutStructureDocument, type LayoutZone, type LinkPairSibling, type LinkRel, type LinkValue, type LinkValueType, type LocatorGrammar, MAIN_SELECTOR, type ManagementLayoutCommand, type MediaAsset, type MediaCaptionTrack, type MediaFieldValue, NAVIGATION_SECTION_ID, type NavLink, type NavbarBlock, type NavbarProps, type NumberFieldFormat, type NumberScale, OPTION_DESCRIPTION_MAX, type OpenMode, PAGE_CONTENT_ANCHOR_ID, type Page, type PageLayoutOverrideDataDocument, type PageLayoutOverrideDocument, type PageLayoutOverrideState, type PageLayoutOverrideStructureDocument, type PageLayoutSectionOverride, type PageLayoutSectionStructureOverride, type PageMetaJson, type PageOnlyLayoutSection, type PageSectionPlacement, type PaginatedResult, type Perspective, type PortableTextDocument, type PortableTextNode, type PropGroup, type PropTab, RESPONSIVE_CSS, ROLE_HELP, ROLE_KEYS, type RadiusToken, type ReadButtonValue, type Redirect, type ReservedLayoutSection, type ResolvedLayoutNode, type RichTextBlock, type RichTextProps, SECTION_DOCTRINE, SECTION_SPACE_TOKENS, SIDE_SPACE_MIN_PX, SIDE_SPACE_TOKENS, SLOT_CHILD_KEYS, SLOT_ITEMS_CAP, SLOT_MAX_ITEMS, SPACE_BOTTOM_TOKENS, SPACE_STEP_TOKENS, type ScaleUnit, type SectionBlock, type SectionPlanItem, type SectionProps, type SectionSpaceToken, type ShadowToken, type ShowIf, type ShowIfRule, type SignInInput, type SignUpInput, type SiteSeoDefaults, type SlideItem, type SliderBlock, type SliderProps, type SlotChild, type SlotItem, type SlotShapeOptions, type SlotShapeProblem, type SlotValue, type SpaceStepToken, type SpaceToken, type SpacerBlock, type SpacerProps, TABLE_COLUMN_TYPES, TABLE_JSONLD_TYPES, TABLE_LIMITS, TABLE_RESPONSIVE, TAG_HEADS, type TabItem, type TableCell, type TableCellObject, type TableCellValue, type TableCheckOptions, type TableColumn, type TableColumnType, type TableFieldOptions, type TableFootnote, type TableGroup, type TableLink, type TableProblem, type TableRef, type TableRefResolved, type TableRow, type TableValue, type TabsBlock, type TabsProps, type TextBlock, type TextProps, type ThemeToken, type UiBefore, type UiOrigin, VIDEO_TRANSCRIPT_MAX, VIDEO_VALUE_KEYS, type VariantInputMapping, type VideoBlock, type VideoProps, type VideoValue, type VisibilityWindow, type WeightToken, type WindowState, type Workspace, type ZoneField, allowRuleOf, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, bodySchemaOf, buttonBlockProps, buttonFullWidthProblem, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonLookValue, buttonSiteLookOf, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, exampleFor, expandBlockBindings, fieldGroupOf, fieldStyleCssText, fieldStyleToCss, formatNumber, formatPropsAttribute, getBlockType, headingPaintCss, hiddenEverywhere, hideOnAttr, imageFrameCss, inWindow, isBlock, isButtonLookValue, isChromeLandmark, isCodeButton, isLinkObject, isRoleKey, isRulePaired, isScriptHref, isSlotChild, isTableValue, keyWords, landmarkRegions, linkAnchorOf, linkHref, linkRefOf, linkValueProblem, locatorFor, locatorPath, normalizeLinkValue, normalizeTableValue, normalizeWindow, parseNumberText, parsePropsAttribute, pickFieldStyle, placementBindOf, planSections, readButtonValue, readNumberFormat, readPath, regionOf, renderTableHtml, rulePartnerOf, safeCssUrl, sideFloorApplies, sideSpaceCss, slotBindOf, slotChildValues, slotItems, slotPathString, slotShapeProblems, spaceTokenCss, splitButtonStyle, tableCellText, tablePathString, tableRefCells, tableSearchText, tableToMarkdown, tableValueProblems, topFieldKeyOf, usesHideOn, videoUrlOf, videoValueProblem, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps, withExample };
+/**
+ * The V2 kit's storage contract, shared by V2 authoring (the dashboard kit) and prod validation.
+ * One home per constant: a bound the two sides kept separately is how a value got refused on one
+ * side and stored on the other (kit-facet-table.v3.md, "Carriers" and "Corpus floor").
+ */
+
+/** Tabs on one screen, the V2 target: a model's `fieldsets kind:"tab"` and a component's prop tabs alike. */
+declare const TAB_MAX = 8;
+/**
+ * The model tab bound prod accepts TODAY (src/lib/content/dock-vocabulary.ts TAB_MAX): the
+ * dashboard renders 3 tabs on a model screen. It rises to TAB_MAX when the dashboard renders 8
+ * (facet table row 7, F12). Component prop tabs are at TAB_MAX already.
+ */
+declare const TAB_MAX_RENDERABLE_NOW = 3;
+/** `ui.control:"segmented"`: the option count it stores. V2's 3 is a render-fit rule, not this. */
+declare const SEGMENTED_MIN = 2;
+declare const SEGMENTED_MAX = 8;
+/** Field / prop nesting depth. */
+declare const DEPTH_MAX = 10;
+/** Help and description caps by where the text sits. */
+declare const HELP_CAPS: {
+    readonly field: 500;
+    readonly prop: 200;
+    readonly placeholder: 120;
+    readonly helpMore: 2000;
+    readonly option: 140;
+    readonly fieldset: 500;
+    readonly propGroup: 200;
+};
+/** `config.settings` on a slot prop or a slot / modular field: at most this many setting defs. */
+declare const SLOT_SETTINGS_MAX = 12;
+/**
+ * The types a slot setting may be: one value on one block. A select's options are written inline
+ * on the setting; no reference type, since a setting never points at another record.
+ */
+declare const SLOT_SETTINGS_TYPES: readonly ["text", "slug", "select", "multiselect", "number", "rating", "date", "datetime", "boolean", "color", "icon", "link"];
+/**
+ * The field types a `kind:'block'` model may hold: the TARGET set. The kit corpus uses every one
+ * of them, so this is the bound; anything outside it is refused as out of domain.
+ */
+declare const BLOCK_FIELD_TYPES: readonly ["text", "longtext", "richtext", "image", "link", "slug", "email", "phone", "color", "select", "number", "rating", "date", "datetime", "boolean", "video", "object", "array", "reference", "file", "tags"];
+/**
+ * The staged part of BLOCK_FIELD_TYPES a block primitive renders TODAY
+ * (src/lib/sections/block-model-mapping.ts FIELD_PRIMITIVE). A type in the target set but not
+ * here is refused with `schema.block_field_unrenderable` only until its renderer ships, and then
+ * joins this list. When this equals BLOCK_FIELD_TYPES (G7), the staging is over.
+ */
+declare const BLOCK_FIELD_TYPES_RENDERABLE_NOW: readonly ["text", "longtext", "richtext", "image", "link", "slug", "email", "phone", "color", "select", "number", "rating", "date", "datetime", "boolean"];
+declare const V2_SHAPES: readonly ["block", "page", "entry", "global", "object"];
+/** What a definition IS in V2. On a model, `block` ⇔ `content_models.kind = 'block'`. */
+type V2Shape = (typeof V2_SHAPES)[number];
+declare const V2_PLACEMENTS: readonly ["inline", "section", "page"];
+/** Where a block may be placed. */
+type V2Placement = (typeof V2_PLACEMENTS)[number];
+/** The kit catalogue's categories, verbatim (dashboard src/kit/library/catalog.ts CATEGORY_ORDER). */
+declare const KIT_CATEGORIES: readonly ["Navigation & chrome", "Heroes", "Features & storytelling", "Social proof", "Media & galleries", "Commerce", "Pricing & plans", "Conversion & forms", "Listings & feeds", "Long-form & docs", "Company & people", "Events & places", "Data & interactive", "Advanced patterns"];
+type KitCategory = (typeof KIT_CATEGORIES)[number];
+/** A variant's chrome. Its slug, name and members are native; only these two are not. */
+interface V2VariantMeta {
+    icon?: DockIconName;
+    description?: string;
+}
+/** `components.v2` / `published_v2`. Category and icon are native columns. */
+interface ComponentV2 {
+    shape?: V2Shape;
+    placement?: V2Placement;
+}
+/** `content_models.v2`. Icon and preview are native (`icon`, `list_preview`). */
+interface ContentModelV2 {
+    shape?: V2Shape;
+    placement?: V2Placement;
+    category?: KitCategory;
+    /** By variant slug; the slugs themselves are the options of the model's `_variant` select. */
+    variants?: Record<string, V2VariantMeta>;
+}
+/** `component_variant_groups.v2` / `published_v2`. ORDER is the array index, like field order. */
+interface VariantGroupV2 {
+    variants?: Array<V2VariantMeta & {
+        componentId: string;
+    }>;
+}
+/** The keys each table's block may hold; validators build strict schemas from these. */
+declare const V2_KEYS: {
+    readonly components: readonly ["shape", "placement"];
+    readonly content_models: readonly ["shape", "placement", "category", "variants"];
+    readonly component_variant_groups: readonly ["variants"];
+};
+/** Who last wrote a facet, weakest first: the generator, the site's own code, an agent, a person. */
+declare const SOURCE_RANK: {
+    readonly auto: 0;
+    readonly site: 1;
+    readonly agent: 2;
+    readonly human: 3;
+};
+type SchemaSource = keyof typeof SOURCE_RANK;
+/** The facets a per-def `sources` map tracks. */
+type SourcedFacet = "ui" | "input" | "ai";
+/** A field's or prop's `sources`: server-owned, stamped on write, never taken from a client. */
+type DefSources = Partial<Record<SourcedFacet, SchemaSource>>;
+/**
+ * May `incoming` overwrite a facet `stored` last wrote? Never a weaker source over a stronger
+ * one, so a re-derive cannot undo a person's edit. Equal rank may: an agent revises its own work.
+ * An absent source is `auto`.
+ */
+declare const mayOverwrite: (stored: SchemaSource | undefined, incoming: SchemaSource) => boolean;
+declare const UI_REFUSAL_CODES: {
+    readonly schema: readonly ["facet_unclassified", "excluded_facet", "depth_exceeded", "validation_failed", "hash_mismatch", "non_finite_number", "shape_kind_mismatch", "block_field_unrenderable", "block_not_accepted", "derived_field", "feature_unknown"];
+    readonly build: readonly ["peer_missing", "kit_major_unsupported", "compile_error", "nondeterministic", "size_exceeded"];
+    readonly protocol: readonly ["unsupported", "handshake_timeout", "origin_mismatch", "write_denied"];
+    readonly runtime: readonly ["crashed", "blank", "csp_violation"];
+    readonly policy: readonly ["confirmation_required", "flag_off"];
+};
+type UiRefusalFamily = keyof typeof UI_REFUSAL_CODES;
+type UiRefusal = {
+    [F in UiRefusalFamily]: {
+        family: F;
+        code: (typeof UI_REFUSAL_CODES)[F][number];
+        message: string;
+        /** What it is about: a facet name, a field type, a path. */
+        detail?: string;
+    };
+}[UiRefusalFamily];
+/** `schema.depth_exceeded` */
+declare const uiRefusalId: (r: UiRefusal) => string;
+declare const isUiRefusal: (v: unknown) => v is UiRefusal;
+/** KEY_RESERVED, the API contract: `derived` (the Layout id prefix), `layout` and `page` (address prefixes). */
+declare const KEY_RESERVED: ReadonlySet<string>;
+/** The derive lane's minted-key bound: KEY_RESERVED and `id` (key-rules.ts RESERVED_KEYS). */
+declare const DERIVE_MINTED_RESERVED: ReadonlySet<string>;
+/** Keys that reach an object's prototype (safe-keys.ts FORBIDDEN_KEYS): also refused as KEY_RESERVED. */
+declare const KEY_FORBIDDEN: ReadonlySet<string>;
+/** A key with this lead is the platform's too (`_type`, `_key`, `_variant`): KEY_RESERVED. */
+declare const KEY_RESERVED_PREFIX = "_";
+/** KEY_FORMAT: a stored field key is a letter, then letters, digits, `-` and `_` (key-rules.ts API_KEY). */
+declare const KEY_FORMAT: RegExp;
+/** Whether the API refuses a key as KEY_RESERVED (content.ts keyRuleProblem). */
+declare const isReservedKey: (key: string) => boolean;
+/** Whether the derive lane may not mint a key (key-rules.ts isReservedKey): the API's words and `id`. */
+declare const isDeriveReservedKey: (key: string) => boolean;
+/**
+ * A primitive `array` (`config.itemType`): the item types it may list, the only config keys it may
+ * hold, and the item types an array with `zones` may not name (a list of values holds no rows).
+ * `minItems ≤ maxItems`, and both bound the primitive list only (beside `itemType`).
+ * src/lib/validation/schemas/content.ts ARRAY_ITEM_TYPES / PRIMITIVE_ARRAY_CONFIG_KEYS, in their order.
+ */
+declare const PRIMITIVE_ARRAY_RULE: {
+    readonly itemTypes: readonly ["text", "number", "date", "image", "link", "richtext"];
+    readonly configKeys: readonly ["itemType", "minItems", "maxItems", "aliases"];
+    readonly notWithZones: readonly ["image", "link", "richtext"];
+};
+declare function canonicalJson(value: unknown): string;
+/**
+ * The definition a table's `schema_hash` is taken over: what a dock UI is built against. Names,
+ * slugs and list chrome are not in it. Migration 0503's schema_hash_clear_when_stale triggers clear
+ * the hash when exactly these change.
+ */
+declare const SCHEMA_HASH_INPUTS: {
+    readonly components: readonly ["props", "tabs", "v2"];
+    readonly content_models: readonly ["fields", "fieldsets", "v2"];
+    readonly component_variant_groups: readonly ["canonicalInputs", "v2"];
+};
+type SchemaHashTable = keyof typeof SCHEMA_HASH_INPUTS;
+/**
+ * What `canonicalJson` hashes for one definition: exactly its table's inputs, so an unset key and a
+ * cleared one hash alike. `schema_hash` = "v1:" + sha256 hex of `canonicalJson(schemaHashInput(…))`.
+ */
+declare function schemaHashInput(table: SchemaHashTable, def: Readonly<Record<string, unknown>>): Record<string, unknown>;
+
+/**
+ * The rich-text features vocabulary: every name a field's `config.features` may carry.
+ *
+ * It is the ONE gate. What a field accepts (the sanitiser's elements, the Portable Text schema)
+ * is derived from it by @bettercms-ai/richtext `acceptFor`, never stored beside it. Pure and
+ * dependency-free, so richtext, the kit and the backend validation read the same list and the
+ * same alias rule, and none of them keeps a copy.
+ */
+
+/** The always-on inline marks, Lexical-era names kept as written (richtext ALWAYS_ON_FEATURES). */
+declare const RICHTEXT_MARK_FEATURES: readonly ["bold", "italic", "underline", "strikethrough", "code", "highlight"];
+/** The toggleable capabilities stored configs already name, in their order (richtext TOGGLEABLE_FEATURES). */
+declare const RICHTEXT_TOGGLE_FEATURES: readonly ["headings", "blockquote", "horizontalRule", "orderedList", "unorderedList", "checklist", "link", "internalLink", "inlineImage", "videoEmbed", "codeBlock", "table", "columns"];
+/** One feature per heading level, so a field can allow h2 and h3 without h1. */
+declare const RICHTEXT_HEADING_FEATURES: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
+/**
+ * The V2 blocks the RT steps build. With `checklist` and `columns` above, these are the nine.
+ * `embed` is the third-party providers (X, CodePen, Figma, Maps, Spotify, Podcasts, audio, Shape);
+ * `videoEmbed` stays the video, so a field can take a video without taking an X post.
+ */
+declare const RICHTEXT_BLOCK_FEATURES: readonly ["gallery", "embed", "tableOfContents", "relatedPosts", "authorBio", "footnotes", "button"];
+/** Every name a stored config may carry, in vocabulary order. */
+declare const RICHTEXT_FEATURES: readonly ["bold", "italic", "underline", "strikethrough", "code", "highlight", "headings", "blockquote", "horizontalRule", "orderedList", "unorderedList", "checklist", "link", "internalLink", "inlineImage", "videoEmbed", "codeBlock", "table", "columns", "h1", "h2", "h3", "h4", "h5", "h6", "gallery", "embed", "tableOfContents", "relatedPosts", "authorBio", "footnotes", "button"];
+type RichTextFeature = (typeof RICHTEXT_FEATURES)[number];
+/**
+ * Legacy names → the canonical features they mean. A read expands them, and a write stores the
+ * expansion, so an alias never outlives the next save. `headings` was one Lexical switch for every
+ * level; the audit (src, MCP, dashboard writers, 2026-10-24) found no other legacy name.
+ */
+declare const RICHTEXT_FEATURE_ALIASES: Record<string, readonly RichTextFeature[]>;
+/**
+ * A stored or submitted feature list in canonical form: aliases expanded (and never returned),
+ * duplicates dropped, VOCABULARY order, so two lists that mean the same thing are equal arrays.
+ * `unknown` keeps each name the vocabulary does not hold, as written and once, so a reader can
+ * log it and a writer can refuse it by name (`richtext.feature_unknown:<name>`).
+ */
+declare function normaliseRichTextFeatures(names: readonly string[]): {
+    features: RichTextFeature[];
+    unknown: string[];
+};
+/** The elements Prismic exposes (richtext CORE_ELEMENTS, in its order). */
+declare const RICHTEXT_CORE_ELEMENTS: readonly ["p", "pre", "h1", "h2", "h3", "h4", "h5", "h6", "b", "i", "link", "image", "code", "ul", "ol", "rtl"];
+/** What the platform does beyond Prismic (richtext ADVANCED_ELEMENTS, in its order). `embed` is the video. */
+declare const RICHTEXT_ADVANCED_ELEMENTS: readonly ["u", "mark", "s", "checklist", "table", "columns", "embed", "internalLink"];
+/** One element per new V2 block feature. `providerEmbed` is the `embed` feature's (the name `embed` is the video's). */
+declare const RICHTEXT_BLOCK_ELEMENTS: readonly ["gallery", "providerEmbed", "tableOfContents", "relatedPosts", "authorBio", "footnotes", "button"];
+declare const RICHTEXT_ELEMENTS: readonly ["p", "pre", "h1", "h2", "h3", "h4", "h5", "h6", "b", "i", "link", "image", "code", "ul", "ol", "rtl", "u", "mark", "s", "checklist", "table", "columns", "embed", "internalLink", "gallery", "providerEmbed", "tableOfContents", "relatedPosts", "authorBio", "footnotes", "button"];
+type RichTextElementName = (typeof RICHTEXT_ELEMENTS)[number];
+/** The rich-text refusals of the UiRefusal `schema` family. */
+type RichTextRefusalCode = "block_not_accepted" | "derived_field" | "feature_unknown";
+/**
+ * One rich-text refusal, named the same way everywhere: `message` is `richtext.<code>:<detail>`
+ * (a block's `_type`, a derived key, an unknown feature name), so a caller can show or match it.
+ */
+declare const richTextRefusal: (code: RichTextRefusalCode, detail: string) => UiRefusal;
+
+export { type AlignToken, type AllowRule, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, BLOCK_BINDINGS, BLOCK_FIELD_TYPES, BLOCK_FIELD_TYPES_RENDERABLE_NOW, BODY_SCHEMA_ORIGINS, BREAKPOINTS, BUTTON_ACTIONS, BUTTON_FULL_WIDTH_INVALID, BUTTON_ICONS, BUTTON_ICON_NAMES, BUTTON_LOOK_KEYS, BUTTON_PLACEMENT_KEYS, BUTTON_SIZES, BUTTON_VARIANTS, type BetterCMSErrorCode, type BgToken, type BindingKind, type BlockBinding, type BlockHoverStyle, type BlockStyle, type BlockType, type BodySchema, type BodySchemaOrigin, type ButtonAction, type ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSiteLook, type ButtonSizeName, type ButtonValue, type ButtonVariant, CANVAS_GESTURE_NAMES, CODE_SLOT_PREFIX, COMPONENT_PROP_TYPES, CONTROL_HELP, type CanonicalInputDefinition, type CanvasGesture, type ChoiceOption, type CollectionBlock, type CollectionFilter, type CollectionProps, type ColorToken, type ColumnsBlock, type ColumnsProps, type Component, type ComponentBlock, type ComponentCategory, type ComponentFormPropRef, type ComponentPreview, type ComponentPropDef, type ComponentPropType, type ComponentPropUi, type ComponentProps, type ComponentSubField, type ComponentTab, type ComponentV2, type ComponentVariantGroup, type Content, type ContentBlock, type ContentEntry, type ContentModel, type ContentModelField, type ContentModelFieldType, type ContentModelFieldUi, type ContentModelV2, type ContentPageResult, type ContentResponse, type ContentWidthToken, type ControlKind, type CornerToken, DEPTH_MAX, DERIVE_MINTED_RESERVED, DIALOG_SELECTOR, DOCK_BUDGET, DOCK_ICON_NAMES, DOCK_ICON_NAME_SET, type DeepReadonly, type DefSources, type DeliveredLayout, type DeliveryComponent, type DeliveryEntry, type DeliveryEntrySeo, type DeliveryList, type DeliveryPage, type DerivedLocator, type DockBudget, type DockFieldLike, type DockFieldsetLike, type DockIconName, type DockInputRef, type DockLane, type DockNode, type DockPropGroupLike, type DockScreen, type ElementLike, type ExpandedBinding, FIELD_SIZE_ZOOM, FIELD_STYLE_KEYS, FOOTER_SECTION_ID, type FieldConfig, type FieldSize, type FieldStyle, type FieldStyleKey, type FieldStyles, type Fieldset, type FieldsetKind, type FieldsetUiBefore, type FontSizeToken, type FooterBlock, type FooterColumn, type FooterProps, type Form, type FormBlock, type FormField, type FormProps, type FormSubmission, HELP_CAPS, HELP_MAX, type HeadingBlock, type HeadingProps, IMAGE_ASPECTS, IMAGE_FRAME_RADIUS, type ImageAspect, type ImageBlock, type ImageProps, KEY_FORBIDDEN, KEY_FORMAT, KEY_RESERVED, KEY_RESERVED_PREFIX, KIT_CATEGORIES, type KitCategory, LANDMARK_SELECTOR, LAYOUT_SECTION_ICONS, LAYOUT_SECTION_ICON_SET, LINK_RELS, LINK_VALUE_TYPES, LIST_ITEMS_CAP, LOCATOR_PATH, type LandmarkChainElement, type LandmarkElement, type LayoutComponentItem, type LayoutDataDocument, type LayoutFieldDefinition, type LayoutFieldItem, type LayoutFieldType, type LayoutScalarFieldType, type LayoutSection, type LayoutSectionIcon, type LayoutSectionItem, type LayoutStructureDocument, type LayoutZone, type LinkPairSibling, type LinkRel, type LinkValue, type LinkValueType, type LocatorGrammar, MAIN_SELECTOR, type ManagementLayoutCommand, type MediaAsset, type MediaCaptionTrack, type MediaFieldValue, NAVIGATION_SECTION_ID, type NavLink, type NavbarBlock, type NavbarProps, type NumberFieldFormat, type NumberScale, OPTION_DESCRIPTION_MAX, type OpenMode, PAGE_CONTENT_ANCHOR_ID, PRIMITIVE_ARRAY_RULE, type Page, type PageLayoutOverrideDataDocument, type PageLayoutOverrideDocument, type PageLayoutOverrideState, type PageLayoutOverrideStructureDocument, type PageLayoutSectionOverride, type PageLayoutSectionStructureOverride, type PageMetaJson, type PageOnlyLayoutSection, type PageSectionPlacement, type PaginatedResult, type Perspective, type PortableTextDocument, type PortableTextNode, type PropGroup, type PropTab, RESPONSIVE_CSS, RICHTEXT_ADVANCED_ELEMENTS, RICHTEXT_BLOCK_ELEMENTS, RICHTEXT_BLOCK_FEATURES, RICHTEXT_CORE_ELEMENTS, RICHTEXT_ELEMENTS, RICHTEXT_FEATURES, RICHTEXT_FEATURE_ALIASES, RICHTEXT_HEADING_FEATURES, RICHTEXT_MARK_FEATURES, RICHTEXT_TOGGLE_FEATURES, ROLE_HELP, ROLE_KEYS, type RadiusToken, type ReadButtonValue, type Redirect, type ReservedLayoutSection, type ResolvedLayoutNode, type RichTextBlock, type RichTextElementName, type RichTextFeature, type RichTextProps, type RichTextRefusalCode, SCHEMA_HASH_INPUTS, SECTION_DOCTRINE, SECTION_SPACE_TOKENS, SEGMENTED_MAX, SEGMENTED_MIN, SIDE_SPACE_MIN_PX, SIDE_SPACE_TOKENS, SLOT_CHILD_KEYS, SLOT_ITEMS_CAP, SLOT_MAX_ITEMS, SLOT_SETTINGS_MAX, SLOT_SETTINGS_TYPES, SOURCE_RANK, SPACE_BOTTOM_TOKENS, SPACE_STEP_TOKENS, type ScaleUnit, type SchemaHashTable, type SchemaSource, type SectionBlock, type SectionPlanItem, type SectionProps, type SectionSpaceToken, type ShadowToken, type ShowIf, type ShowIfRule, type SignInInput, type SignUpInput, type SiteSeoDefaults, type SlideItem, type SliderBlock, type SliderProps, type SlotChild, type SlotItem, type SlotShapeOptions, type SlotShapeProblem, type SlotValue, type SourcedFacet, type SpaceStepToken, type SpaceToken, type SpacerBlock, type SpacerProps, TABLE_COLUMN_TYPES, TABLE_JSONLD_TYPES, TABLE_LIMITS, TABLE_RESPONSIVE, TAB_MAX, TAB_MAX_RENDERABLE_NOW, TAG_HEADS, type TabItem, type TableCell, type TableCellObject, type TableCellValue, type TableCheckOptions, type TableColumn, type TableColumnType, type TableFieldOptions, type TableFootnote, type TableGroup, type TableLink, type TableProblem, type TableRef, type TableRefResolved, type TableRow, type TableValue, type TabsBlock, type TabsProps, type TextBlock, type TextProps, type ThemeToken, UI_REFUSAL_CODES, type UiBefore, type UiOrigin, type UiRefusal, type UiRefusalFamily, type V2Placement, type V2Shape, type V2VariantMeta, V2_KEYS, V2_PLACEMENTS, V2_SHAPES, VIDEO_TRANSCRIPT_MAX, VIDEO_VALUE_KEYS, type VariantGroupV2, type VariantInputMapping, type VideoBlock, type VideoProps, type VideoValue, type VisibilityWindow, type WeightToken, type WindowState, type Workspace, type ZoneField, allowRuleOf, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, bodySchemaOf, buttonBlockProps, buttonFullWidthProblem, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonLookValue, buttonSiteLookOf, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, canonicalJson, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, exampleFor, expandBlockBindings, fieldGroupOf, fieldStyleCssText, fieldStyleToCss, formatNumber, formatPropsAttribute, getBlockType, headingPaintCss, hiddenEverywhere, hideOnAttr, imageFrameCss, inWindow, isBlock, isButtonLookValue, isChromeLandmark, isCodeButton, isDeriveReservedKey, isLinkObject, isReservedKey, isRoleKey, isRulePaired, isScriptHref, isSlotChild, isTableValue, isUiRefusal, keyWords, landmarkRegions, linkAnchorOf, linkHref, linkRefOf, linkValueProblem, locatorFor, locatorPath, mayOverwrite, normaliseRichTextFeatures, normalizeLinkValue, normalizeTableValue, normalizeWindow, parseNumberText, parsePropsAttribute, pickFieldStyle, placementBindOf, planSections, readButtonValue, readNumberFormat, readPath, regionOf, renderTableHtml, richTextRefusal, rulePartnerOf, safeCssUrl, schemaHashInput, sideFloorApplies, sideSpaceCss, slotBindOf, slotChildValues, slotItems, slotPathString, slotShapeProblems, spaceTokenCss, splitButtonStyle, tableCellText, tablePathString, tableRefCells, tableSearchText, tableToMarkdown, tableValueProblems, topFieldKeyOf, uiRefusalId, usesHideOn, videoUrlOf, videoValueProblem, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps, withExample };

package/dist/index.js

@@ -4550,8 +4550,263 @@ function planSections(slots, blocks) {
   });
   return out;
 }
+
+// src/kit-v2.ts
+var TAB_MAX = 8;
+var TAB_MAX_RENDERABLE_NOW = 3;
+var SEGMENTED_MIN = 2;
+var SEGMENTED_MAX = 8;
+var DEPTH_MAX = 10;
+var HELP_CAPS = {
+  field: 500,
+  prop: 200,
+  placeholder: 120,
+  helpMore: 2e3,
+  option: OPTION_DESCRIPTION_MAX,
+  fieldset: 500,
+  propGroup: 200
+};
+var SLOT_SETTINGS_MAX = 12;
+var SLOT_SETTINGS_TYPES = [
+  "text",
+  "slug",
+  "select",
+  "multiselect",
+  "number",
+  "rating",
+  "date",
+  "datetime",
+  "boolean",
+  "color",
+  "icon",
+  "link"
+];
+var BLOCK_FIELD_TYPES = [
+  "text",
+  "longtext",
+  "richtext",
+  "image",
+  "link",
+  "slug",
+  "email",
+  "phone",
+  "color",
+  "select",
+  "number",
+  "rating",
+  "date",
+  "datetime",
+  "boolean",
+  "video",
+  "object",
+  "array",
+  "reference",
+  "file",
+  "tags"
+];
+var BLOCK_FIELD_TYPES_RENDERABLE_NOW = [
+  "text",
+  "longtext",
+  "richtext",
+  "image",
+  "link",
+  "slug",
+  "email",
+  "phone",
+  "color",
+  "select",
+  "number",
+  "rating",
+  "date",
+  "datetime",
+  "boolean"
+];
+var V2_SHAPES = ["block", "page", "entry", "global", "object"];
+var V2_PLACEMENTS = ["inline", "section", "page"];
+var KIT_CATEGORIES = [
+  "Navigation & chrome",
+  "Heroes",
+  "Features & storytelling",
+  "Social proof",
+  "Media & galleries",
+  "Commerce",
+  "Pricing & plans",
+  "Conversion & forms",
+  "Listings & feeds",
+  "Long-form & docs",
+  "Company & people",
+  "Events & places",
+  "Data & interactive",
+  "Advanced patterns"
+];
+var V2_KEYS = {
+  components: ["shape", "placement"],
+  content_models: ["shape", "placement", "category", "variants"],
+  component_variant_groups: ["variants"]
+};
+var SOURCE_RANK = { auto: 0, site: 1, agent: 2, human: 3 };
+var mayOverwrite = (stored, incoming) => SOURCE_RANK[incoming] >= SOURCE_RANK[stored ?? "auto"];
+var UI_REFUSAL_CODES = {
+  schema: [
+    "facet_unclassified",
+    "excluded_facet",
+    "depth_exceeded",
+    "validation_failed",
+    "hash_mismatch",
+    "non_finite_number",
+    "shape_kind_mismatch",
+    "block_field_unrenderable",
+    // rich text (richtext-features.ts richTextRefusal): `richtext.<code>:<detail>`
+    "block_not_accepted",
+    "derived_field",
+    "feature_unknown"
+  ],
+  build: ["peer_missing", "kit_major_unsupported", "compile_error", "nondeterministic", "size_exceeded"],
+  protocol: ["unsupported", "handshake_timeout", "origin_mismatch", "write_denied"],
+  runtime: ["crashed", "blank", "csp_violation"],
+  policy: ["confirmation_required", "flag_off"]
+};
+var uiRefusalId = (r) => `${r.family}.${r.code}`;
+var isUiRefusal = (v) => {
+  if (typeof v !== "object" || v === null) return false;
+  const { family, code, message } = v;
+  return typeof family === "string" && Object.hasOwn(UI_REFUSAL_CODES, family) && UI_REFUSAL_CODES[family].includes(code) && typeof message === "string";
+};
+var KEY_RESERVED = /* @__PURE__ */ new Set(["derived", "layout", "page"]);
+var DERIVE_MINTED_RESERVED = /* @__PURE__ */ new Set([...KEY_RESERVED, "id"]);
+var KEY_FORBIDDEN = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+var KEY_RESERVED_PREFIX = "_";
+var KEY_FORMAT = /^[A-Za-z][A-Za-z0-9_-]*$/;
+var isReservedKey = (key) => KEY_FORBIDDEN.has(key) || KEY_RESERVED.has(key) || key.startsWith(KEY_RESERVED_PREFIX);
+var isDeriveReservedKey = (key) => isReservedKey(key) || DERIVE_MINTED_RESERVED.has(key);
+var PRIMITIVE_ARRAY_RULE = {
+  itemTypes: ["text", "number", "date", "image", "link", "richtext"],
+  configKeys: ["itemType", "minItems", "maxItems", "aliases"],
+  notWithZones: ["image", "link", "richtext"]
+};
+function canonicalNumber(value) {
+  if (!Number.isFinite(value)) throw new TypeError("Canonical JSON only supports finite numbers");
+  if (Object.is(value, -0)) return "0";
+  const encoded = JSON.stringify(value);
+  const scientific = /^(-?)(\d+)(?:\.(\d+))?[eE]([+-]?\d+)$/.exec(encoded);
+  if (!scientific) return encoded;
+  const [, sign, integer, fraction = "", exponentText] = scientific;
+  const digits = `${integer}${fraction}`;
+  const decimalPoint = integer.length + Number(exponentText);
+  if (decimalPoint <= 0) return `${sign}0.${"0".repeat(-decimalPoint)}${digits}`;
+  if (decimalPoint >= digits.length) return `${sign}${digits}${"0".repeat(decimalPoint - digits.length)}`;
+  return `${sign}${digits.slice(0, decimalPoint)}.${digits.slice(decimalPoint)}`;
+}
+var skipped = (v) => v === void 0 || typeof v === "function" || typeof v === "symbol";
+function canonicalJson(value) {
+  if (value === null) return "null";
+  if (typeof value === "number") return canonicalNumber(value);
+  if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
+  if (Array.isArray(value)) return `[${value.map((child) => skipped(child) ? "null" : canonicalJson(child)).join(",")}]`;
+  if (typeof value === "object") {
+    const record = value;
+    const keys = Object.keys(record).filter((key) => !skipped(record[key])).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+  }
+  throw new TypeError(`Unsupported canonical JSON value: ${typeof value}`);
+}
+var SCHEMA_HASH_INPUTS = {
+  components: ["props", "tabs", "v2"],
+  content_models: ["fields", "fieldsets", "v2"],
+  component_variant_groups: ["canonicalInputs", "v2"]
+};
+var LIST_INPUTS = /* @__PURE__ */ new Set(["props", "fields", "canonicalInputs"]);
+function schemaHashInput(table, def) {
+  return Object.fromEntries(SCHEMA_HASH_INPUTS[table].map((k) => [k, def[k] ?? (LIST_INPUTS.has(k) ? [] : null)]));
+}
+
+// src/richtext-features.ts
+var RICHTEXT_MARK_FEATURES = ["bold", "italic", "underline", "strikethrough", "code", "highlight"];
+var RICHTEXT_TOGGLE_FEATURES = [
+  "headings",
+  "blockquote",
+  "horizontalRule",
+  "orderedList",
+  "unorderedList",
+  "checklist",
+  "link",
+  "internalLink",
+  "inlineImage",
+  "videoEmbed",
+  "codeBlock",
+  "table",
+  "columns"
+];
+var RICHTEXT_HEADING_FEATURES = ["h1", "h2", "h3", "h4", "h5", "h6"];
+var RICHTEXT_BLOCK_FEATURES = [
+  "gallery",
+  "embed",
+  "tableOfContents",
+  "relatedPosts",
+  "authorBio",
+  "footnotes",
+  "button"
+];
+var RICHTEXT_FEATURES = [
+  ...RICHTEXT_MARK_FEATURES,
+  ...RICHTEXT_TOGGLE_FEATURES,
+  ...RICHTEXT_HEADING_FEATURES,
+  ...RICHTEXT_BLOCK_FEATURES
+];
+var RICHTEXT_FEATURE_ALIASES = {
+  headings: RICHTEXT_HEADING_FEATURES
+};
+var KNOWN = new Set(RICHTEXT_FEATURES);
+var isAlias = (name) => Object.hasOwn(RICHTEXT_FEATURE_ALIASES, name);
+function normaliseRichTextFeatures(names) {
+  const want = /* @__PURE__ */ new Set();
+  const unknown = [];
+  for (const name of names) {
+    if (isAlias(name)) for (const f of RICHTEXT_FEATURE_ALIASES[name]) want.add(f);
+    else if (KNOWN.has(name)) want.add(name);
+    else if (!unknown.includes(name)) unknown.push(name);
+  }
+  return { features: RICHTEXT_FEATURES.filter((f) => want.has(f) && !isAlias(f)), unknown };
+}
+var RICHTEXT_CORE_ELEMENTS = [
+  "p",
+  "pre",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "b",
+  "i",
+  "link",
+  "image",
+  "code",
+  "ul",
+  "ol",
+  "rtl"
+];
+var RICHTEXT_ADVANCED_ELEMENTS = ["u", "mark", "s", "checklist", "table", "columns", "embed", "internalLink"];
+var RICHTEXT_BLOCK_ELEMENTS = [
+  "gallery",
+  "providerEmbed",
+  "tableOfContents",
+  "relatedPosts",
+  "authorBio",
+  "footnotes",
+  "button"
+];
+var RICHTEXT_ELEMENTS = [...RICHTEXT_CORE_ELEMENTS, ...RICHTEXT_ADVANCED_ELEMENTS, ...RICHTEXT_BLOCK_ELEMENTS];
+var richTextRefusal = (code, detail) => ({
+  family: "schema",
+  code,
+  detail,
+  message: `richtext.${code}:${detail}`
+});
 export {
   BLOCK_BINDINGS,
+  BLOCK_FIELD_TYPES,
+  BLOCK_FIELD_TYPES_RENDERABLE_NOW,
   BODY_SCHEMA_ORIGINS,
   BREAKPOINTS,
   BUTTON_ACTIONS,
@@ -4566,6 +4821,8 @@ export {
   CODE_SLOT_PREFIX,
   COMPONENT_PROP_TYPES,
   CONTROL_HELP,
+  DEPTH_MAX,
+  DERIVE_MINTED_RESERVED,
   DIALOG_SELECTOR,
   DOCK_BUDGET,
   DOCK_ICON_NAMES,
@@ -4573,9 +4830,15 @@ export {
   FIELD_SIZE_ZOOM,
   FIELD_STYLE_KEYS,
   FOOTER_SECTION_ID,
+  HELP_CAPS,
   HELP_MAX,
   IMAGE_ASPECTS,
   IMAGE_FRAME_RADIUS,
+  KEY_FORBIDDEN,
+  KEY_FORMAT,
+  KEY_RESERVED,
+  KEY_RESERVED_PREFIX,
+  KIT_CATEGORIES,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
   LAYOUT_SECTION_ICON_SET,
@@ -4587,23 +4850,46 @@ export {
   NAVIGATION_SECTION_ID,
   OPTION_DESCRIPTION_MAX,
   PAGE_CONTENT_ANCHOR_ID,
+  PRIMITIVE_ARRAY_RULE,
   RESPONSIVE_CSS,
+  RICHTEXT_ADVANCED_ELEMENTS,
+  RICHTEXT_BLOCK_ELEMENTS,
+  RICHTEXT_BLOCK_FEATURES,
+  RICHTEXT_CORE_ELEMENTS,
+  RICHTEXT_ELEMENTS,
+  RICHTEXT_FEATURES,
+  RICHTEXT_FEATURE_ALIASES,
+  RICHTEXT_HEADING_FEATURES,
+  RICHTEXT_MARK_FEATURES,
+  RICHTEXT_TOGGLE_FEATURES,
   ROLE_HELP,
   ROLE_KEYS,
+  SCHEMA_HASH_INPUTS,
   SECTION_DOCTRINE,
   SECTION_SPACE_TOKENS,
+  SEGMENTED_MAX,
+  SEGMENTED_MIN,
   SIDE_SPACE_MIN_PX,
   SIDE_SPACE_TOKENS,
   SLOT_CHILD_KEYS,
   SLOT_ITEMS_CAP,
   SLOT_MAX_ITEMS,
+  SLOT_SETTINGS_MAX,
+  SLOT_SETTINGS_TYPES,
+  SOURCE_RANK,
   SPACE_BOTTOM_TOKENS,
   SPACE_STEP_TOKENS,
   TABLE_COLUMN_TYPES,
   TABLE_JSONLD_TYPES,
   TABLE_LIMITS,
   TABLE_RESPONSIVE,
+  TAB_MAX,
+  TAB_MAX_RENDERABLE_NOW,
   TAG_HEADS,
+  UI_REFUSAL_CODES,
+  V2_KEYS,
+  V2_PLACEMENTS,
+  V2_SHAPES,
   VIDEO_TRANSCRIPT_MAX,
   VIDEO_VALUE_KEYS,
   allowRuleOf,
@@ -4623,6 +4909,7 @@ export {
   buttonValueProblem,
   buttonVariantOf,
   candidateRole,
+  canonicalJson,
   componentInstanceAddresses,
   componentPropTargetKey,
   derivedPairs,
@@ -4645,12 +4932,15 @@ export {
   isButtonLookValue,
   isChromeLandmark,
   isCodeButton,
+  isDeriveReservedKey,
   isLinkObject,
+  isReservedKey,
   isRoleKey,
   isRulePaired,
   isScriptHref,
   isSlotChild,
   isTableValue,
+  isUiRefusal,
   keyWords,
   landmarkRegions,
   linkAnchorOf,
@@ -4659,6 +4949,8 @@ export {
   linkValueProblem,
   locatorFor,
   locatorPath,
+  mayOverwrite,
+  normaliseRichTextFeatures,
   normalizeLinkValue,
   normalizeTableValue,
   normalizeWindow,
@@ -4672,8 +4964,10 @@ export {
   readPath,
   regionOf,
   renderTableHtml,
+  richTextRefusal,
   rulePartnerOf,
   safeCssUrl,
+  schemaHashInput,
   sideFloorApplies,
   sideSpaceCss,
   slotBindOf,
@@ -4690,6 +4984,7 @@ export {
   tableToMarkdown,
   tableValueProblems,
   topFieldKeyOf,
+  uiRefusalId,
   usesHideOn,
   videoUrlOf,
   videoValueProblem,