@bettercms-ai/types 1.36.0 → 1.38.0

package/dist/index.d.ts

@@ -129,6 +129,11 @@ interface FieldConfig {
     max?: number;
     /** date / datetime */
     includeTime?: boolean;
+    /**
+     * date / datetime with a time: "site" (the project's own zone) or an IANA zone name. When set,
+     * a stored value must carry `Z` or a numeric offset, so it names one instant in every region.
+     */
+    timezone?: string;
     /** modular: SLUGS of the kind='block' models this field accepts. Non-empty. */
     blockSlugs?: string[];
     /** modular: bounds on how many block instances the field may hold. */
@@ -201,6 +206,20 @@ interface FieldConfig {
  * field past that gate.
  */
 type ContentModelFieldPlacement = "cover" | "title" | "excerpt" | "body" | "inline" | "panel";
+/**
+ * Editor-only conditional visibility: the field (or component prop) shows only while the
+ * sibling keys its rules name hold these values. `isSet` reads no `value`: it passes once the
+ * source holds anything (`false` and `0` count; "", null and an empty list do not).
+ */
+interface ShowIfRule {
+    field: string;
+    op: "eq" | "neq" | "in" | "isSet";
+    value?: string | string[];
+}
+interface ShowIf {
+    match: "all" | "any";
+    rules: ShowIfRule[];
+}
 interface ContentModelField {
     key: string;
     label: string;
@@ -227,6 +246,18 @@ interface ContentModelField {
      * Field ORDER is the array index — there is deliberately no `order` property.
      */
     placement?: ContentModelFieldPlacement;
+    /** Editor-only conditional visibility; a hidden required field is not required. @see ShowIf */
+    showIf?: ShowIf;
+    /**
+     * A value another system owns (a store, job board or feed id).
+     * - `"developer"`: only a caller with schema authority (a key with `schema:manage`, a person
+     *   with schema access) may change the value on an entry, or add or remove this lock. Anyone
+     *   else is refused with 403 `FIELD_LOCKED`. Needs {@link lockReason}.
+     * - `true`: a marker the editor renders read-only. The API does not enforce it.
+     */
+    readOnly?: true | "developer";
+    /** Which system owns the value; shown on the refusal. At most 200 characters. */
+    lockReason?: string;
     /**
      * Authoring chrome — how the field PRESENTS in the editor. Never delivered, never read by a
      * renderer, and never able to move a value; the same contract as {@link placement}.
@@ -386,6 +417,14 @@ type ButtonSizeName = (typeof BUTTON_SIZES)[number];
  * object. Only `label` and `href` are required; every look key is optional and absent reads as
  * today's default (Primary, medium, no arrow, no icon, same tab).
  */
+declare const LINK_RELS: readonly ["nofollow", "sponsored", "ugc"];
+type LinkRel = (typeof LINK_RELS)[number];
+/**
+ * The target and rel attributes of an anchor, as one string. A new tab keeps the `noopener
+ * noreferrer` pair; a link relation joins it in the SAME rel attribute, so an anchor never
+ * carries two.
+ */
+declare function anchorTargetRel(newTab: boolean, rel?: unknown): string;
 interface ButtonValue {
     label: string;
     href: string;
@@ -394,14 +433,24 @@ interface ButtonValue {
     arrow?: boolean;
     icon?: ButtonIcon | null;
     newTab?: boolean;
+    /** Sponsored, untrusted or user-generated destination. Absent ⇒ no rel beyond a new tab's own. */
+    rel?: LinkRel;
 }
+/** A stored button value as it renders: `rel` stays optional, every other key is filled. */
+type ReadButtonValue = Required<Omit<ButtonValue, "rel">> & Pick<ButtonValue, "rel">;
 /** A stored button value as it renders: every key read through the same allow-lists as a block. */
-declare function readButtonValue(value: unknown): Required<ButtonValue>;
+declare function readButtonValue(value: unknown): ReadButtonValue;
 /** Why a value is not a button, or null when it is. Look keys are checked only when present. */
 declare function buttonValueProblem(value: unknown): string | null;
 /** The look keys an instance of a Button component may override, beside its label and link. */
 declare const BUTTON_LOOK_KEYS: readonly ["variant", "size", "arrow", "icon", "newTab"];
 type ButtonLookKey = (typeof BUTTON_LOOK_KEYS)[number];
+/**
+ * A `button` PROP's value as the `button` BLOCK props it writes, for every lane that applies an
+ * instance's overrides. `label` lands on `text`, and only the keys the value names come back, so
+ * an override carrying a label alone keeps the definition's href and look.
+ */
+declare function buttonBlockProps(value: unknown): Record<string, unknown>;
 interface PropDefLike {
     key: string;
     label?: string;
@@ -430,7 +479,7 @@ declare function withButtonLookProps<P extends PropDefLike>(def: ComponentLike<P
  * instance's overrides written onto it — for a site rendering the instance with `BcmsButton`.
  * Null when the component is not a Button (not category `button`, or not exactly one button).
  */
-declare function buttonValueOfInstance<P extends PropDefLike>(def: ComponentLike<P>, overrides: Record<string, unknown> | null | undefined): Required<ButtonValue> | null;
+declare function buttonValueOfInstance<P extends PropDefLike>(def: ComponentLike<P>, overrides: Record<string, unknown> | null | undefined): ReadButtonValue | null;
 
 /**
  * ContentBlock — a discriminated union of all CMS block types.
@@ -629,6 +678,8 @@ interface ButtonProps {
     icon?: ButtonIcon | null;
     /** Open the link in a new tab (`target="_blank" rel="noopener noreferrer"`). Absent ⇒ false. */
     newTab?: boolean;
+    /** `nofollow`, `sponsored` or `ugc`; joins the anchor's rel. Absent ⇒ none. */
+    rel?: "nofollow" | "sponsored" | "ugc";
 }
 interface ButtonBlock {
     type: "button";
@@ -832,6 +883,29 @@ interface CollectionProps {
     /** "newest" (default) reverses the reader's created_at ordering. */
     order?: "newest" | "oldest";
     emptyText?: string;
+    /**
+     * List the published entries of ANOTHER model, on any page ("latest posts" on the home page).
+     * Absent: the entries of the page this block sits on, as above. A model of another project or
+     * workspace lists nothing. A sourced block is always a card list, on a detail URL too.
+     */
+    source?: {
+        modelId: string;
+    };
+    /** Sourced lists only. The Delivery API's filter grammar; field keys are the model's own. */
+    filters?: CollectionFilter[];
+    /** Sourced lists only. The Delivery API's sort grammar (`-publishedAt,title`); wins over `order`. */
+    sort?: string;
+    /** Sourced lists only. Entry ids rendered first, in this order; counted against `limit`. */
+    pinnedIds?: string[];
+    /** Sourced lists only. On an entry's detail URL, leave that entry out ("related posts"). */
+    excludeCurrent?: boolean;
+}
+interface CollectionFilter {
+    /** A field key of the source model, or `slug`, `publishedAt`, `locale`. */
+    field: string;
+    op: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "in";
+    /** `in` takes a comma-separated list. */
+    value: string | number | boolean;
 }
 interface CollectionBlock {
     type: "collection";
@@ -1101,6 +1175,41 @@ declare function splitButtonStyle(style: BlockStyle | undefined): {
     placement: BlockStyle | undefined;
     paint: Record<string, string | number> | undefined;
 };
+/**
+ * The style keys a PAGE FIELD takes (`pages.field_styles`, keyed by field path): its width and
+ * placement, the space above and below it, and its text alignment, size and weight. A subset of
+ * `BlockStyle`, so every key keeps the token set and the CSS table it already has — a field never
+ * gets a second scale. 🔴 Twin: `FIELD_STYLE_KEYS` in the dashboard's fieldStyle.ts.
+ */
+declare const FIELD_STYLE_KEYS: readonly ["contentWidth", "contentAlign", "marginTop", "marginBottom", "align", "fontSize", "weight"];
+type FieldStyleKey = (typeof FIELD_STYLE_KEYS)[number];
+/** One field's style. */
+type FieldStyle = Pick<BlockStyle, FieldStyleKey>;
+/** A page's field styles, keyed by field path (the `data-bcms-field` address). */
+type FieldStyles = Record<string, FieldStyle>;
+/** Only the field keys of `style` (an empty object for none). */
+declare function pickFieldStyle(style: BlockStyle | Record<string, unknown> | null | undefined): FieldStyle;
+/**
+ * A field's declarations, for its OWN element (`fieldAttrs`). Spacing, alignment, size and weight are
+ * `blockStyleToCss`'s. The width is `blockStyleToInnerCss`'s column, drawn on the element itself —
+ * a field has no wrapper to nest a column in — so its placement becomes left/right margins, and
+ * the vertical margins the spacing set stay. `undefined` when nothing applies (no `style` at all).
+ */
+declare function fieldStyleToCss(style: BlockStyle | Record<string, unknown> | null | undefined): Record<string, string | number> | undefined;
+/**
+ * The content column (`contentWidth` placed by `contentAlign`, falling back to `align`) as the
+ * declarations for a box that IS the column — a site's own inner container (`sectionColumnAttrs`)
+ * or a field's own element (`fieldStyleToCss`). Same max-width table as `blockStyleToInnerCss`;
+ * the placement is left/right margins only, never the `margin` shorthand, so the box keeps its
+ * own vertical margins. `undefined` when there is no column (unset, `full`, unknown).
+ */
+declare function blockStyleToColumnCss(style: BlockStyle | undefined): {
+    maxWidth: string;
+    marginLeft: string;
+    marginRight: string;
+} | undefined;
+/** `fieldStyleToCss` as an inline `style` string (`paddingTop` → `padding-top`), "" when empty. */
+declare function fieldStyleCssText(style: BlockStyle | Record<string, unknown> | null | undefined): string;
 
 /**
  * Generated from lucide-react@1.8.0 dynamic icon names.
@@ -1520,7 +1629,7 @@ type ComponentCategory = "navbar" | "footer" | "button" | "section" | "slider" |
  *
  * Order is not semantic; append rather than re-sort, so a diff stays readable.
  */
-declare const COMPONENT_PROP_TYPES: readonly ["text", "richtext", "image", "url", "boolean", "number", "select", "group", "table", "slot", "form"];
+declare const COMPONENT_PROP_TYPES: readonly ["text", "richtext", "image", "url", "boolean", "number", "select", "group", "table", "slot", "form", "link", "button", "date", "color", "file", "icon", "multiselect"];
 type ComponentPropType = (typeof COMPONENT_PROP_TYPES)[number];
 /**
  * The value a `form` prop STORES: just the id. The form itself is a Form document and stays the
@@ -1562,6 +1671,14 @@ interface ComponentPropDef {
      *   select → one string from `config.options`
      *   group  → an object keyed by `config.fields`
      *   table  → an array of such objects (slider.slides)
+     *   link   → an href string (URL, internal path or #fragment)
+     *   button → ONE `ButtonValue` (button-look.ts): label, href and look as a unit, never a text prop plus
+     *            a url prop that drift apart. Targets the `props` of a `button` block.
+     *   date   → `YYYY-MM-DD`
+     *   color  → a hex colour (`#RGB`, `#RRGGBB`, `#RRGGBBAA`)
+     *   file   → `{ url, name?, size? }`, or a bare URL string
+     *   icon   → a BetterCMS icon name (`DOCK_ICON_NAMES`), or an uploaded icon as an image value
+     *   multiselect → a `string[]`, each one of `config.options`
      *
      * `reference` is absent on purpose: nothing resolves a content-entry id at component render
      * time, so such a prop would save cleanly and render as nothing.
@@ -1584,12 +1701,23 @@ interface ComponentPropDef {
     helpSource?: "auto" | "human" | "agent";
     /** Ghost text inside a text-ish control. */
     placeholder?: string;
+    /**
+     * Editor-only conditional visibility: show this prop's control only while sibling props (by
+     * key) hold these values. The save schema refuses a key no prop of the component declares.
+     */
+    showIf?: ShowIf;
+    /**
+     * The content-model field's `readOnly` / `lockReason` pair, as STORED MARKERS only: the
+     * editor may render the prop read-only, and no write of a prop value is refused for them.
+     */
+    readOnly?: true | "developer";
+    lockReason?: string;
     /** Per-type settings; the save schema enforces that each is present on the type needing it. */
     config?: {
         /** `slot` — a pick allowlist. */
         componentIds?: string[];
         /**
-         * `select` — the choices. Required, and a default must be one of them. `{ label, value }`
+         * `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).
          */
         options?: Array<string | {
@@ -2115,6 +2243,11 @@ interface DeliveryPage {
     metaJson: PageMetaJson | null;
     blocks: ContentBlock[];
     layout?: DeliveredLayout | null;
+    /**
+     * C3 — the page's field styles, keyed by field path (`pages.published_field_styles`; the draft
+     * copy on a preview read). Absent when the page styles no field. Feed to `fieldAttrs`.
+     */
+    fieldStyles?: FieldStyles;
     updatedAt: string | null;
     publishedAt: string | null;
     /** The page's language (`null`: the site's default) and, on a translation, the page it translates. */
@@ -2547,4 +2680,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 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, FOOTER_SECTION_ID, type FieldConfig, 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, 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 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 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 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, blockStyleToCss, blockStyleToInnerCss, buttonIconOf, buttonIconSvg, buttonLinkPairs, buttonValueOfInstance, buttonValueProblem, buttonVariantOf, candidateRole, componentInstanceAddresses, componentPropTargetKey, derivedPairs, dockBudget, dockScreens, expandBlockBindings, formatPropsAttribute, getBlockType, headingPaintCss, isBlock, isChromeLandmark, keyWords, landmarkRegions, locatorFor, parsePropsAttribute, 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, 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 };

package/dist/index.js

@@ -297,6 +297,30 @@ function splitButtonStyle(style) {
     paint: Object.keys(paint).length ? paint : void 0
   };
 }
+var FIELD_STYLE_KEYS = ["contentWidth", "contentAlign", "marginTop", "marginBottom", "align", "fontSize", "weight"];
+var FIELD_KEY_SET = new Set(FIELD_STYLE_KEYS);
+function pickFieldStyle(style) {
+  const out = {};
+  if (!style || typeof style !== "object") return out;
+  for (const [k, v] of Object.entries(style)) if (FIELD_KEY_SET.has(k) && v != null) out[k] = v;
+  return out;
+}
+function fieldStyleToCss(style) {
+  const picked = pickFieldStyle(style);
+  const css = { ...blockStyleToCss(picked) };
+  Object.assign(css, blockStyleToColumnCss(picked));
+  return Object.keys(css).length ? css : void 0;
+}
+function blockStyleToColumnCss(style) {
+  const column = blockStyleToInnerCss(style);
+  if (!column || !style) return void 0;
+  const placement = style.contentAlign ?? style.align;
+  return { maxWidth: column.maxWidth, marginLeft: placement === "left" ? "0" : "auto", marginRight: placement === "right" ? "0" : "auto" };
+}
+function fieldStyleCssText(style) {
+  const css = fieldStyleToCss(style);
+  return css ? Object.entries(css).map(([k, v]) => `${k.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`)}:${v}`).join(";") : "";
+}
 
 // src/component.ts
 var SECTION_DOCTRINE = "STRUCTURE (separate from schema): a page is composed of SECTIONS. NEVER build a page out of loose top-level heading/text/image/button/spacer blocks \u2014 they cannot be moved, duplicated or swapped as a unit, the visual editor cannot outline or name them, and every one of them becomes its own section in the editor. A hero of a headline, a lede and two CTAs is ONE section, not four. TWO SHAPES, and the choice is about REUSE. (1) A band that appears on more than one page, or that needs layout variants, is a COMPONENT with a `sectionType` \u2014 see create_component. Components sharing a `sectionType` are that section's VARIANTS (one Hero: 'Centered' for the home page and 'Two-column' for about, same prop keys so a swap keeps the content). This is also the only shape the editor's 'Add a section' picker can insert, and the only one that gets a family name and a variant switcher. (2) A genuinely one-off band on a single page is a `section` BLOCK whose `props.children` hold its blocks. THE TRADEOFF, stated in the present tense because it is real today: inside a component, ONLY the leaves a declared prop TARGETS are click-to-edit on the canvas \u2014 each declared prop's `target` is re-keyed to that PLACEMENT's own override address, so editing it changes this page and not the shared definition. A prop with no `target` still SHOWS as a dock control, but its override reaches no rendered slot, so editing it changes nothing on the page. Copy that no prop points at is worse still: no binding and no control, unreachable from click-to-edit AND from the dock, changeable only by editing the component definition, which rewrites every page that places it. A `section` block's children stay click-to-edit unconditionally. So when you choose a component, DECLARE A PROP \u2014 WITH A `target` \u2014 for every string, link and image a marketer will ever touch; a component with un-propped editable copy is the defect, not the component. In the dock an unset prop shows EMPTY and inherits the definition's default, so set props explicitly when you want the current copy visible there. An IMPORTED site's components are its own (read the repo); its nav, footer and modals are the Layout. On a blank site, do not hand-write a band's JSON: start from a built-in section blueprint (list_components returns locked `builtin:*` blueprints with no projectId \u2014 hero-centered, hero-split, feature-grid-three, cta-banner and nine more), each already rooted in a `section` block with its editable leaves declared as props. INLINE its blockJson as a `section` block for a one-off band; for a recurring band, materialize the blueprint with create_component so it becomes project-scoped before implementation validation, Output or publication. Direct `builtin:*` component references exist only for legacy delivery compatibility. Two consecutive call-to-action buttons are two sibling `button` blocks inside the same section \u2014 never a `columns` block, which is a `repeat(N,1fr)` grid and would stretch each CTA to half the container. Buttons are inline-level and flow side by side on their own.";
@@ -311,7 +335,16 @@ var COMPONENT_PROP_TYPES = [
   "group",
   "table",
   "slot",
-  "form"
+  "form",
+  // The seven below each store what the same-named content-model FIELD stores (`icon` and
+  // `multiselect` have no field twin; see the value notes on ComponentPropDef.type).
+  "link",
+  "button",
+  "date",
+  "color",
+  "file",
+  "icon",
+  "multiselect"
 ];
 
 // src/layout-lucide-icons.ts
@@ -2786,6 +2819,11 @@ function buttonIconSvg(name, cls) {
   return iconSvg(name, cls);
 }
 var BUTTON_SIZES = ["sm", "md", "lg"];
+var LINK_RELS = ["nofollow", "sponsored", "ugc"];
+function anchorTargetRel(newTab, rel) {
+  const tokens = [...newTab ? ["noopener", "noreferrer"] : [], ...LINK_RELS.includes(rel) ? [rel] : []];
+  return `${newTab ? ' target="_blank"' : ""}${tokens.length ? ` rel="${tokens.join(" ")}"` : ""}`;
+}
 var hrefOf = (href) => typeof href === "string" ? href : href && typeof href === "object" && typeof href.href === "string" ? href.href : null;
 function readButtonValue(value) {
   const v = value && typeof value === "object" ? value : {};
@@ -2796,7 +2834,8 @@ function readButtonValue(value) {
     size: BUTTON_SIZES.includes(v.size) ? v.size : "md",
     arrow: v.arrow === true,
     icon: buttonIconOf(v.icon),
-    newTab: v.newTab === true
+    newTab: v.newTab === true,
+    ...LINK_RELS.includes(v.rel) ? { rel: v.rel } : {}
   };
 }
 function buttonValueProblem(value) {
@@ -2808,10 +2847,21 @@ function buttonValueProblem(value) {
   if (v.size !== void 0 && !BUTTON_SIZES.includes(v.size)) return `has an unknown size "${String(v.size)}"`;
   if (v.arrow !== void 0 && typeof v.arrow !== "boolean") return "arrow must be true or false";
   if (v.newTab !== void 0 && typeof v.newTab !== "boolean") return "newTab must be true or false";
+  if (v.rel !== void 0 && !LINK_RELS.includes(v.rel)) return `has an unknown rel "${String(v.rel)}" (nofollow, sponsored or ugc)`;
   if (v.icon !== void 0 && v.icon !== null && buttonIconOf(v.icon) === null) return `has an unknown icon "${String(v.icon)}"`;
   return null;
 }
 var BUTTON_LOOK_KEYS = ["variant", "size", "arrow", "icon", "newTab"];
+function buttonBlockProps(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const v = value;
+  const out = {};
+  if (typeof v.label === "string") out.text = v.label;
+  const href = hrefOf(v.href);
+  if (href !== null) out.href = href;
+  for (const key of BUTTON_LOOK_KEYS) if (key in v) out[key] = v[key];
+  return out;
+}
 function soleButtonId(blockJson) {
   const ids = [];
   const walk = (list) => {
@@ -2854,8 +2904,9 @@ function buttonValueOfInstance(def, overrides) {
   walk(def.blockJson);
   const props = { ...found[0]?.props ?? {} };
   for (const p of withButtonLookProps(def)) {
-    if (p.target.blockId !== blockId || !p.target.path.startsWith("props.") || !overrides || !(p.key in overrides)) continue;
-    props[p.target.path.slice("props.".length)] = overrides[p.key];
+    if (p.target.blockId !== blockId || !overrides || !(p.key in overrides)) continue;
+    if (p.type === "button") Object.assign(props, buttonBlockProps(overrides[p.key]));
+    else if (p.target.path.startsWith("props.")) props[p.target.path.slice("props.".length)] = overrides[p.key];
   }
   return readButtonValue({ ...props, label: props.text });
 }
@@ -2933,10 +2984,12 @@ export {
   DOCK_BUDGET,
   DOCK_ICON_NAMES,
   DOCK_ICON_NAME_SET,
+  FIELD_STYLE_KEYS,
   FOOTER_SECTION_ID,
   LANDMARK_SELECTOR,
   LAYOUT_SECTION_ICONS,
   LAYOUT_SECTION_ICON_SET,
+  LINK_RELS,
   MAIN_SELECTOR,
   NAVIGATION_SECTION_ID,
   PAGE_CONTENT_ANCHOR_ID,
@@ -2944,8 +2997,11 @@ export {
   SECTION_SPACE_TOKENS,
   SPACE_BOTTOM_TOKENS,
   SPACE_STEP_TOKENS,
+  anchorTargetRel,
+  blockStyleToColumnCss,
   blockStyleToCss,
   blockStyleToInnerCss,
+  buttonBlockProps,
   buttonIconOf,
   buttonIconSvg,
   buttonLinkPairs,
@@ -2959,6 +3015,8 @@ export {
   dockBudget,
   dockScreens,
   expandBlockBindings,
+  fieldStyleCssText,
+  fieldStyleToCss,
   formatPropsAttribute,
   getBlockType,
   headingPaintCss,
@@ -2968,6 +3026,7 @@ export {
   landmarkRegions,
   locatorFor,
   parsePropsAttribute,
+  pickFieldStyle,
   readButtonValue,
   readPath,
   regionOf,