@bettercms-ai/types 1.38.0 → 1.39.0

package/dist/index.d.ts

@@ -48,7 +48,7 @@ interface ContentModel {
  * by the API but normalized to `array` + zones on write, so stored/delivered
  * content never contains them.
  */
-type ContentModelFieldType = "text" | "richtext" | "document" | "image" | "boolean" | "number" | "select" | "reference" | "multi-reference" | "multiReference" | "array" | "date" | "datetime" | "longtext" | "slug" | "email" | "phone" | "link" | "color" | "json" | "file" | "component-ref" | "modular" | "sections" | "location" | "button";
+type ContentModelFieldType = "text" | "richtext" | "document" | "image" | "boolean" | "number" | "select" | "reference" | "multi-reference" | "multiReference" | "array" | "date" | "datetime" | "longtext" | "slug" | "email" | "phone" | "link" | "color" | "json" | "file" | "component-ref" | "modular" | "sections" | "location" | "button" | "multiselect" | "icon";
 type ContentModelKind = "model" | "block";
 /**
  * How a fieldset renders in the dock. ABSENT ≡ today's flat list (V2): a legacy `{id, name}`
@@ -315,9 +315,10 @@ interface ContentModelFieldUi {
     /**
      * Which editor control a LEAF renders with. ABSENT ≡ the type's default (a dropdown for a
      * `select`, a plain input for a `number`). `segmented` is valid on a single-choice `select`;
-     * `slider` on a `number` whose config.min < config.max.
+     * `slider` on a `number` whose config.min < config.max; `rating` on a `number` with numeric
+     * config.min, max and step (stars).
      */
-    control?: "segmented" | "slider";
+    control?: "segmented" | "slider" | "rating";
     /** The branch row's icon. Nesting fields only. */
     icon?: DockIconName;
     /** What one item is called ("Slide", "Member"), 1–24 chars. Nesting fields only. */
@@ -545,6 +546,11 @@ interface BlockStyle {
     bgImage?: string;
     /** A button's look while the pointer is over it. Only the paint changes; unset keys keep the rest. */
     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`.
+     */
+    hideOn?: Array<"mobile" | "tablet" | "desktop">;
 }
 /** The paint a button swaps to on hover: fill, text colour, and the all-round border. */
 interface BlockHoverStyle {
@@ -553,6 +559,47 @@ interface BlockHoverStyle {
     textColor?: ColorToken;
     border?: boolean;
 }
+/**
+ * Both bounds are INSTANTS: ISO 8601 with an offset, stored normalized to UTC seconds
+ * (`2026-11-27T00:00:00Z`). Shown from `from` (inclusive) until `until` (exclusive); a missing
+ * bound is open. An absent or null window is always shown.
+ */
+interface VisibilityWindow {
+    from?: string;
+    until?: string;
+}
+type WindowState = "live" | "pending" | "expired";
+/**
+ * A written window, normalized for storage, or the code it is refused with. null, undefined and
+ * an object with neither bound are all "no window". UTC at seconds precision makes the stored
+ * strings sort in time order, which the due scan (`list_due_window_projects`) relies on.
+ */
+declare function normalizeWindow(value: unknown): {
+    window: VisibilityWindow | null;
+} | {
+    error: "invalid_window" | "window_inverted";
+};
+/**
+ * Where `now` falls in a block's or Section's `window`. THE one reading of a window: every
+ * renderer, the delivery lanes and the in-place publish decide through it (or `inWindow`).
+ *
+ * `now` is an argument, never read from a clock here, so one request compares every block
+ * against the same instant. Bounds are compared as instants, so a stored offset cannot shift
+ * one. A bound that does not parse is read as open: a hand-edited row shows rather than vanishes.
+ */
+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.
+ *
+ * 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.
+ * Non-array input is returned as it came.
+ */
+declare function visibleBlocks<T>(blocks: T, now: Date | number): T;
 interface HeadingProps {
     text: string;
     level?: 1 | 2 | 3;
@@ -563,6 +610,8 @@ interface HeadingBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: HeadingProps;
 }
 interface TextProps {
@@ -576,6 +625,8 @@ interface TextBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: TextProps;
 }
 /**
@@ -646,6 +697,8 @@ interface RichTextBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: RichTextProps;
 }
 interface ImageProps {
@@ -661,6 +714,8 @@ interface ImageBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: ImageProps;
 }
 interface ButtonProps {
@@ -687,6 +742,8 @@ interface ButtonBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: ButtonProps;
 }
 interface SpacerProps {
@@ -698,6 +755,8 @@ interface SpacerBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: SpacerProps;
 }
 interface ColumnsProps {
@@ -710,6 +769,8 @@ interface ColumnsBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: ColumnsProps;
 }
 interface VideoProps {
@@ -730,6 +791,8 @@ interface VideoBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: VideoProps;
 }
 interface FormProps {
@@ -741,6 +804,8 @@ interface FormBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: FormProps;
 }
 interface SectionProps {
@@ -755,6 +820,8 @@ interface SectionBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: SectionProps;
 }
 interface NavLink {
@@ -781,6 +848,8 @@ interface NavbarBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: NavbarProps;
 }
 interface FooterColumn {
@@ -797,6 +866,8 @@ interface FooterBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: FooterProps;
 }
 interface SlideItem {
@@ -815,6 +886,8 @@ interface SliderBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: SliderProps;
 }
 interface TabItem {
@@ -831,6 +904,8 @@ interface TabsBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: TabsProps;
 }
 interface ComponentProps {
@@ -868,6 +943,8 @@ interface ComponentBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: ComponentProps;
 }
 interface CollectionProps {
@@ -913,6 +990,8 @@ interface CollectionBlock {
     style?: BlockStyle;
     /** Editor-facing display name for this block's dock card. Not rendered. */
     label?: string;
+    /** Shown only inside this window. Absent = always. @see VisibilityWindow */
+    window?: VisibilityWindow;
     props: CollectionProps;
 }
 type ContentBlock = CollectionBlock | HeadingBlock | TextBlock | RichTextBlock | ImageBlock | ButtonBlock | SpacerBlock | ColumnsBlock | VideoBlock | FormBlock | SectionBlock | NavbarBlock | FooterBlock | SliderBlock | TabsBlock | ComponentBlock;
@@ -1108,6 +1187,30 @@ declare function componentInstanceAddresses(instanceBlockId: string, props: read
  * render-page.ts. Unknown tokens are dropped — closed set, no arbitrary CSS.
  */
 
+/**
+ * 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
+ * carries these numbers, so changing one shifts every published site's media queries.
+ */
+declare const BREAKPOINTS: {
+    readonly mobile: 767;
+    readonly tablet: 1023;
+};
+/**
+ * The ONE stylesheet behind `data-bcms-hide="mobile tablet"`. `!important` because a block's own
+ * inline `display` (`fullHeight` writes `display:flex`) would otherwise beat it. `display:none`
+ * also takes the block out of the accessibility tree at that width. Hosted pages inline it in
+ * the head, `<BcmsBlocks>` emits it when a block uses `hideOn`, and a site that renders its own
+ * markup puts it in its global CSS.
+ */
+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.
+ */
+declare function hideOnAttr(style: unknown): string;
+/** True when any block in the tree hides somewhere; lets a lane skip `RESPONSIVE_CSS` when unused. */
+declare function usesHideOn(blocks: unknown): boolean;
 /**
  * 🔴 The ONE place a free-form string is allowed near CSS: `bgImage` is author-supplied, so it is
  * rejected — never escaped — unless it is an http(s) or root-relative url with nothing that could
@@ -1162,7 +1265,7 @@ declare function headingPaintCss(style: BlockStyle | undefined, opts?: {
  * painted a box BEHIND the anchor, which kept its variant's own fill. 🔴 Twin of `PLACEMENT_KEYS`
  * in src/lib/sites/render-page.ts; src/__tests__/sites/block-style-parity.test.ts pins the two.
  */
-declare const BUTTON_PLACEMENT_KEYS: readonly ["align", "contentAlign", "contentWidth", "marginTop", "marginBottom", "fullHeight", "spaceTop", "spaceBottom"];
+declare const BUTTON_PLACEMENT_KEYS: readonly ["align", "contentAlign", "contentWidth", "marginTop", "marginBottom", "fullHeight", "spaceTop", "spaceBottom", "hideOn"];
 /**
  * A button's style split in two: `placement` (the keys its wrapper keeps — feed it to
  * `blockStyleToCss` / `blockStyleToInnerCss` exactly like any block's style) and `paint`, the
@@ -1253,6 +1356,10 @@ interface LayoutFieldDefinition {
     helpSource?: "auto" | "human" | "agent";
     /** `true`: no route the last release inspected renders this field — hidden, never deleted. `false`: a person keeps it shown. */
     stale?: boolean;
+    /** false: a page may not override this value; the Global value renders on every page. Absent = true. */
+    overridable?: boolean;
+    /** Shown where the page editor would have offered the field. Required when overridable is false. */
+    lockReason?: string;
 }
 /** The canonical public input contract all variants in a group implement. */
 type CanonicalInputDefinition = LayoutFieldDefinition;
@@ -1316,6 +1423,11 @@ interface LayoutSection {
     locale?: string;
     /** The stable id of the base Section this variant replaces on routes in `locale`. */
     variantOf?: string;
+    /**
+     * When the Section is shown (an announcement bar, a seasonal band). Absent = always. It is the
+     * SLOT's: a locale variant shows when its base does, whatever the variant's own row says.
+     */
+    window?: VisibilityWindow;
 }
 interface LayoutStructureDocument {
     version: 1;
@@ -1453,6 +1565,7 @@ type ManagementLayoutCommand = {
     name: string;
     icon: LayoutSectionIcon;
     zone: "before_page" | "after_page";
+    window?: VisibilityWindow;
 } | {
     type: "restore-section";
     section: LayoutSection;
@@ -1469,6 +1582,7 @@ type ManagementLayoutCommand = {
     zone?: LayoutZone;
     orderKey?: string;
     description?: string;
+    window?: VisibilityWindow | null;
 } | {
     type: "remove-section";
     sectionId: string;
@@ -1542,6 +1656,8 @@ interface DeliveredLayout {
          */
         locale?: string;
         variantOf?: string;
+        /** Present only on a Section that has one. A published read never delivers a Section outside it. */
+        window?: VisibilityWindow;
         fields: Record<string, unknown>;
         items: Array<{
             id: string;
@@ -1575,6 +1691,19 @@ interface DeliveredLayout {
         }>;
     }>;
 }
+/**
+ * A Layout structure as a visitor is served it at `now`: every Section outside its window
+ * removed, and with a removed base its locale variants (a variant only ever renders in its base's
+ * slot). The same document when nothing is removed, and anything that is not one as it came.
+ */
+declare function visibleLayoutStructure<T>(structure: T, now: Date | number): T;
+/**
+ * A delivered Layout as a visitor is served it at `now`: the nodes whose Section is outside its
+ * window removed, with their `sections` entries and any variant delivered beside a removed base.
+ * Applied AFTER any cache, so a cached Layout never serves a Section past its boundary. The same
+ * object when nothing is removed.
+ */
+declare function visibleDeliveredLayout<T extends DeliveredLayout | null | undefined>(layout: T, now: Date | number): T;
 
 /**
  * Component — a reusable, Webflow-style block tree (a "symbol").
@@ -1660,6 +1789,11 @@ interface ComponentPropDef {
      * `{ componentId, overrides }` and its `target.path` is `props`, so filling a slot writes
      * that object over an empty `component` block's props.
      *
+     * With `config.multiple` it holds a LIST of them and targets a container's child list
+     * (`props.children` on a `section`, `props.columns.<n>` on a `columns`): the resolver writes
+     * one `component` block per item there, so every renderer draws them as ordinary children.
+     * @see slotItems
+     *
      * On a PAGE a slot fill is a LIVE reference; a published ENTRY freezes it (resolveDeep).
      */
     /**
@@ -1716,6 +1850,11 @@ interface ComponentPropDef {
     config?: {
         /** `slot` — a pick allowlist. */
         componentIds?: string[];
+        /** `slot` — the value is a list of instances, not one. @see slotItems */
+        multiple?: boolean;
+        /** `slot` with `multiple` — bounds on the list. `maxItems` defaults to {@link SLOT_MAX_ITEMS}. */
+        minItems?: number;
+        maxItems?: number;
         /**
          * `select` / `multiselect` — the choices. Required, and a default must be one of them. `{ label, value }`
          * when the stored value is not what an author should read (a component id, for instance).
@@ -1801,6 +1940,34 @@ interface ComponentSubField {
         options?: string[];
     } & Record<string, unknown>;
 }
+/** The value a `slot` prop holds — the draft half of a `component-ref`, deliberately. */
+interface SlotValue {
+    componentId: string;
+    overrides?: Record<string, unknown>;
+}
+/**
+ * One child of a `multiple` slot: a {@link SlotValue} that may also carry the two placement keys a
+ * `component` block has. The child block is built with them, so it hides per breakpoint and
+ * shows inside its window exactly as a block placed by hand does.
+ */
+interface SlotItem extends SlotValue {
+    style?: BlockStyle;
+    window?: VisibilityWindow;
+}
+/** How many children a `multiple` slot holds when its prop sets no `config.maxItems`. */
+declare const SLOT_MAX_ITEMS = 12;
+/** The most `config.maxItems` may ask for: one placement never expands into more blocks than this. */
+declare const SLOT_ITEMS_CAP = 50;
+/**
+ * A slot value as a list of its instances, whichever shape it was stored in: `[]` for nothing,
+ * one item for a single `{ componentId, overrides }`, the array's own items for a `multiple`
+ * slot. An item with no `componentId` names no component and is left out.
+ *
+ * THE one reading of a slot value. A walker that tests `value.componentId` alone sees a
+ * `multiple` slot as empty, and for a "where used" answer or a delete guard that is a component
+ * removed from under the pages that hold it.
+ */
+declare function slotItems(value: unknown): SlotItem[];
 /**
  * A component is a DRAFT until published; only the published copy reaches a visitor.
  * Mirrors pages and entries. See migration 0186_component_draft_live_split.sql.
@@ -2294,7 +2461,7 @@ type FormStatus = "draft" | "published";
 interface FormField {
     key: string;
     label: string;
-    type: "text" | "email" | "textarea" | "select" | "checkbox" | "checkboxes" | "radio" | "number" | "phone" | "date" | "url" | "consent" | "hidden";
+    type: "text" | "email" | "textarea" | "select" | "checkbox" | "checkboxes" | "radio" | "number" | "phone" | "date" | "url" | "consent" | "hidden" | "step";
     placeholder?: string;
     helpText?: string;
     required?: boolean;
@@ -2680,4 +2847,4 @@ declare function regionOf<E extends {
     el: E;
 }[], el: unknown): string | null;
 
-export { type AlignToken, type ApiError, type ApiKey, type ApiKeyPermission, type ApiKeyTokenType, type ArrayZoneConfig, type AssertEqual, type AuthResponse, type AuthSession, type AuthUser, BLOCK_BINDINGS, 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 ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSizeName, type ButtonValue, type ButtonVariant, COMPONENT_PROP_TYPES, type CanonicalInputDefinition, 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_STYLE_KEYS, FOOTER_SECTION_ID, type FieldConfig, 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, 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 LocatorGrammar, MAIN_SELECTOR, type ManagementLayoutCommand, type MediaAsset, type MediaCaptionTrack, type MediaFieldValue, NAVIGATION_SECTION_ID, type NavLink, type NavbarBlock, type NavbarProps, 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 RadiusToken, type ReadButtonValue, type Redirect, type ReservedLayoutSection, type ResolvedLayoutNode, type RichTextBlock, type RichTextProps, SECTION_DOCTRINE, SECTION_SPACE_TOKENS, SPACE_BOTTOM_TOKENS, SPACE_STEP_TOKENS, type SectionBlock, type SectionProps, type SectionSpaceToken, type ShadowToken, type ShowIf, type ShowIfRule, type SignInInput, type SignUpInput, type SiteSeoDefaults, type SlideItem, type SliderBlock, type SliderProps, type SpaceStepToken, type SpaceToken, type SpacerBlock, type SpacerProps, type TabItem, type TabsBlock, type TabsProps, type TextBlock, type TextProps, type ThemeToken, type UiBefore, type UiOrigin, type VariantInputMapping, type VideoBlock, type VideoProps, type WeightToken, type Workspace, type ZoneField, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, buttonBlockProps, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, expandBlockBindings, fieldStyleCssText, fieldStyleToCss, formatPropsAttribute, getBlockType, headingPaintCss, isBlock, isChromeLandmark, keyWords, landmarkRegions, locatorFor, parsePropsAttribute, pickFieldStyle, readButtonValue, readPath, regionOf, safeCssUrl, spaceTokenCss, splitButtonStyle, 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_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 ButtonBlock, type ButtonIcon, type ButtonLinkCandidate, type ButtonLookKey, type ButtonProps, type ButtonSizeName, type ButtonValue, type ButtonVariant, COMPONENT_PROP_TYPES, type CanonicalInputDefinition, 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_STYLE_KEYS, FOOTER_SECTION_ID, type FieldConfig, 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, 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 LocatorGrammar, MAIN_SELECTOR, type ManagementLayoutCommand, type MediaAsset, type MediaCaptionTrack, type MediaFieldValue, NAVIGATION_SECTION_ID, type NavLink, type NavbarBlock, type NavbarProps, 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_ITEMS_CAP, SLOT_MAX_ITEMS, SPACE_BOTTOM_TOKENS, SPACE_STEP_TOKENS, type SectionBlock, type SectionProps, type SectionSpaceToken, type ShadowToken, type ShowIf, type ShowIfRule, type SignInInput, type SignUpInput, type SiteSeoDefaults, type SlideItem, type SliderBlock, type SliderProps, type SlotItem, type SlotValue, type SpaceStepToken, type SpaceToken, type SpacerBlock, type SpacerProps, type TabItem, type TabsBlock, type TabsProps, type TextBlock, type TextProps, type ThemeToken, type UiBefore, type UiOrigin, type VariantInputMapping, type VideoBlock, type VideoProps, type VisibilityWindow, type WeightToken, type WindowState, type Workspace, type ZoneField, anchorTargetRel, blockStyleToColumnCss, blockStyleToCss, blockStyleToInnerCss, buttonBlockProps, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, expandBlockBindings, fieldStyleCssText, fieldStyleToCss, formatPropsAttribute, getBlockType, headingPaintCss, hideOnAttr, inWindow, isBlock, isChromeLandmark, keyWords, landmarkRegions, locatorFor, normalizeWindow, parsePropsAttribute, pickFieldStyle, readButtonValue, readPath, regionOf, safeCssUrl, slotItems, spaceTokenCss, splitButtonStyle, usesHideOn, visibleBlocks, visibleDeliveredLayout, visibleLayoutStructure, windowState, withButtonLookProps };

package/dist/index.js

@@ -1,4 +1,67 @@
 // src/block.ts
+var WINDOW_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/;
+function normalizeWindow(value) {
+  if (value == null) return { window: null };
+  if (typeof value !== "object" || Array.isArray(value)) return { error: "invalid_window" };
+  const out = {};
+  for (const [key, raw] of Object.entries(value)) {
+    if (key !== "from" && key !== "until") return { error: "invalid_window" };
+    if (raw == null) continue;
+    const at = typeof raw === "string" && WINDOW_INSTANT.test(raw) ? Date.parse(raw) : NaN;
+    const day = Number(String(raw).slice(8, 10));
+    if (Number.isNaN(at) || new Date(Date.UTC(Number(String(raw).slice(0, 4)), Number(String(raw).slice(5, 7)) - 1, day)).getUTCDate() !== day) {
+      return { error: "invalid_window" };
+    }
+    out[key] = `${new Date(at).toISOString().slice(0, 19)}Z`;
+  }
+  if (out.from && out.until && out.from >= out.until) return { error: "window_inverted" };
+  return { window: out.from || out.until ? out : null };
+}
+function windowState(item, now) {
+  const w = item && typeof item === "object" ? item.window : void 0;
+  if (!w || typeof w !== "object") return "live";
+  const at = typeof now === "number" ? now : now.getTime();
+  const { from, until } = w;
+  const start = typeof from === "string" ? Date.parse(from) : NaN;
+  const end = typeof until === "string" ? Date.parse(until) : NaN;
+  if (!Number.isNaN(end) && at >= end) return "expired";
+  if (!Number.isNaN(start) && at < start) return "pending";
+  return "live";
+}
+var inWindow = (item, now) => windowState(item, now) === "live";
+function mapSame(list, fn) {
+  let changed = false;
+  const out = list.map((item) => {
+    const next = fn(item);
+    if (next !== item) changed = true;
+    return next;
+  });
+  return changed ? out : list;
+}
+function withVisibleChildren(block, now) {
+  const p = block.props ?? {};
+  const key = block.type === "section" ? "children" : block.type === "columns" ? "columns" : block.type === "slider" ? "slides" : block.type === "tabs" ? "tabs" : null;
+  if (!key || !Array.isArray(p[key])) return block;
+  const held = p[key];
+  const next = key === "children" ? visibleBlocks(held, now) : key === "columns" ? mapSame(held, (column) => visibleBlocks(column, now)) : (
+    // A slide or a tab panel: `{ id, children }`.
+    mapSame(held, (row) => {
+      const children = row?.children;
+      const shown = visibleBlocks(children, now);
+      return shown === children ? row : { ...row, children: shown };
+    })
+  );
+  return next === held ? block : { ...block, props: { ...p, [key]: next } };
+}
+function visibleBlocks(blocks, now) {
+  if (!Array.isArray(blocks)) return blocks;
+  const shown = blocks.filter((block) => inWindow(block, now));
+  const pruned = mapSame(
+    shown,
+    (block) => block && typeof block === "object" ? withVisibleChildren(block, now) : block
+  );
+  return shown.length === blocks.length && pruned === shown ? blocks : pruned;
+}
 function isBlock(value) {
   return typeof value === "object" && value !== null && "type" in value && typeof value["type"] === "string";
 }
@@ -164,6 +227,22 @@ var SHADOW_CSS = {
 };
 var HAIRLINE = "1px solid rgba(0,0,0,.10)";
 var CONTENT_WIDTH_PX = { narrow: "640px", default: "1024px", wide: "1280px" };
+var BREAKPOINTS = { mobile: 767, tablet: 1023 };
+var RESPONSIVE_CSS = `@media(max-width:${BREAKPOINTS.mobile}px){[data-bcms-hide~="mobile"]{display:none!important}}@media(min-width:${BREAKPOINTS.mobile + 1}px) and (max-width:${BREAKPOINTS.tablet}px){[data-bcms-hide~="tablet"]{display:none!important}}@media(min-width:${BREAKPOINTS.tablet + 1}px){[data-bcms-hide~="desktop"]{display:none!important}}`;
+function hideOnAttr(style) {
+  const raw = style && typeof style === "object" ? style.hideOn : void 0;
+  if (!Array.isArray(raw)) return "";
+  const on = ["mobile", "tablet", "desktop"].filter((b) => raw.includes(b));
+  return on.length === 3 ? "" : on.join(" ");
+}
+function usesHideOn(blocks) {
+  let found = false;
+  JSON.stringify(blocks ?? null, (k, v) => {
+    if (k === "hideOn" && hideOnAttr({ hideOn: v })) found = true;
+    return v;
+  });
+  return found;
+}
 var HEX = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
 var clamp = (n, lo, hi) => Math.min(hi, Math.max(lo, n));
 var own = (map, key) => typeof key === "string" && Object.prototype.hasOwnProperty.call(map, key) ? map[key] : void 0;
@@ -276,7 +355,8 @@ var BUTTON_PLACEMENT_KEYS = [
   "marginBottom",
   "fullHeight",
   "spaceTop",
-  "spaceBottom"
+  "spaceBottom",
+  "hideOn"
 ];
 var PLACEMENT = new Set(BUTTON_PLACEMENT_KEYS);
 function splitButtonStyle(style) {
@@ -346,6 +426,14 @@ var COMPONENT_PROP_TYPES = [
   "icon",
   "multiselect"
 ];
+var SLOT_MAX_ITEMS = 12;
+var SLOT_ITEMS_CAP = 50;
+function slotItems(value) {
+  const list = Array.isArray(value) ? value : [value];
+  return list.filter(
+    (item) => !!item && typeof item === "object" && !Array.isArray(item) && typeof item.componentId === "string" && item.componentId !== ""
+  );
+}
 
 // src/layout-lucide-icons.ts
 var LAYOUT_SECTION_ICONS = Object.freeze([
@@ -2313,6 +2401,36 @@ var LAYOUT_SECTION_ICON_SET = new Set(LAYOUT_SECTION_ICONS);
 var PAGE_CONTENT_ANCHOR_ID = "page-content";
 var NAVIGATION_SECTION_ID = "navigation";
 var FOOTER_SECTION_ID = "footer";
+function visibleLayoutStructure(structure, now) {
+  const sections = structure?.sections;
+  if (!Array.isArray(sections)) return structure;
+  const hidden = new Set(
+    sections.filter((section) => section && !section.variantOf && !inWindow(section, now)).map((section) => section.id)
+  );
+  if (hidden.size === 0) return structure;
+  return {
+    ...structure,
+    sections: sections.filter((section) => !hidden.has(section?.variantOf ?? section?.id))
+  };
+}
+function visibleDeliveredLayout(layout2, now) {
+  if (!layout2) return layout2;
+  const hiddenIds = /* @__PURE__ */ new Set();
+  const hiddenSlugs = /* @__PURE__ */ new Set();
+  for (const node of layout2.nodes) {
+    if (node.kind !== "section" || inWindow(layout2.sections[node.slug], now)) continue;
+    hiddenIds.add(node.id);
+    hiddenSlugs.add(node.slug);
+  }
+  if (hiddenIds.size === 0) return layout2;
+  return {
+    ...layout2,
+    nodes: layout2.nodes.filter((node) => node.kind !== "section" || !hiddenIds.has(node.id)),
+    sections: Object.fromEntries(
+      Object.entries(layout2.sections).filter(([slug, section]) => !hiddenSlugs.has(slug) && !(section.variantOf && hiddenIds.has(section.variantOf)))
+    )
+  };
+}
 
 // src/dock-icon-names.ts
 var DOCK_ICON_NAMES = [
@@ -2973,6 +3091,7 @@ function regionOf(regions, el) {
 }
 export {
   BLOCK_BINDINGS,
+  BREAKPOINTS,
   BUTTON_ICONS,
   BUTTON_ICON_NAMES,
   BUTTON_LOOK_KEYS,
@@ -2993,8 +3112,11 @@ export {
   MAIN_SELECTOR,
   NAVIGATION_SECTION_ID,
   PAGE_CONTENT_ANCHOR_ID,
+  RESPONSIVE_CSS,
   SECTION_DOCTRINE,
   SECTION_SPACE_TOKENS,
+  SLOT_ITEMS_CAP,
+  SLOT_MAX_ITEMS,
   SPACE_BOTTOM_TOKENS,
   SPACE_STEP_TOKENS,
   anchorTargetRel,
@@ -3020,19 +3142,28 @@ export {
   formatPropsAttribute,
   getBlockType,
   headingPaintCss,
+  hideOnAttr,
+  inWindow,
   isBlock,
   isChromeLandmark,
   keyWords,
   landmarkRegions,
   locatorFor,
+  normalizeWindow,
   parsePropsAttribute,
   pickFieldStyle,
   readButtonValue,
   readPath,
   regionOf,
   safeCssUrl,
+  slotItems,
   spaceTokenCss,
   splitButtonStyle,
+  usesHideOn,
+  visibleBlocks,
+  visibleDeliveredLayout,
+  visibleLayoutStructure,
+  windowState,
   withButtonLookProps
 };
 //# sourceMappingURL=index.js.map