@bettercms-ai/types 1.43.1 → 1.45.0

package/dist/index.d.ts

@@ -586,17 +586,36 @@ interface Page {
 /**
  * Section spacing as TOKEN STEPS — the ONE list of names and default sizes, shared by the save
  * schema and every renderer. A stored value is always a token (`section-space-large`), never a
- * pixel; it renders as `var(--bcms-section-space-large,96px)`, so a site with a token registry
+ * pixel; it renders as `var(--bcms-section-space-large,88px)`, so a site with a token registry
  * restyles every section at once and a site without one still gets the default rhythm.
  *
  * 🔴 The px table is twinned with the dashboard's `tokenScales.ts` preview table. Change both.
  */
-declare const SECTION_SPACE_TOKENS: readonly ["section-space-none", "section-space-small", "section-space-medium", "section-space-large", "section-space-xlarge", "section-space-nav-overlap"];
+declare const SECTION_SPACE_TOKENS: readonly ["section-space-none", "section-space-xsmall", "section-space-small", "section-space-medium", "section-space-large", "section-space-xlarge", "section-space-nav-overlap"];
 declare const SPACE_STEP_TOKENS: readonly ["space-none", "space-s", "space-m", "space-l", "space-xl"];
 type SectionSpaceToken = (typeof SECTION_SPACE_TOKENS)[number];
 type SpaceStepToken = (typeof SPACE_STEP_TOKENS)[number];
 /** A negative band that pulls content under the nav makes sense at the TOP of a section only. */
-declare const SPACE_BOTTOM_TOKENS: ("section-space-none" | "section-space-small" | "section-space-medium" | "section-space-large" | "section-space-xlarge")[];
+declare const SPACE_BOTTOM_TOKENS: ("section-space-none" | "section-space-xsmall" | "section-space-small" | "section-space-medium" | "section-space-large" | "section-space-xlarge")[];
+/**
+ * What `spaceSides` accepts: the old inner `space-*` steps (still read, as they always rendered)
+ * and the section steps the V2 Sides handle writes — the same six as the top and bottom.
+ */
+declare const SIDE_SPACE_TOKENS: readonly ["space-none", "space-s", "space-m", "space-l", "space-xl", ...("section-space-none" | "section-space-xsmall" | "section-space-small" | "section-space-medium" | "section-space-large" | "section-space-xlarge")[]];
+/** V2: side spacing never renders under 16px (`Math.max(16, spacingPx(...))`). */
+declare const SIDE_SPACE_MIN_PX = 16;
+/**
+ * The side padding for a `spaceSides` token. A section step is floored at 16px as V2 does; an old
+ * `space-*` step renders exactly as before, so no stored section moves. "" for an unknown token.
+ */
+declare function sideSpaceCss(token: unknown): string;
+/**
+ * V2's site gutter: a band's content never touches its edge. The hosted renderer's own section
+ * wrapper (`div.bcms-block`) carrying the band rhythm (a top or bottom step or px — only a section
+ * carries one) with no side value at all gets 16px sides. Only that wrapper: a site's own section
+ * root keeps its own side padding, which an inline 16px would override.
+ */
+declare function sideFloorApplies(style: Record<string, unknown>): boolean;
 /** `var(--bcms-<token>,<px>)`, or "" for anything that is not a known token (closed set). */
 declare function spaceTokenCss(token: unknown): string;
 
@@ -842,6 +861,16 @@ interface BlockStyle {
     fontSize?: FontSizeToken;
     weight?: WeightToken;
     radius?: RadiusToken;
+    /** A free corner radius in px (0–96), V2's Alt-drag "Custom · free" value. Wins over `radius`. */
+    radiusPx?: number;
+    /** An image cropped to this ratio, filling its column (V2's media frame). @see imageFrameCss */
+    aspect?: "16/9" | "16/7" | "4/3" | "4/5" | "1/1";
+    /** The frame's ratio on a phone (≤767px); unset keeps `aspect`. The hosted lane draws it. */
+    aspectMobile?: "16/9" | "16/7" | "4/3" | "4/5" | "1/1";
+    /** The block's top gap on a phone (≤767px), in px (0–240); unset keeps `marginTop`. The hosted lane draws it. */
+    marginTopMobilePx?: number;
+    /** A heading whose column is its measure: the hosted page's heading width limit (`type.headingMeasure`) skips it. */
+    measure?: "column";
     theme?: ThemeToken;
     bg?: BgToken;
     /** Only read when `bg === "custom"`. Hex only. */
@@ -855,6 +884,8 @@ interface BlockStyle {
     spaceBottom?: Exclude<SectionSpaceToken, "section-space-nav-overlap">;
     spaceSides?: SpaceStepToken;
     contentWidth?: ContentWidthToken;
+    /** A free content width in px (320–2400), V2's Alt-drag "Custom · free" value. Wins over `contentWidth`. */
+    contentWidthPx?: number;
     /**
      * Where the constrained content column sits, when `contentWidth` constrains it.
      *
@@ -879,7 +910,8 @@ interface BlockStyle {
     hover?: BlockHoverStyle;
     /**
      * Breakpoints the block is hidden on (`display:none` there only; the block stays in the HTML).
-     * Never all three: a block hidden everywhere is a delete. Bands: see `BREAKPOINTS`.
+     * All three is "Hide on this page": the block is kept for the editor but no published lane
+     * emits it (`hiddenEverywhere`, `visibleBlocks`). Bands: see `BREAKPOINTS`.
      */
     hideOn?: Array<"mobile" | "tablet" | "desktop">;
 }
@@ -922,9 +954,15 @@ declare function windowState(item: unknown, now: Date | number): WindowState;
 /** Is the block or Section shown at `now`? No window is always shown. */
 declare const inWindow: (item: unknown, now: Date | number) => boolean;
 /**
- * The blocks shown at `now`: every block outside its window removed, at any depth (a section's
- * children, columns, slides, tab panels). What a published lane renders, collects from and
- * delivers.
+ * Is the block hidden on every breakpoint (`style.hideOn` names mobile, tablet AND desktop)? That
+ * is the editor's "Hide on this page": the block stays in the stored tree, so Show brings it back
+ * as it was, but no published lane emits it. Not a window: it does not depend on `now`.
+ */
+declare function hiddenEverywhere(item: unknown): boolean;
+/**
+ * The blocks shown at `now`: every block outside its window, and every block hidden on all
+ * breakpoints (`hiddenEverywhere`), removed at any depth (a section's children, columns, slides,
+ * tab panels). What a published lane renders, collects from and delivers.
  *
  * Returns the SAME array when nothing is removed, so a tree with no window costs one walk and
  * every consumer downstream is handed exactly what it was handed before windows existed.
@@ -1038,6 +1076,19 @@ interface ImageProps {
     width?: number;
     height?: number;
     caption?: string;
+    /**
+     * THIS placement's focal point (V2's `srcFocal`): 0–1 fractions of the SOURCE picture, drawn as
+     * `object-position` inside the crop window `src`'s `?rect=` serves. Absent or null = centred.
+     */
+    focal?: {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * THIS placement is decorative (V2's `srcDecorative`): rendered with `alt=""`. The page's own,
+     * never the shared media asset's, so one Undo reverses it with the alt.
+     */
+    decorative?: boolean;
 }
 interface ImageBlock {
     type: "image";
@@ -1523,6 +1574,22 @@ declare function componentInstanceAddresses(instanceBlockId: string, props: read
  * render-page.ts. Unknown tokens are dropped — closed set, no arbitrary CSS.
  */
 
+/**
+ * V2's media frame (`aspect-[16/7]` + `cs-r2` on the image wrapper, site/hero.tsx and content.tsx):
+ * the picture fills its column, is cropped to the ratio (cover), and takes the theme's large media
+ * corner, the card radius x 1.8 as V2's `cs-r2 = calc(var(--cs-r) * 1.8)`. A block's own `radius` /
+ * `radiusPx` still wins over that corner. 🔴 Every lane reads this one function (hosted, Next, Astro).
+ */
+declare const IMAGE_ASPECTS: readonly ["16/9", "16/7", "4/3", "4/5", "1/1"];
+type ImageAspect = (typeof IMAGE_ASPECTS)[number];
+declare const IMAGE_FRAME_RADIUS = "calc(var(--bcms-radius-card,14px) * 1.8)";
+declare function imageFrameCss(style: unknown): {
+    display: "block";
+    width: string;
+    aspectRatio: string;
+    objectFit: "cover";
+    borderRadius?: string;
+} | null;
 /**
  * Where a block's `hideOn` bands start and end: mobile at most 767px, tablet 768-1023px, desktop
  * 1024px and up (the dock's 390 / 810 / 1280 canvases fall one in each band). A site's CSS
@@ -1543,6 +1610,8 @@ declare const RESPONSIVE_CSS: string;
 /**
  * The `data-bcms-hide` value for a block style (`"mobile tablet"`), or "" when it hides nowhere.
  * Closed set, fixed order, so a hand-edited row cannot put anything else into an attribute.
+ * All three is "" too: such a block is not emitted on a published lane at all (`visibleBlocks`),
+ * and the editor's lane draws it whole, marked `data-bcms-hidden`, so the author can find it.
  */
 declare function hideOnAttr(style: unknown): string;
 /** True when any block in the tree hides somewhere; lets a lane skip `RESPONSIVE_CSS` when unused. */
@@ -2326,9 +2395,23 @@ interface PropGroup {
     layout?: "stack" | "breakpoints";
     order?: number;
 }
-/** A prop's `ui`: the field-lane chrome plus its inline {@link PropGroup}. */
+/**
+ * A top-level prop's dock tab (V2 kit schema `groups`: Content | Design | Media | Settings | …).
+ * Define-once like {@link PropGroup}: the first prop naming an `id` sets label/icon/order, later
+ * props name `{ id }`. At most 8 tabs; never on a sub-field; one group's members share one tab.
+ */
+interface PropTab {
+    id: string;
+    /** 1–20 chars, unique per component (case-insensitive). Required on the defining prop. */
+    label?: string;
+    icon?: DockIconName;
+    /** 0–99; the tab's place among the tabs (absent = where its first prop sits). */
+    order?: number;
+}
+/** A prop's `ui`: the field-lane chrome plus its inline {@link PropGroup} and {@link PropTab}. */
 type ComponentPropUi = ContentModelFieldUi & {
     group?: PropGroup;
+    tab?: PropTab;
 };
 /** One field inside a `group` / `object` prop or a `table` row. Recursive, 10 levels at most counting the prop (MAX_FIELD_DEPTH). */
 interface ComponentSubField {
@@ -3660,4 +3743,4 @@ type SectionPlanItem<B> = {
  */
 declare function planSections<B>(slots: readonly string[], blocks: readonly B[] | null | undefined): SectionPlanItem<B>[];
 
-export { type AlignToken, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, BLOCK_BINDINGS, 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 ButtonAction, type ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSiteLook, type ButtonSizeName, type ButtonValue, type ButtonVariant, CODE_SLOT_PREFIX, COMPONENT_PROP_TYPES, type CanonicalInputDefinition, type ChoiceOption, type CollectionBlock, type CollectionFilter, type CollectionProps, type ColorToken, type ColumnsBlock, type ColumnsProps, type Component, type ComponentBlock, type ComponentCategory, type ComponentFormPropRef, type ComponentPropDef, type ComponentPropType, type ComponentPropUi, type ComponentProps, type ComponentSubField, type ComponentVariantGroup, type Content, type ContentBlock, type ContentEntry, type ContentModel, type ContentModelField, type ContentModelFieldType, type ContentModelFieldUi, type ContentPageResult, type ContentResponse, type ContentWidthToken, 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, type HeadingBlock, type HeadingProps, type ImageBlock, type ImageProps, LANDMARK_SELECTOR, LAYOUT_SECTION_ICONS, LAYOUT_SECTION_ICON_SET, LINK_RELS, LINK_VALUE_TYPES, 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 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, RESPONSIVE_CSS, type RadiusToken, type ReadButtonValue, type Redirect, type ReservedLayoutSection, type ResolvedLayoutNode, type RichTextBlock, type RichTextProps, SECTION_DOCTRINE, SECTION_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, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, buttonBlockProps, buttonFullWidthProblem, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonLookValue, buttonSiteLookOf, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, expandBlockBindings, fieldGroupOf, fieldStyleCssText, fieldStyleToCss, formatNumber, formatPropsAttribute, getBlockType, headingPaintCss, hideOnAttr, inWindow, isBlock, isButtonLookValue, isChromeLandmark, isCodeButton, isLinkObject, isScriptHref, isSlotChild, isTableValue, keyWords, landmarkRegions, linkAnchorOf, linkHref, linkRefOf, linkValueProblem, locatorFor, normalizeLinkValue, normalizeTableValue, normalizeWindow, parseNumberText, parsePropsAttribute, pickFieldStyle, placementBindOf, planSections, readButtonValue, readNumberFormat, readPath, regionOf, renderTableHtml, safeCssUrl, slotBindOf, slotChildValues, slotItems, slotPathString, slotShapeProblems, spaceTokenCss, splitButtonStyle, tableCellText, tablePathString, tableRefCells, tableSearchText, tableToMarkdown, tableValueProblems, topFieldKeyOf, usesHideOn, videoUrlOf, videoValueProblem, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps };
+export { type AlignToken, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, BLOCK_BINDINGS, 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 ButtonAction, type ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSiteLook, type ButtonSizeName, type ButtonValue, type ButtonVariant, CODE_SLOT_PREFIX, COMPONENT_PROP_TYPES, type CanonicalInputDefinition, type ChoiceOption, type CollectionBlock, type CollectionFilter, type CollectionProps, type ColorToken, type ColumnsBlock, type ColumnsProps, type Component, type ComponentBlock, type ComponentCategory, type ComponentFormPropRef, type ComponentPropDef, type ComponentPropType, type ComponentPropUi, type ComponentProps, type ComponentSubField, type ComponentVariantGroup, type Content, type ContentBlock, type ContentEntry, type ContentModel, type ContentModelField, type ContentModelFieldType, type ContentModelFieldUi, type ContentPageResult, type ContentResponse, type ContentWidthToken, 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, 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, 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 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, 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, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, buttonBlockProps, buttonFullWidthProblem, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonLookValue, buttonSiteLookOf, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, expandBlockBindings, fieldGroupOf, fieldStyleCssText, fieldStyleToCss, formatNumber, formatPropsAttribute, getBlockType, headingPaintCss, hiddenEverywhere, hideOnAttr, imageFrameCss, inWindow, isBlock, isButtonLookValue, isChromeLandmark, isCodeButton, isLinkObject, isScriptHref, isSlotChild, isTableValue, keyWords, landmarkRegions, linkAnchorOf, linkHref, linkRefOf, linkValueProblem, locatorFor, normalizeLinkValue, normalizeTableValue, normalizeWindow, parseNumberText, parsePropsAttribute, pickFieldStyle, placementBindOf, planSections, readButtonValue, readNumberFormat, readPath, regionOf, renderTableHtml, 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 };

package/dist/index.js

@@ -29,6 +29,11 @@ function windowState(item, now) {
   return "live";
 }
 var inWindow = (item, now) => windowState(item, now) === "live";
+function hiddenEverywhere(item) {
+  const style = item && typeof item === "object" ? item.style : void 0;
+  const raw = style && typeof style === "object" ? style.hideOn : void 0;
+  return Array.isArray(raw) && raw.includes("mobile") && raw.includes("tablet") && raw.includes("desktop");
+}
 function mapSame(list, fn) {
   let changed = false;
   const out = list.map((item) => {
@@ -55,7 +60,7 @@ function withVisibleChildren(block, now) {
 }
 function visibleBlocks(blocks, now) {
   if (!Array.isArray(blocks)) return blocks;
-  const shown = blocks.filter((block) => inWindow(block, now));
+  const shown = blocks.filter((block) => inWindow(block, now) && !hiddenEverywhere(block));
   const pruned = mapSame(
     shown,
     (block) => block && typeof block === "object" ? withVisibleChildren(block, now) : block
@@ -249,6 +254,8 @@ function componentInstanceAddresses(instanceBlockId, props, owner) {
 // src/sectionSpace.ts
 var SECTION_SPACE_TOKENS = [
   "section-space-none",
+  // V2's six-step band rhythm (None · XS · S · M · L · XL); added after the five, so nothing stored moves.
+  "section-space-xsmall",
   "section-space-small",
   "section-space-medium",
   "section-space-large",
@@ -261,10 +268,12 @@ var SPACE_BOTTOM_TOKENS = SECTION_SPACE_TOKENS.filter(
 );
 var SPACE_TOKEN_PX = {
   "section-space-none": "0px",
+  "section-space-xsmall": "16px",
   "section-space-small": "32px",
-  "section-space-medium": "64px",
-  "section-space-large": "96px",
-  "section-space-xlarge": "144px",
+  // V2's band px (site/context.tsx PAD: none 0 · xs 16 · sm 32 · md 56 · lg 88 · xl 128).
+  "section-space-medium": "56px",
+  "section-space-large": "88px",
+  "section-space-xlarge": "128px",
   "section-space-nav-overlap": "-72px",
   "space-none": "0px",
   "space-s": "8px",
@@ -272,6 +281,17 @@ var SPACE_TOKEN_PX = {
   "space-l": "32px",
   "space-xl": "64px"
 };
+var SIDE_SPACE_TOKENS = [...SPACE_STEP_TOKENS, ...SPACE_BOTTOM_TOKENS];
+var SIDE_SPACE_MIN_PX = 16;
+function sideSpaceCss(token) {
+  const css = spaceTokenCss(token);
+  if (!css || !SPACE_BOTTOM_TOKENS.includes(token)) return css;
+  return `max(${SIDE_SPACE_MIN_PX}px,${css})`;
+}
+function sideFloorApplies(style) {
+  const band = style.spaceTop !== void 0 || style.spaceBottom !== void 0 || typeof style.paddingTop === "number" || typeof style.paddingBottom === "number";
+  return band && style.spaceSides === void 0 && typeof style.paddingSides !== "number" && style.paddingX === void 0;
+}
 function spaceTokenCss(token) {
   const px = typeof token === "string" ? SPACE_TOKEN_PX[token] : void 0;
   return px ? `var(--bcms-${token},${px})` : "";
@@ -291,6 +311,23 @@ var FONT_SIZE_REM = {
 };
 var WEIGHT = { normal: 400, medium: 500, semibold: 600, bold: 700 };
 var RADIUS_PX = { none: "0", sm: "4px", md: "8px", lg: "16px", full: "9999px" };
+var IMAGE_ASPECTS = ["16/9", "16/7", "4/3", "4/5", "1/1"];
+var IMAGE_FRAME_RADIUS = "calc(var(--bcms-radius-card,14px) * 1.8)";
+function imageFrameCss(style) {
+  if (!style || typeof style !== "object") return null;
+  const s = style;
+  if (typeof s.aspect !== "string" || !IMAGE_ASPECTS.includes(s.aspect)) return null;
+  const ownRadius = typeof s.radius === "string" && RADIUS_PX[s.radius] != null || typeof s.radiusPx === "number" && Number.isFinite(s.radiusPx);
+  return {
+    // Block, as V2's preflight draws an <img>: inline, it sat on a text baseline and the box ran
+    // ~7px taller than the picture (445px image in a 452px box at 1280).
+    display: "block",
+    width: "100%",
+    aspectRatio: s.aspect.replace("/", " / "),
+    objectFit: "cover",
+    ...ownRadius ? {} : { borderRadius: IMAGE_FRAME_RADIUS }
+  };
+}
 var COLOR_HEX = { white: "#ffffff", black: "#111111", muted: "#6b7280", mutedBg: "#f3f4f6", primary: "#111111", accent: "#4f46e5" };
 var THEME = {
   light: { colorScheme: "light", background: "#ffffff", color: "#111111" },
@@ -302,6 +339,11 @@ var BG_HEX = {
   accent: "var(--bcms-bg-accent,#4f46e5)",
   dark: "var(--bcms-bg-dark,#0b0b0d)"
 };
+var DARK_BG_HEX = { surface: "#0b0b0d", muted: "#1c1c1e" };
+var FILL_SCHEME = {
+  dark: { colorScheme: "dark", color: "#f7f8f8" },
+  accent: { colorScheme: "var(--bcms-accent-scheme,dark)", color: "var(--bcms-on-accent,#ffffff)" }
+};
 var CORNER_PX = { "0": "0", s: "4px", m: "8px", l: "16px", xl: "24px", "2xl": "32px" };
 var SHADOW_CSS = {
   "0": "none",
@@ -354,7 +396,7 @@ function blockStyleToCss(style) {
   }
   const top = spaceTokenCss(s.spaceTop);
   const bottom = SPACE_BOTTOM_TOKENS.includes(s.spaceBottom ?? "") ? spaceTokenCss(s.spaceBottom) : "";
-  const sides = spaceTokenCss(s.spaceSides);
+  const sides = sideSpaceCss(s.spaceSides);
   const navOverlap = s.spaceTop === "section-space-nav-overlap";
   if (top && !navOverlap) css.paddingTop = top;
   if (bottom) css.paddingBottom = bottom;
@@ -374,6 +416,8 @@ function blockStyleToCss(style) {
   if (s.fontSize && FONT_SIZE_REM[s.fontSize]) css.fontSize = FONT_SIZE_REM[s.fontSize];
   if (s.weight && WEIGHT[s.weight] != null) css.fontWeight = WEIGHT[s.weight];
   if (s.radius && RADIUS_PX[s.radius] != null) css.borderRadius = RADIUS_PX[s.radius];
+  const rpx = style.radiusPx;
+  if (typeof rpx === "number" && Number.isFinite(rpx)) css.borderRadius = `${clamp(Math.round(rpx), 0, 96)}px`;
   const theme = own(THEME, s.theme);
   if (theme) {
     css.colorScheme = theme.colorScheme;
@@ -382,7 +426,14 @@ function blockStyleToCss(style) {
   }
   if (s.bg === "custom") {
     if (HEX.test(s.bgCustom ?? "")) css.background = s.bgCustom;
-  } else if (own(BG_HEX, s.bg)) css.background = own(BG_HEX, s.bg);
+  } else if (own(BG_HEX, s.bg)) {
+    css.background = s.theme === "dark" && own(DARK_BG_HEX, s.bg) || own(BG_HEX, s.bg);
+    const fill = own(FILL_SCHEME, s.bg);
+    if (fill) {
+      css.colorScheme = fill.colorScheme;
+      css.color = fill.color;
+    }
+  }
   const bgImage = safeCssUrl(s.bgImage);
   if (bgImage) {
     css.backgroundImage = `url(${bgImage})`;
@@ -417,7 +468,8 @@ function blockStyleToCss(style) {
 function blockStyleToInnerCss(style) {
   if (!style || typeof style !== "object") return void 0;
   const s = style;
-  const max = own(CONTENT_WIDTH_PX, s.contentWidth);
+  const free = style.contentWidthPx;
+  const max = typeof free === "number" && Number.isFinite(free) ? `${clamp(Math.round(free), 320, 2400)}px` : own(CONTENT_WIDTH_PX, s.contentWidth);
   if (!max) return void 0;
   const placement = s.contentAlign ?? s.align;
   const margin = placement === "left" ? "0 auto 0 0" : placement === "right" ? "0 0 0 auto" : "0 auto";
@@ -4262,6 +4314,8 @@ export {
   FIELD_SIZE_ZOOM,
   FIELD_STYLE_KEYS,
   FOOTER_SECTION_ID,
+  IMAGE_ASPECTS,
+  IMAGE_FRAME_RADIUS,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
   LAYOUT_SECTION_ICON_SET,
@@ -4274,6 +4328,8 @@ export {
   RESPONSIVE_CSS,
   SECTION_DOCTRINE,
   SECTION_SPACE_TOKENS,
+  SIDE_SPACE_MIN_PX,
+  SIDE_SPACE_TOKENS,
   SLOT_CHILD_KEYS,
   SLOT_ITEMS_CAP,
   SLOT_MAX_ITEMS,
@@ -4314,7 +4370,9 @@ export {
   formatPropsAttribute,
   getBlockType,
   headingPaintCss,
+  hiddenEverywhere,
   hideOnAttr,
+  imageFrameCss,
   inWindow,
   isBlock,
   isButtonLookValue,
@@ -4345,6 +4403,8 @@ export {
   regionOf,
   renderTableHtml,
   safeCssUrl,
+  sideFloorApplies,
+  sideSpaceCss,
   slotBindOf,
   slotChildValues,
   slotItems,