@bettercms-ai/types 1.52.0 → 1.55.0

package/dist/index.d.ts

@@ -4007,8 +4007,14 @@ declare function planSections<B>(slots: readonly string[], blocks: readonly B[]
  * side and stored on the other (kit-facet-table.v3.md, "Carriers" and "Corpus floor").
  */
 
-/** Tabs on one screen: a model's `fieldsets kind:"tab"` and a component's prop tabs alike. */
+/** 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;
@@ -4101,7 +4107,7 @@ type DefSources = Partial<Record<SourcedFacet, SchemaSource>>;
  */
 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", "shape_kind_mismatch", "block_field_unrenderable"];
+    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"];
@@ -4120,6 +4126,139 @@ type UiRefusal = {
 /** `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), minus `headings`: that one is an alias for the six levels, not a feature.
+ */
+declare const RICHTEXT_TOGGLE_FEATURES: readonly ["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"];
+/**
+ * The canonical features, in vocabulary order: what a normalised config holds and the full set
+ * a field can be given. An alias (`headings`) is a name a config may carry but never a feature.
+ */
+declare const RICHTEXT_FEATURES: readonly ["bold", "italic", "underline", "strikethrough", "code", "highlight", "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, duplicates dropped,
+ * VOCABULARY order, so two lists that mean the same thing are equal arrays (and RICHTEXT_FEATURES
+ * is its own normal form). `unknown` keeps each name that is neither a feature nor an alias, as
+ * written and once, so a reader can log it and a writer can refuse it (`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;
+
+/**
+ * What a delivered rich-text value carries for its embeds, beside its `html`: the one shape the
+ * server writes (at html-cache build), the SDK surfaces and every renderer reads.
+ */
+/**
+ * An X post's card, from the oEmbed fetch the server makes: plain strings, escaped by the
+ * renderer, never X's markup. `date` is as X shows it ("Oct 24, 2026").
+ */
+interface EmbedCard {
+    text: string;
+    authorName: string;
+    authorUrl?: string;
+    date?: string;
+}
+/**
+ * `cards` is keyed by the CANONICAL embed url (@bettercms-ai/richtext `canonicalEmbedUrl`), so a
+ * post pasted two ways finds the same card. The site's opt-in to X's script is not here: it is a
+ * page setting, so turning it on or off re-bakes no value's html.
+ */
+interface RichTextEmbeds {
+    cards: Record<string, EmbedCard>;
+}
+
+/**
+ * The id a heading's words make, V2's `slugify` byte for byte, so V2's stored links keep working.
+ * The one spelling: @bettercms-ai/richtext stamps it on every rendered h2/h3 and re-exports it,
+ * and the kit's table of contents reads it from here without the Portable Text stack.
+ */
+declare const slugify: (s: string) => string;
 
-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, 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, 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, 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, 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 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, 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, isLinkObject, isRoleKey, isRulePaired, isScriptHref, isSlotChild, isTableValue, isUiRefusal, keyWords, landmarkRegions, linkAnchorOf, linkHref, linkRefOf, linkValueProblem, locatorFor, locatorPath, mayOverwrite, 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, uiRefusalId, usesHideOn, videoUrlOf, videoValueProblem, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps, withExample };
+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 EmbedCard, 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 RichTextEmbeds, 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, slugify, spaceTokenCss, splitButtonStyle, tableCellText, tablePathString, tableRefCells, tableSearchText, tableToMarkdown, tableValueProblems, topFieldKeyOf, uiRefusalId, usesHideOn, videoUrlOf, videoValueProblem, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps, withExample };

package/dist/index.js

@@ -4553,6 +4553,7 @@ function planSections(slots, blocks) {
 
 // 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;
@@ -4652,8 +4653,13 @@ var UI_REFUSAL_CODES = {
     "depth_exceeded",
     "validation_failed",
     "hash_mismatch",
+    "non_finite_number",
     "shape_kind_mismatch",
-    "block_field_unrenderable"
+    "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"],
@@ -4666,6 +4672,18 @@ var isUiRefusal = (v) => {
   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";
@@ -4692,6 +4710,100 @@ function canonicalJson(value) {
   }
   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 = [
+  "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);
+function normaliseRichTextFeatures(names) {
+  const want = /* @__PURE__ */ new Set();
+  const unknown = [];
+  for (const name of names) {
+    if (Object.hasOwn(RICHTEXT_FEATURE_ALIASES, 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)), 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}`
+});
+
+// src/heading-id.ts
+var slugify = (s) => s.toLowerCase().normalize("NFKD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "section";
 export {
   BLOCK_BINDINGS,
   BLOCK_FIELD_TYPES,
@@ -4711,6 +4823,7 @@ export {
   COMPONENT_PROP_TYPES,
   CONTROL_HELP,
   DEPTH_MAX,
+  DERIVE_MINTED_RESERVED,
   DIALOG_SELECTOR,
   DOCK_BUDGET,
   DOCK_ICON_NAMES,
@@ -4722,6 +4835,10 @@ export {
   HELP_MAX,
   IMAGE_ASPECTS,
   IMAGE_FRAME_RADIUS,
+  KEY_FORBIDDEN,
+  KEY_FORMAT,
+  KEY_RESERVED,
+  KEY_RESERVED_PREFIX,
   KIT_CATEGORIES,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
@@ -4734,9 +4851,21 @@ 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,
@@ -4756,6 +4885,7 @@ export {
   TABLE_LIMITS,
   TABLE_RESPONSIVE,
   TAB_MAX,
+  TAB_MAX_RENDERABLE_NOW,
   TAG_HEADS,
   UI_REFUSAL_CODES,
   V2_KEYS,
@@ -4803,7 +4933,9 @@ export {
   isButtonLookValue,
   isChromeLandmark,
   isCodeButton,
+  isDeriveReservedKey,
   isLinkObject,
+  isReservedKey,
   isRoleKey,
   isRulePaired,
   isScriptHref,
@@ -4819,6 +4951,7 @@ export {
   locatorFor,
   locatorPath,
   mayOverwrite,
+  normaliseRichTextFeatures,
   normalizeLinkValue,
   normalizeTableValue,
   normalizeWindow,
@@ -4832,8 +4965,10 @@ export {
   readPath,
   regionOf,
   renderTableHtml,
+  richTextRefusal,
   rulePartnerOf,
   safeCssUrl,
+  schemaHashInput,
   sideFloorApplies,
   sideSpaceCss,
   slotBindOf,
@@ -4841,6 +4976,7 @@ export {
   slotItems,
   slotPathString,
   slotShapeProblems,
+  slugify,
   spaceTokenCss,
   splitButtonStyle,
   tableCellText,