Listing Grid

{
  "id": "block-doc-program-grid-data-long-copy-stress",
  "block_type": "program-grid",
  "props": {
    "appearance": {
      "preset": "block"
    },
    "title": "Listing Grid with a realistic CMS-authored headline that wraps cleanly across compact cards, mobile panels, and generated documentation frames",
    "description": "This intentionally longer copy uses normal words, punctuation, and CMS-style details so the block proves it can remain polished with production-length titles, helper text, labels, badges, links, and nested content.",
    "listing_type": "program",
    "query_placeholder": "Search listings",
    "provider": "local-fallback",
    "filters": [
      {
        "label": "Open now",
        "value": "open"
      },
      {
        "label": "Nearby",
        "value": "nearby"
      },
      {
        "label": "Featured",
        "value": "featured"
      }
    ],
    "sort_options": [
      {
        "label": "Recommended",
        "value": "recommended"
      },
      {
        "label": "Newest",
        "value": "newest"
      }
    ],
    "listings": [
      {
        "title": "Featured match",
        "description": "A structured listing result with source metadata.",
        "location": "Phoenix, AZ",
        "availability": "Open",
        "price": "$1,250",
        "tags": [
          "featured"
        ],
        "src": "https://storage.googleapis.com/msgsndr/T3RhpcTQAq7Qb47kPQAB/media/677815b8c290c684d5bf3fbd.png",
        "alt": "Cloud Elephants Essential CTO service visual.",
        "href": "#block-preview",
        "sources": [
          {
            "title": "Listing index",
            "citation_label": "Local data"
          }
        ]
      },
      {
        "title": "Second match",
        "description": "Another reusable listing item for grid and API smoke.",
        "location": "Remote",
        "availability": "Review",
        "price": "$980",
        "tags": [
          "query-backed"
        ],
        "href": "#block-preview"
      },
      {
        "title": "Source-backed match",
        "description": "Metadata fields are searched locally and preserved for API payloads.",
        "location": "Hybrid",
        "eligibility": "Review required",
        "deadline": "Rolling",
        "tags": [
          "metadata"
        ],
        "href": "#block-preview"
      }
    ],
    "recommendations": [
      {
        "title": "Ask for a match review",
        "description": "Recommendation payloads can reuse listing cards with human-review language.",
        "location": "Guided",
        "availability": "On request"
      }
    ],
    "sources": [
      {
        "title": "Listing demo index",
        "citation_label": "Generated fixture"
      }
    ],
    "disclaimer": "Demo listings are inquiry-only and require provider confirmation before action.",
    "headline": "Listing Grid with a realistic CMS-authored headline that wraps cleanly across compact cards, mobile panels, and generated documentation frames",
    "subtitle": "This intentionally longer copy uses normal words, punctuation, and CMS-style details so the block proves it can remain polished with production-length titles, helper text, labels, badges, links, and nested content.",
    "caption": "Replaceable media caption with enough source context to wrap onto multiple lines without crowding adjacent controls.",
    "buttonText": "Continue with the guided CMS review"
  },
  "metadata": {
    "long_copy_tolerance": true,
    "awkward_content_tolerance": true,
    "composition_recipe": {
      "id": "long-copy-stress",
      "intent": "stress",
      "label": "Long Copy Stress",
      "recipe": "editorial-block-system",
      "source": "block-explorer",
      "quality_proof": [
        "long_copy_tolerance",
        "awkward_content_tolerance"
      ],
      "composition_passport": {
        "id": "long-copy-stress",
        "label": "Long Copy Stress composition passport",
        "intent": "stress",
        "recipe": "editorial-block-system",
        "authoring_mode": "stress-test",
        "complexity": "high",
        "fit": "Use to verify program-grid long copy, awkward values, and wrapping before publishing customer pages.",
        "required_regions": [
          "surface",
          "copy",
          "feedback"
        ],
        "optional_regions": [
          "media",
          "actions",
          "controls"
        ],
        "slots": [
          {
            "id": "surface",
            "label": "Surface",
            "required": true,
            "field_count": 1,
            "editable_count": 0,
            "token_roles": [
              "background",
              "panel",
              "panelElevated",
              "border"
            ],
            "summary": "program-grid uses recipe surface tokens to keep the outer frame styled and composable."
          },
          {
            "id": "copy",
            "label": "Copy",
            "required": true,
            "field_count": 13,
            "editable_count": 13,
            "token_roles": [
              "text",
              "textMuted"
            ],
            "summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
          },
          {
            "id": "media",
            "label": "Media",
            "required": false,
            "field_count": 2,
            "editable_count": 2,
            "token_roles": [
              "panelElevated",
              "border"
            ],
            "summary": "Media fields stay isolated from copy and action regions so replacement assets preserve the recipe layout."
          },
          {
            "id": "actions",
            "label": "Actions",
            "required": false,
            "field_count": 5,
            "editable_count": 2,
            "token_roles": [
              "button",
              "buttonText",
              "signal",
              "uplink"
            ],
            "summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
          },
          {
            "id": "controls",
            "label": "Controls",
            "required": false,
            "field_count": 7,
            "editable_count": 2,
            "token_roles": [
              "control",
              "controlText",
              "border"
            ],
            "summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
          },
          {
            "id": "feedback",
            "label": "Feedback",
            "required": true,
            "field_count": 0,
            "editable_count": 0,
            "token_roles": [
              "badge",
              "badgeText",
              "signal"
            ],
            "summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
          }
        ],
        "builder_field_count": 36,
        "editable_field_count": 35,
        "action_count": 3,
        "control_count": 5,
        "replacement_guidance": [
          "Keep Editorial Block System recipe tokens as the source of visual styling for the surface, text, controls, and actions.",
          "Replace media URLs through the CMS media library and preserve alt, title, provider, or label fallbacks.",
          "Verify each action keeps either a valid href or canonical event name plus an editor-visible label.",
          "Verify control labels, required state, choices, and submission metadata before publishing.",
          "The recipe does not require repeatable collection editing."
        ],
        "publish_checklist": [
          "Validate program-grid against its block contract before publishing.",
          "3 required anatomy regions remain present: surface, copy, feedback.",
          "35/36 builder fields are CMS-editable or intentionally locked.",
          "Interactive labels, target size, href/event wiring, and disabled states have been reviewed.",
          "Phone, tablet, and desktop responsive behavior maps have been reviewed for wrapping and overflow.",
          "Contrast checks meet the AA recipe target."
        ],
        "agent_notes": [
          "Prefer editing props fields described by the builder field map; metadata is evidence, not primary content.",
          "Preserve recipe_alignment token roles unless the page theme or recipe changes intentionally.",
          "Use the anatomy slots to compose or replace content without changing the block type."
        ],
        "summary": "Long Copy Stress is a high-complexity stress-test recipe with 6 documented composition slots."
      },
      "composition_passport_complexity": "high",
      "composition_passport_authoring_mode": "stress-test",
      "composition_passport_slots": [
        "surface",
        "copy",
        "media",
        "actions",
        "controls",
        "feedback"
      ],
      "composition_passport_check_count": 6,
      "visual_polish_check_count": 6,
      "visual_polish_pass_count": 6,
      "visual_polish_checks": [
        {
          "id": "surface-rhythm",
          "label": "Surface rhythm",
          "axis": "layout",
          "status": "ready",
          "token_roles": [
            "background",
            "panel",
            "panelElevated",
            "border"
          ],
          "evidence": "editorial treatment uses spacious density and 8px radius base.",
          "summary": "program-grid keeps a stable recipe surface with panel, border, and spacing roles instead of ad hoc wrappers."
        },
        {
          "id": "type-hierarchy",
          "label": "Type hierarchy",
          "axis": "typography",
          "status": "ready",
          "token_roles": [
            "text",
            "textMuted",
            "badgeText"
          ],
          "evidence": "6/6 contrast checks pass the AA target.",
          "summary": "Primary, muted, and badge text roles stay distinct enough for headings, body copy, metadata, and helper text."
        },
        {
          "id": "action-clarity",
          "label": "Action clarity",
          "axis": "interaction",
          "status": "ready",
          "token_roles": [
            "button",
            "buttonText",
            "control",
            "controlText",
            "signal",
            "uplink"
          ],
          "evidence": "3 action surfaces and 5 control surfaces mapped.",
          "summary": "Interactive regions use recipe action/control tokens and preserve labels, hrefs, events, required state, and options."
        },
        {
          "id": "media-treatment",
          "label": "Media treatment",
          "axis": "media",
          "status": "ready",
          "token_roles": [
            "panelElevated",
            "border",
            "textMuted"
          ],
          "evidence": "Media region is isolated with replaceable fields.",
          "summary": "Replaceable media stays framed separately from copy and action regions so asset swaps preserve the layout."
        },
        {
          "id": "state-feedback",
          "label": "State feedback",
          "axis": "state",
          "status": "ready",
          "token_roles": [
            "badge",
            "badgeText",
            "signal"
          ],
          "evidence": "6 state-readiness entries include default, empty, pending, active, invalid, disabled.",
          "summary": "Feedback, selected, loading, invalid, and disabled treatments use visible state evidence instead of color-only meaning."
        },
        {
          "id": "responsive-balance",
          "label": "Responsive balance",
          "axis": "responsive",
          "status": "ready",
          "token_roles": [
            "panel",
            "border",
            "control"
          ],
          "evidence": "single-column stack phone behavior, two-column adaptive grid tablet behavior, and responsive composition grid desktop behavior documented.",
          "summary": "Phone, tablet, and desktop defaults have explicit stack, wrap, media, and overflow policies for the recipe."
        }
      ],
      "visual_polish_axes": [
        "layout",
        "typography",
        "interaction",
        "media",
        "state",
        "responsive"
      ],
      "default_provenance_count": 36,
      "default_provenance_map": [
        {
          "path": "appearance",
          "label": "Appearance",
          "field_role": "style",
          "value_type": "object",
          "editable": false,
          "repeated": false,
          "default_source": "Editorial Block System recipe tokens",
          "replacement_policy": "locked-token",
          "replacement_risk": "medium",
          "guardrail": "Keep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes.",
          "validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
          "summary": "Appearance defaults from Editorial Block System recipe tokens; replacement is medium risk with locked-token policy."
        },
        {
          "path": "title",
          "label": "Title",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Title defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "description",
          "label": "Description",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Description defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "listing_type",
          "label": "Listing Type",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listing Type defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "query_placeholder",
          "label": "Query Placeholder",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Query Placeholder defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "provider",
          "label": "Provider",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "requires-alt-text",
          "replacement_risk": "medium",
          "guardrail": "Replace the asset through CMS media data and keep alt, title, provider, or label fallback text meaningful.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Provider defaults from cloneable block recipe payload; replacement is medium risk with requires-alt-text policy."
        },
        {
          "path": "filters",
          "label": "Filters",
          "field_role": "content",
          "value_type": "array",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Filters defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "filters[].label",
          "label": "Filters Item Label",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Filters Item Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "filters[].value",
          "label": "Filters Item Value",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Filters Item Value defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "sort_options",
          "label": "Sort Options",
          "field_role": "form",
          "value_type": "array",
          "editable": true,
          "repeated": false,
          "default_source": "CMS form schema or tenant data-capture defaults",
          "replacement_policy": "requires-control-options",
          "replacement_risk": "high",
          "guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
          "validation": "Form fields should preserve labels, required state, options, and submission metadata.",
          "summary": "Sort Options defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
        },
        {
          "path": "sort_options[].label",
          "label": "Sort Options Item Label",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "requires-control-options",
          "replacement_risk": "high",
          "guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Sort Options Item Label defaults from cloneable block recipe payload; replacement is high risk with requires-control-options policy."
        },
        {
          "path": "sort_options[].value",
          "label": "Sort Options Item Value",
          "field_role": "form",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "CMS form schema or tenant data-capture defaults",
          "replacement_policy": "requires-control-options",
          "replacement_risk": "high",
          "guardrail": "Preserve control labels, required state, choices, submission metadata, and validation copy.",
          "validation": "Form fields should preserve labels, required state, options, and submission metadata.",
          "summary": "Sort Options Item Value defaults from CMS form schema or tenant data-capture defaults; replacement is high risk with requires-control-options policy."
        },
        {
          "path": "listings",
          "label": "Listings",
          "field_role": "content",
          "value_type": "array",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listings defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "listings[].title",
          "label": "Listings Item Title",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Listings Item Title defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].description",
          "label": "Listings Item Description",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Listings Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].location",
          "label": "Listings Item Location",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listings Item Location defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].availability",
          "label": "Listings Item Availability",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listings Item Availability defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].price",
          "label": "Listings Item Price",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listings Item Price defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].tags",
          "label": "Listings Item Tags",
          "field_role": "proof",
          "value_type": "array",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Proof fields should keep labels, values, and status text visible without color-only meaning.",
          "summary": "Listings Item Tags defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "listings[].src",
          "label": "Listings Item Src",
          "field_role": "media",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "Cloud Elephants placeholder media or CMS media library",
          "replacement_policy": "requires-alt-text",
          "replacement_risk": "medium",
          "guardrail": "Replace the asset through CMS media data and keep alt, title, provider, or label fallback text meaningful.",
          "validation": "Media should use a replaceable URL plus meaningful alt, label, or title fallback.",
          "summary": "Listings Item Src defaults from Cloud Elephants placeholder media or CMS media library; replacement is medium risk with requires-alt-text policy."
        },
        {
          "path": "listings[].alt",
          "label": "Listings Item Alt",
          "field_role": "media",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "Cloud Elephants placeholder media or CMS media library",
          "replacement_policy": "requires-alt-text",
          "replacement_risk": "medium",
          "guardrail": "Replace the asset through CMS media data and keep alt, title, provider, or label fallback text meaningful.",
          "validation": "Media should use a replaceable URL plus meaningful alt, label, or title fallback.",
          "summary": "Listings Item Alt defaults from Cloud Elephants placeholder media or CMS media library; replacement is medium risk with requires-alt-text policy."
        },
        {
          "path": "listings[].href",
          "label": "Listings Item Href",
          "field_role": "action",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "CMS route, URL, or canonical postEvent path",
          "replacement_policy": "requires-action-target",
          "replacement_risk": "high",
          "guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
          "validation": "Actions should resolve to a URL or event name with a human-readable label.",
          "summary": "Listings Item Href defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
        },
        {
          "path": "listings[].sources",
          "label": "Listings Item Sources",
          "field_role": "content",
          "value_type": "array",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Listings Item Sources defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "recommendations",
          "label": "Recommendations",
          "field_role": "content",
          "value_type": "array",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Recommendations defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "recommendations[].title",
          "label": "Recommendations Item Title",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Recommendations Item Title defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "recommendations[].description",
          "label": "Recommendations Item Description",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Recommendations Item Description defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "recommendations[].location",
          "label": "Recommendations Item Location",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Recommendations Item Location defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "recommendations[].availability",
          "label": "Recommendations Item Availability",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Recommendations Item Availability defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "sources",
          "label": "Sources",
          "field_role": "content",
          "value_type": "array",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Sources defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "sources[].title",
          "label": "Sources Item Title",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Sources Item Title defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "sources[].citation_label",
          "label": "Sources Item Citation Label",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": true,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "collection-item",
          "replacement_risk": "medium",
          "guardrail": "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Sources Item Citation Label defaults from cloneable block recipe payload; replacement is medium risk with collection-item policy."
        },
        {
          "path": "disclaimer",
          "label": "Disclaimer",
          "field_role": "content",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "summary": "Disclaimer defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "headline",
          "label": "Headline",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Headline defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "subtitle",
          "label": "Subtitle",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Subtitle defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "caption",
          "label": "Caption",
          "field_role": "copy",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "cloneable block recipe payload",
          "replacement_policy": "safe-to-edit",
          "replacement_risk": "low",
          "guardrail": "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "summary": "Caption defaults from cloneable block recipe payload; replacement is low risk with safe-to-edit policy."
        },
        {
          "path": "buttonText",
          "label": "ButtonText",
          "field_role": "action",
          "value_type": "string",
          "editable": true,
          "repeated": false,
          "default_source": "CMS route, URL, or canonical postEvent path",
          "replacement_policy": "requires-action-target",
          "replacement_risk": "high",
          "guardrail": "Keep the label paired with a valid href or canonical postEvent event name before publishing.",
          "validation": "Actions should resolve to a URL or event name with a human-readable label.",
          "summary": "ButtonText defaults from CMS route, URL, or canonical postEvent path; replacement is high risk with requires-action-target policy."
        }
      ],
      "default_replacement_policies": [
        "collection-item",
        "locked-token",
        "requires-action-target",
        "requires-alt-text",
        "requires-control-options",
        "safe-to-edit"
      ],
      "default_replacement_risks": [
        "high",
        "low",
        "medium"
      ],
      "default_replacement_high_risk_count": 5,
      "content_edit_bundle_count": 7,
      "content_edit_bundles": [
        {
          "id": "copy",
          "label": "Copy bundle",
          "intent": "required",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "caption",
            "description",
            "filters[].label",
            "headline",
            "listings[].description",
            "listings[].title",
            "recommendations[].description",
            "recommendations[].title",
            "sort_options[].label",
            "sources[].citation_label",
            "sources[].title",
            "subtitle",
            "title"
          ],
          "default_sources": [
            "cloneable block recipe payload"
          ],
          "guardrails": [
            "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
            "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
            "Preserve control labels, required state, choices, submission metadata, and validation copy."
          ],
          "depends_on": [
            "type hierarchy",
            "mobile wrapping"
          ],
          "summary": "Copy bundle groups 13 fields so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "media",
          "label": "Media bundle",
          "intent": "recommended",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "listings[].alt",
            "listings[].src"
          ],
          "default_sources": [
            "Cloud Elephants placeholder media or CMS media library"
          ],
          "guardrails": [
            "Replace the asset through CMS media data and keep alt, title, provider, or label fallback text meaningful."
          ],
          "depends_on": [
            "copy alt text",
            "responsive fit"
          ],
          "summary": "Media bundle groups 2 fields so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "actions",
          "label": "Action bundle",
          "intent": "recommended",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "buttonText",
            "listings[].href"
          ],
          "default_sources": [
            "CMS route, URL, or canonical postEvent path"
          ],
          "guardrails": [
            "Keep the label paired with a valid href or canonical postEvent event name before publishing."
          ],
          "depends_on": [
            "copy labels",
            "href or event target",
            "state readiness"
          ],
          "summary": "Action bundle groups 2 fields so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "controls",
          "label": "Control bundle",
          "intent": "recommended",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "sort_options",
            "sort_options[].value"
          ],
          "default_sources": [
            "CMS form schema or tenant data-capture defaults"
          ],
          "guardrails": [
            "Preserve control labels, required state, choices, submission metadata, and validation copy."
          ],
          "depends_on": [
            "field labels",
            "required state",
            "disabled state"
          ],
          "summary": "Control bundle groups 2 fields so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "proof",
          "label": "Proof bundle",
          "intent": "recommended",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "listings[].tags"
          ],
          "default_sources": [
            "cloneable block recipe payload"
          ],
          "guardrails": [
            "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape."
          ],
          "depends_on": [
            "copy labels",
            "contrast proof"
          ],
          "summary": "Proof bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "style",
          "label": "Style bundle",
          "intent": "guarded",
          "edit_mode": "guarded-system",
          "field_paths": [
            "appearance"
          ],
          "default_sources": [
            "Editorial Block System recipe tokens"
          ],
          "guardrails": [
            "Keep visual styling aligned to Editorial Block System recipe tokens unless the recipe itself changes."
          ],
          "depends_on": [
            "theme recipe tokens",
            "contrast proof"
          ],
          "summary": "Style bundle groups 1 field so CMS edits preserve the recipe shape and default polish."
        },
        {
          "id": "content",
          "label": "Content bundle",
          "intent": "required",
          "edit_mode": "repeatable-items",
          "field_paths": [
            "disclaimer",
            "filters",
            "filters[].value",
            "listing_type",
            "listings",
            "listings[].availability",
            "listings[].location",
            "listings[].price",
            "listings[].sources",
            "provider",
            "query_placeholder",
            "recommendations",
            "recommendations[].availability",
            "recommendations[].location",
            "sources"
          ],
          "default_sources": [
            "cloneable block recipe payload"
          ],
          "guardrails": [
            "Copy can be edited directly when text remains trimmed, localizable, and safe to wrap at phone widths.",
            "Edit repeatable items through collection controls so add, remove, reorder, and item-level updates preserve shape.",
            "Replace the asset through CMS media data and keep alt, title, provider, or label fallback text meaningful."
          ],
          "depends_on": [
            "contract-safe JSON"
          ],
          "summary": "Content bundle groups 15 fields so CMS edits preserve the recipe shape and default polish."
        }
      ],
      "content_edit_bundle_ids": [
        "copy",
        "media",
        "actions",
        "controls",
        "proof",
        "style",
        "content"
      ],
      "content_edit_bundle_modes": [
        "guarded-system",
        "repeatable-items"
      ],
      "content_edit_bundle_required_count": 2,
      "content_edit_bundle_guarded_count": 1,
      "recipe_compatibility_count": 6,
      "recipe_compatibility_map": [
        {
          "id": "page-context",
          "label": "Page context",
          "axis": "page",
          "fit": "supporting",
          "values": [
            "funnel",
            "contact",
            "service-page",
            "listing",
            "product-page",
            "product-announcement"
          ],
          "evidence": "6 page types mapped for program-grid.",
          "guardrail": "Choose the first matching page type before editing copy, media, or actions so the recipe starts in the right narrative context.",
          "summary": "program-grid is best composed into funnel, contact, service-page, and related pages."
        },
        {
          "id": "section-role",
          "label": "Section role",
          "axis": "layout",
          "fit": "primary",
          "values": [
            "conversion",
            "collection",
            "media",
            "content",
            "form-controls"
          ],
          "evidence": "6 anatomy regions produce 5 section roles.",
          "guardrail": "Place the block where its required anatomy regions have enough room before compressing it into dense page slots.",
          "summary": "program-grid can act as conversion, collection, media within a composed page."
        },
        {
          "id": "content-model",
          "label": "Content model",
          "axis": "content",
          "fit": "specialized",
          "values": [
            "copy-led",
            "media-led",
            "cta-led",
            "input-led"
          ],
          "evidence": "35/36 fields are editable across 4 content models.",
          "guardrail": "Keep the content model stable when replacing defaults; do not turn a repeatable or media-led recipe into unrelated ad hoc content.",
          "summary": "Long Copy Stress composition passport is copy-led, media-led, cta-led, input-led for CMS composition."
        },
        {
          "id": "interaction-model",
          "label": "Interaction model",
          "axis": "interaction",
          "fit": "primary",
          "values": [
            "link-link",
            "text"
          ],
          "evidence": "3 action surfaces and 5 control surfaces mapped.",
          "guardrail": "Review href, event, input, required, and disabled-state evidence before publishing an interactive recipe.",
          "summary": "program-grid carries link-link, text interaction affordances."
        },
        {
          "id": "authoring-fit",
          "label": "Authoring fit",
          "axis": "authoring",
          "fit": "specialized",
          "values": [
            "stress-test",
            "high-complexity",
            "5-high-care-replacements"
          ],
          "evidence": "36 default provenance items with 5 high-care replacements.",
          "guardrail": "Use the default provenance map before cloning the recipe into CMS content or agent-generated page data.",
          "summary": "program-grid uses stress-test authoring with high complexity."
        },
        {
          "id": "responsive-fit",
          "label": "Responsive fit",
          "axis": "responsive",
          "fit": "primary",
          "values": [
            "single-column stack",
            "two-column adaptive grid",
            "responsive composition grid",
            "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke."
          ],
          "evidence": "3 responsive behavior maps cover phone, tablet, and desktop composition.",
          "guardrail": "Review phone wrapping, tablet mid-width balance, and desktop density before adding nested content, longer labels, or extra media.",
          "summary": "program-grid has explicit phone, tablet, and desktop compatibility evidence for composed pages."
        }
      ],
      "recipe_compatibility_axes": [
        "page",
        "layout",
        "content",
        "interaction",
        "authoring",
        "responsive"
      ],
      "recipe_compatibility_page_types": [
        "funnel",
        "contact",
        "service-page",
        "listing",
        "product-page",
        "product-announcement"
      ],
      "recipe_compatibility_section_roles": [
        "conversion",
        "collection",
        "media",
        "content",
        "form-controls"
      ],
      "recipe_compatibility_fits": [
        "primary",
        "specialized",
        "supporting"
      ],
      "builder_field_count": 36,
      "builder_field_map": [
        {
          "path": "appearance",
          "label": "Appearance",
          "value_type": "object",
          "role": "style",
          "editable": false,
          "repeated": false,
          "summary": "Appearance is a object field used for style."
        },
        {
          "path": "title",
          "label": "Title",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": false,
          "summary": "Title is a string field used for copy."
        },
        {
          "path": "description",
          "label": "Description",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": false,
          "summary": "Description is a string field used for copy."
        },
        {
          "path": "listing_type",
          "label": "Listing Type",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Listing Type is a string field used for content."
        },
        {
          "path": "query_placeholder",
          "label": "Query Placeholder",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Query Placeholder is a string field used for content."
        },
        {
          "path": "provider",
          "label": "Provider",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Provider is a string field used for content."
        },
        {
          "path": "filters",
          "label": "Filters",
          "value_type": "array",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Filters is a array field used for content."
        },
        {
          "path": "filters[].label",
          "label": "Filters Item Label",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Filters Item Label is a string collection field used for copy."
        },
        {
          "path": "filters[].value",
          "label": "Filters Item Value",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Filters Item Value is a string collection field used for content."
        },
        {
          "path": "sort_options",
          "label": "Sort Options",
          "value_type": "array",
          "role": "form",
          "editable": true,
          "repeated": false,
          "summary": "Sort Options is a array field used for form."
        },
        {
          "path": "sort_options[].label",
          "label": "Sort Options Item Label",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Sort Options Item Label is a string collection field used for copy."
        },
        {
          "path": "sort_options[].value",
          "label": "Sort Options Item Value",
          "value_type": "string",
          "role": "form",
          "editable": true,
          "repeated": true,
          "summary": "Sort Options Item Value is a string collection field used for form."
        },
        {
          "path": "listings",
          "label": "Listings",
          "value_type": "array",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Listings is a array field used for content."
        },
        {
          "path": "listings[].title",
          "label": "Listings Item Title",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Title is a string collection field used for copy."
        },
        {
          "path": "listings[].description",
          "label": "Listings Item Description",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Description is a string collection field used for copy."
        },
        {
          "path": "listings[].location",
          "label": "Listings Item Location",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Location is a string collection field used for content."
        },
        {
          "path": "listings[].availability",
          "label": "Listings Item Availability",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Availability is a string collection field used for content."
        },
        {
          "path": "listings[].price",
          "label": "Listings Item Price",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Price is a string collection field used for content."
        },
        {
          "path": "listings[].tags",
          "label": "Listings Item Tags",
          "value_type": "array",
          "role": "proof",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Tags is a array collection field used for proof."
        },
        {
          "path": "listings[].src",
          "label": "Listings Item Src",
          "value_type": "string",
          "role": "media",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Src is a string collection field used for media."
        },
        {
          "path": "listings[].alt",
          "label": "Listings Item Alt",
          "value_type": "string",
          "role": "media",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Alt is a string collection field used for media."
        },
        {
          "path": "listings[].href",
          "label": "Listings Item Href",
          "value_type": "string",
          "role": "action",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Href is a string collection field used for action."
        },
        {
          "path": "listings[].sources",
          "label": "Listings Item Sources",
          "value_type": "array",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Listings Item Sources is a array collection field used for content."
        },
        {
          "path": "recommendations",
          "label": "Recommendations",
          "value_type": "array",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Recommendations is a array field used for content."
        },
        {
          "path": "recommendations[].title",
          "label": "Recommendations Item Title",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Recommendations Item Title is a string collection field used for copy."
        },
        {
          "path": "recommendations[].description",
          "label": "Recommendations Item Description",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Recommendations Item Description is a string collection field used for copy."
        },
        {
          "path": "recommendations[].location",
          "label": "Recommendations Item Location",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Recommendations Item Location is a string collection field used for content."
        },
        {
          "path": "recommendations[].availability",
          "label": "Recommendations Item Availability",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": true,
          "summary": "Recommendations Item Availability is a string collection field used for content."
        },
        {
          "path": "sources",
          "label": "Sources",
          "value_type": "array",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Sources is a array field used for content."
        },
        {
          "path": "sources[].title",
          "label": "Sources Item Title",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Sources Item Title is a string collection field used for copy."
        },
        {
          "path": "sources[].citation_label",
          "label": "Sources Item Citation Label",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": true,
          "summary": "Sources Item Citation Label is a string collection field used for copy."
        },
        {
          "path": "disclaimer",
          "label": "Disclaimer",
          "value_type": "string",
          "role": "content",
          "editable": true,
          "repeated": false,
          "summary": "Disclaimer is a string field used for content."
        },
        {
          "path": "headline",
          "label": "Headline",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": false,
          "summary": "Headline is a string field used for copy."
        },
        {
          "path": "subtitle",
          "label": "Subtitle",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": false,
          "summary": "Subtitle is a string field used for copy."
        },
        {
          "path": "caption",
          "label": "Caption",
          "value_type": "string",
          "role": "copy",
          "editable": true,
          "repeated": false,
          "summary": "Caption is a string field used for copy."
        },
        {
          "path": "buttonText",
          "label": "ButtonText",
          "value_type": "string",
          "role": "action",
          "editable": true,
          "repeated": false,
          "summary": "ButtonText is a string field used for action."
        }
      ],
      "editor_guidance_count": 7,
      "editor_guidance_map": [
        {
          "id": "copy",
          "label": "Copy",
          "field_role": "copy",
          "field_count": 13,
          "editable_count": 13,
          "editor_widget": "text/rich-text editor",
          "validation": "Text should be editable, trimmed, localizable, and safe to wrap at mobile widths.",
          "default_source": "cloneable block recipe payload",
          "summary": "Copy fields use the text/rich-text editor across 13/13 editable fields."
        },
        {
          "id": "media",
          "label": "Media",
          "field_role": "media",
          "field_count": 2,
          "editable_count": 2,
          "editor_widget": "media picker with alt text",
          "validation": "Media should use a replaceable URL plus meaningful alt, label, or title fallback.",
          "default_source": "Cloud Elephants placeholder media or CMS media library",
          "summary": "Media fields use the media picker with alt text across 2/2 editable fields."
        },
        {
          "id": "action",
          "label": "Action",
          "field_role": "action",
          "field_count": 2,
          "editable_count": 2,
          "editor_widget": "link or event action editor",
          "validation": "Actions should resolve to a URL or event name with a human-readable label.",
          "default_source": "CMS route, URL, or canonical postEvent path",
          "summary": "Action fields use the link or event action editor across 2/2 editable fields."
        },
        {
          "id": "form",
          "label": "Form",
          "field_role": "form",
          "field_count": 2,
          "editable_count": 2,
          "editor_widget": "form schema and input editor",
          "validation": "Form fields should preserve labels, required state, options, and submission metadata.",
          "default_source": "CMS form schema or tenant data-capture defaults",
          "summary": "Form fields use the form schema and input editor across 2/2 editable fields."
        },
        {
          "id": "proof",
          "label": "Proof",
          "field_role": "proof",
          "field_count": 1,
          "editable_count": 1,
          "editor_widget": "metric, badge, or proof editor",
          "validation": "Proof fields should keep labels, values, and status text visible without color-only meaning.",
          "default_source": "cloneable block recipe payload",
          "summary": "Proof fields use the metric, badge, or proof editor across 1/1 editable field."
        },
        {
          "id": "style",
          "label": "Style",
          "field_role": "style",
          "field_count": 1,
          "editable_count": 0,
          "editor_widget": "appearance preset selector",
          "validation": "Style fields should prefer recipe or appearance tokens over one-off inline values.",
          "default_source": "Editorial Block System recipe tokens",
          "summary": "Style fields use the appearance preset selector across 0/1 editable field."
        },
        {
          "id": "content",
          "label": "Content",
          "field_role": "content",
          "field_count": 15,
          "editable_count": 15,
          "editor_widget": "plain content field",
          "validation": "Content should remain serializable JSON and preserve the documented block contract.",
          "default_source": "cloneable block recipe payload",
          "summary": "Content fields use the plain content field across 15/15 editable fields."
        }
      ],
      "editor_field_roles": [
        "copy",
        "media",
        "action",
        "form",
        "proof",
        "style",
        "content"
      ],
      "editor_editable_field_count": 35,
      "state_readiness_count": 6,
      "state_readiness_map": [
        {
          "id": "default",
          "label": "Default",
          "status": "covered",
          "trigger": "Initial render with the cloneable recipe payload",
          "visual_treatment": "Editorial Block System tokens with editorial documentation treatment",
          "token_roles": [
            "surface",
            "panel",
            "text",
            "button"
          ],
          "proof": "The Editorial Block System recipe renders a contract-safe primary state for program-grid.",
          "summary": "Default state uses the recipe surface, text, and action tokens without one-off styling."
        },
        {
          "id": "empty",
          "label": "Empty",
          "status": "covered",
          "trigger": "Repeatable collections have zero items",
          "visual_treatment": "Reserved panel space with fallback copy or placeholder media",
          "token_roles": [
            "panel",
            "textMuted",
            "badge",
            "border"
          ],
          "proof": "Repeatable fields are documented for add, remove, reorder, and item-level editing.",
          "summary": "Empty-state guidance preserves layout rhythm instead of collapsing the block surface."
        },
        {
          "id": "pending",
          "label": "Pending",
          "status": "covered",
          "trigger": "Async assignment, embed load, or form submission is in flight",
          "visual_treatment": "Neutral reserved frame with status copy and no layout shift",
          "token_roles": [
            "control",
            "textMuted",
            "progressTrack",
            "border"
          ],
          "proof": "Async-capable props are mapped through controls, events, or provider placeholders.",
          "summary": "Pending state keeps dimensions stable while using muted control/status tokens."
        },
        {
          "id": "active",
          "label": "Active",
          "status": "covered",
          "trigger": "Selected action, active link, checked input, or open disclosure",
          "visual_treatment": "Signal/uplink emphasis with visible selected-state chips",
          "token_roles": [
            "signal",
            "uplink",
            "button",
            "badge"
          ],
          "proof": "3 action surfaces and 5 control surfaces are mapped for selected-state review.",
          "summary": "Active state is represented with recipe accent tokens and visible state labels."
        },
        {
          "id": "invalid",
          "label": "Invalid",
          "status": "covered",
          "trigger": "Required input, option, or submitted value is invalid",
          "visual_treatment": "Warning/danger status treatment while preserving the block frame",
          "token_roles": [
            "warning",
            "danger",
            "border",
            "text"
          ],
          "proof": "Form controls preserve labels, required state, options, and submission metadata.",
          "summary": "Invalid state guidance favors explicit status evidence over ambiguous visual collapse."
        },
        {
          "id": "disabled",
          "label": "Disabled",
          "status": "covered",
          "trigger": "Unavailable action or temporarily disabled control",
          "visual_treatment": "Muted affordance with preserved label, spacing, and hit-area rhythm",
          "token_roles": [
            "control",
            "textMuted",
            "border",
            "panel"
          ],
          "proof": "Interactive maps preserve labels and control roles so disabled states can stay understandable.",
          "summary": "Disabled state keeps the block readable and spatially stable when interaction is unavailable."
        }
      ],
      "state_readiness_states": [
        "default",
        "empty",
        "pending",
        "active",
        "invalid",
        "disabled"
      ],
      "state_readiness_statuses": [
        "covered",
        "covered",
        "covered",
        "covered",
        "covered",
        "covered"
      ],
      "anatomy_region_count": 6,
      "anatomy_map": [
        {
          "id": "surface",
          "label": "Surface",
          "region_role": "outer layout and background",
          "field_paths": [
            "appearance"
          ],
          "token_roles": [
            "background",
            "panel",
            "panelElevated",
            "border"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": true,
          "summary": "program-grid uses recipe surface tokens to keep the outer frame styled and composable."
        },
        {
          "id": "copy",
          "label": "Copy",
          "region_role": "headings, body copy, labels, and supporting text",
          "field_paths": [
            "caption",
            "description",
            "filters[].label",
            "headline",
            "listings[].description",
            "listings[].title",
            "recommendations[].description",
            "recommendations[].title",
            "sort_options[].label",
            "sources[].citation_label",
            "sources[].title",
            "subtitle",
            "title"
          ],
          "token_roles": [
            "text",
            "textMuted"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": true,
          "summary": "Copy fields map to primary and muted text roles so editors can change words without restyling the block."
        },
        {
          "id": "media",
          "label": "Media",
          "region_role": "replaceable image, iframe, embed, avatar, logo, or gallery area",
          "field_paths": [
            "listings[].alt",
            "listings[].src"
          ],
          "token_roles": [
            "panelElevated",
            "border"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": false,
          "summary": "Media fields stay isolated from copy and action regions so replacement assets preserve the recipe layout."
        },
        {
          "id": "actions",
          "label": "Actions",
          "region_role": "CTA, link, event, and navigation affordances",
          "field_paths": [
            "buttonText",
            "listings[].href",
            "listings[0]",
            "listings[1]",
            "listings[2]"
          ],
          "token_roles": [
            "button",
            "buttonText",
            "signal",
            "uplink"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": false,
          "summary": "Action regions use recipe button and accent tokens while preserving href or event payloads."
        },
        {
          "id": "controls",
          "label": "Controls",
          "region_role": "inputs, choices, form fields, and operator controls",
          "field_paths": [
            "filters[0]",
            "filters[1]",
            "filters[2]",
            "sort_options",
            "sort_options[].value",
            "sort_options[0]",
            "sort_options[1]"
          ],
          "token_roles": [
            "control",
            "controlText",
            "border"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": false,
          "summary": "Control regions keep labels, required state, and options aligned with recipe control tokens."
        },
        {
          "id": "feedback",
          "label": "Feedback",
          "region_role": "status, validation, selected, loading, and disabled evidence",
          "field_paths": [],
          "token_roles": [
            "badge",
            "badgeText",
            "signal"
          ],
          "state_ids": [
            "default",
            "empty",
            "pending",
            "active",
            "invalid",
            "disabled"
          ],
          "required": true,
          "summary": "Feedback regions tie state-readiness evidence to visible recipe status treatments."
        }
      ],
      "anatomy_regions": [
        "surface",
        "copy",
        "media",
        "actions",
        "controls",
        "feedback"
      ],
      "anatomy_token_roles": [
        "background",
        "badge",
        "badgeText",
        "border",
        "button",
        "buttonText",
        "control",
        "controlText",
        "panel",
        "panelElevated",
        "signal",
        "text",
        "textMuted",
        "uplink"
      ],
      "action_count": 3,
      "action_map": [
        {
          "path": "listings[0]",
          "label": "Featured match",
          "action_type": "link",
          "href": "#block-preview",
          "event_name": null,
          "summary": "Featured match is a link action linking to #block-preview."
        },
        {
          "path": "listings[1]",
          "label": "Second match",
          "action_type": "link",
          "href": "#block-preview",
          "event_name": null,
          "summary": "Second match is a link action linking to #block-preview."
        },
        {
          "path": "listings[2]",
          "label": "Source-backed match",
          "action_type": "link",
          "href": "#block-preview",
          "event_name": null,
          "summary": "Source-backed match is a link action linking to #block-preview."
        }
      ],
      "control_count": 5,
      "control_map": [
        {
          "path": "filters[0]",
          "label": "Open now",
          "control_type": "text",
          "required": false,
          "option_count": null,
          "summary": "Open now is a text control."
        },
        {
          "path": "filters[1]",
          "label": "Nearby",
          "control_type": "text",
          "required": false,
          "option_count": null,
          "summary": "Nearby is a text control."
        },
        {
          "path": "filters[2]",
          "label": "Featured",
          "control_type": "text",
          "required": false,
          "option_count": null,
          "summary": "Featured is a text control."
        },
        {
          "path": "sort_options[0]",
          "label": "Recommended",
          "control_type": "text",
          "required": false,
          "option_count": null,
          "summary": "Recommended is a text control."
        },
        {
          "path": "sort_options[1]",
          "label": "Newest",
          "control_type": "text",
          "required": false,
          "option_count": null,
          "summary": "Newest is a text control."
        }
      ],
      "style_token_count": 15,
      "style_token_map": [
        {
          "role": "background",
          "label": "Page background",
          "value": "#f7fbff",
          "token_type": "color",
          "summary": "Page background uses the background recipe token."
        },
        {
          "role": "panel",
          "label": "Panel surface",
          "value": "#ffffff",
          "token_type": "color",
          "summary": "Panel surface uses the panel recipe token."
        },
        {
          "role": "panelElevated",
          "label": "Elevated surface",
          "value": "#ffffff",
          "token_type": "color",
          "summary": "Elevated surface uses the panelElevated recipe token."
        },
        {
          "role": "text",
          "label": "Primary text",
          "value": "#142033",
          "token_type": "color",
          "summary": "Primary text uses the text recipe token."
        },
        {
          "role": "textMuted",
          "label": "Muted text",
          "value": "#526174",
          "token_type": "color",
          "summary": "Muted text uses the textMuted recipe token."
        },
        {
          "role": "signal",
          "label": "Signal accent",
          "value": "#166bff",
          "token_type": "color",
          "summary": "Signal accent uses the signal recipe token."
        },
        {
          "role": "uplink",
          "label": "Secondary accent",
          "value": "#00a6a6",
          "token_type": "color",
          "summary": "Secondary accent uses the uplink recipe token."
        },
        {
          "role": "border",
          "label": "Border",
          "value": "#d6dee8",
          "token_type": "color",
          "summary": "Border uses the border recipe token."
        },
        {
          "role": "control",
          "label": "Control surface",
          "value": "#ffffff",
          "token_type": "color",
          "summary": "Control surface uses the control recipe token."
        },
        {
          "role": "controlText",
          "label": "Control text",
          "value": "#142033",
          "token_type": "color",
          "summary": "Control text uses the controlText recipe token."
        },
        {
          "role": "button",
          "label": "Button surface",
          "value": "#166bff",
          "token_type": "color",
          "summary": "Button surface uses the button recipe token."
        },
        {
          "role": "buttonText",
          "label": "Button text",
          "value": "#ffffff",
          "token_type": "color",
          "summary": "Button text uses the buttonText recipe token."
        },
        {
          "role": "badge",
          "label": "Badge surface",
          "value": "#eef5ff",
          "token_type": "color",
          "summary": "Badge surface uses the badge recipe token."
        },
        {
          "role": "badgeText",
          "label": "Badge text",
          "value": "#174ea6",
          "token_type": "color",
          "summary": "Badge text uses the badgeText recipe token."
        },
        {
          "role": "fontFamily",
          "label": "Font family",
          "value": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
          "token_type": "font",
          "summary": "Font family comes from the active recipe theme tokens."
        }
      ],
      "style_token_roles": [
        "background",
        "panel",
        "panelElevated",
        "text",
        "textMuted",
        "signal",
        "uplink",
        "border",
        "control",
        "controlText",
        "button",
        "buttonText",
        "badge",
        "badgeText",
        "fontFamily"
      ],
      "contrast_check_count": 6,
      "contrast_pass_count": 6,
      "contrast_checks": [
        {
          "id": "text-on-background",
          "label": "Text on background",
          "foreground_role": "text",
          "background_role": "background",
          "foreground": "#142033",
          "background": "#f7fbff",
          "ratio": 15.73,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AAA",
          "summary": "Text on background is AAA at 15.73:1 against a 4.5:1 requirement."
        },
        {
          "id": "text-on-panel",
          "label": "Text on panel",
          "foreground_role": "text",
          "background_role": "panel",
          "foreground": "#142033",
          "background": "#ffffff",
          "ratio": 16.35,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AAA",
          "summary": "Text on panel is AAA at 16.35:1 against a 4.5:1 requirement."
        },
        {
          "id": "muted-text-on-panel",
          "label": "Muted text on panel",
          "foreground_role": "textMuted",
          "background_role": "panel",
          "foreground": "#526174",
          "background": "#ffffff",
          "ratio": 6.32,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AA",
          "summary": "Muted text on panel is AA at 6.32:1 against a 4.5:1 requirement."
        },
        {
          "id": "button-text-on-button",
          "label": "Button text on button",
          "foreground_role": "buttonText",
          "background_role": "button",
          "foreground": "#ffffff",
          "background": "#166bff",
          "ratio": 4.58,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AA",
          "summary": "Button text on button is AA at 4.58:1 against a 4.5:1 requirement."
        },
        {
          "id": "control-text-on-control",
          "label": "Control text on control",
          "foreground_role": "controlText",
          "background_role": "control",
          "foreground": "#142033",
          "background": "#ffffff",
          "ratio": 16.35,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AAA",
          "summary": "Control text on control is AAA at 16.35:1 against a 4.5:1 requirement."
        },
        {
          "id": "badge-text-on-badge",
          "label": "Badge text on badge",
          "foreground_role": "badgeText",
          "background_role": "badge",
          "foreground": "#174ea6",
          "background": "#eef5ff",
          "ratio": 7.15,
          "required_ratio": 4.5,
          "passes": true,
          "level": "AAA",
          "summary": "Badge text on badge is AAA at 7.15:1 against a 4.5:1 requirement."
        }
      ],
      "contrast_target": "AA",
      "accessibility_standard": "WCAG_2_2_AA",
      "accessibility_check_count": 5,
      "accessibility_checks": [
        {
          "id": "semantic-structure",
          "label": "Semantic structure",
          "category": "semantics",
          "status": "covered",
          "required": true,
          "proof": "runtime block sections, cards, lists, and headings",
          "summary": "program-grid keeps semantic wrappers and readable heading/copy structure in the runtime preview."
        },
        {
          "id": "keyboard-and-tap-targets",
          "label": "Keyboard and tap targets",
          "category": "keyboard",
          "status": "covered",
          "required": true,
          "proof": "mapped actions/controls render as native focusable surfaces",
          "summary": "Interactive surfaces stay reachable, focusable, and recipe-styled without shrinking below expected touch affordances."
        },
        {
          "id": "text-alternatives",
          "label": "Text alternatives",
          "category": "media",
          "status": "covered",
          "required": true,
          "proof": "media fields include alt/label/title fallbacks",
          "summary": "Media-ready recipes expose replaceable alt text or accessible labels for images, logos, embeds, and placeholders."
        },
        {
          "id": "control-labels",
          "label": "Control labels",
          "category": "forms",
          "status": "covered",
          "required": true,
          "proof": "control map includes required field labels and option metadata",
          "summary": "Input and choice controls are mapped with labels, required state, and option counts for CMS and runtime review."
        },
        {
          "id": "status-and-motion",
          "label": "Status and motion",
          "category": "state",
          "status": "covered",
          "required": true,
          "proof": "runtime evidence avoids hidden status-only content",
          "summary": "Recipe defaults avoid motion-only meaning and keep status text inspectable when state is present."
        }
      ],
      "responsive_behavior_count": 3,
      "responsive_behavior_map": [
        {
          "id": "phone",
          "label": "Phone",
          "viewport_width": 390,
          "layout_mode": "single-column stack",
          "column_count": 1,
          "spacing_density": "spacious",
          "media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
          "overflow_policy": "min-width:0 surfaces, wrapping copy, and no horizontal overflow in the static catalog phone smoke.",
          "interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
          "proof": "npm run test:static:block-catalog all-blocks-phone",
          "summary": "Editorial Block System stacks program-grid into one phone column with spacious spacing and bounded content."
        },
        {
          "id": "tablet",
          "label": "Tablet",
          "viewport_width": 768,
          "layout_mode": "two-column adaptive grid",
          "column_count": 2,
          "spacing_density": "spacious",
          "media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
          "overflow_policy": "tablet preview frames keep mid-width composition, wrap controls, and avoid horizontal overflow in the static catalog smoke.",
          "interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
          "proof": "npm run test:static:block-catalog all-blocks-tablet",
          "summary": "Editorial Block System adapts program-grid to 2 tablet columns before expanding to the desktop layout."
        },
        {
          "id": "desktop",
          "label": "Desktop",
          "viewport_width": 1366,
          "layout_mode": "responsive composition grid",
          "column_count": 3,
          "spacing_density": "spacious",
          "media_policy": "Media slots remain optional and collapse without leaving empty chrome.",
          "overflow_policy": "desktop preview frames keep constrained widths, stable cards, and no horizontal overflow in the static catalog smoke.",
          "interaction_policy": "Actions and controls wrap into reachable rows with stable tap targets.",
          "proof": "npm run test:static:block-catalog all-blocks-desktop",
          "summary": "Editorial Block System gives program-grid up to 3 desktop columns while preserving recipe spacing."
        }
      ],
      "responsive_viewports": [
        "phone",
        "tablet",
        "desktop"
      ],
      "responsive_proof": [
        "npm run test:static:block-catalog all-blocks-phone",
        "npm run test:static:block-catalog all-blocks-tablet",
        "npm run test:static:block-catalog all-blocks-desktop"
      ],
      "interactive_roles": [
        "link",
        "text"
      ],
      "recipe_alignment": {
        "action_token": "button",
        "control_token": "control",
        "surface_token": "panel",
        "text_token": "text",
        "source": "theme recipe tokens"
      }
    },
    "cloneable": true
  },
  "block_order": 4
}