Editor Surface Manifest

{
  "layout_axes": [
    "family",
    "width",
    "spacing",
    "padding",
    "density",
    "alignment",
    "surface"
  ],
  "notes": [
    "This catalog describes the current editor-facing scope and token surface that agents should target conceptually.",
    "The intended future exposure path is through the local bridge and equivalent production API shapes."
  ],
  "primary_token_groups": [
    {
      "example_tokens": [
        "content_max_width",
        "section_gap_y",
        "section_padding_y",
        "section_padding_x",
        "structured_gap",
        "compact_padding_y",
        "intro_card_gap",
        "intro_card_padding_y",
        "intro_card_padding_x",
        "intro_card_max_width",
        "component_gap",
        "card_padding_y",
        "card_padding_x",
        "note_padding_y",
        "note_padding_x",
        "team_card_gap",
        "action_gap",
        "body_line_height",
        "heading_line_height",
        "paragraph_gap",
        "heading_gap",
        "nav_row_gap",
        "nav_column_gap",
        "nav_link_size",
        "nav_link_padding_x",
        "nav_link_padding_y"
      ],
      "name": "surface",
      "recommended_for_agents": true
    },
    {
      "name": "color",
      "recommended_for_agents": true
    },
    {
      "name": "width",
      "recommended_for_agents": true
    },
    {
      "name": "space",
      "recommended_for_agents": true
    },
    {
      "name": "type",
      "recommended_for_agents": true
    },
    {
      "name": "radius",
      "recommended_for_agents": true
    },
    {
      "name": "shadow",
      "recommended_for_agents": true
    },
    {
      "name": "section",
      "recommended_for_agents": false,
      "status": "compatibility"
    },
    {
      "name": "region",
      "recommended_for_agents": false,
      "status": "compatibility"
    }
  ],
  "scopes": [
    {
      "bridge_scope": "site",
      "name": "site",
      "read_path": "/ops/token/read-global",
      "source_of_truth": "params.style.tokens.* in site config",
      "write_paths": [
        "/ops/token/set-global",
        "/ops/token/unset-global"
      ]
    },
    {
      "bridge_scope": "page_type",
      "name": "page_type",
      "read_path": "/ops/token/read-global",
      "requires_scope_key": true,
      "source_of_truth": "params.style.page_types.\u003cscope\u003e.tokens.surface.* in site config",
      "write_paths": [
        "/ops/token/set-global",
        "/ops/token/unset-global"
      ]
    },
    {
      "bridge_scope": "page",
      "name": "page",
      "read_path": "/ops/token/read-global",
      "requires_path": true,
      "source_of_truth": "style.tokens.surface.* in page front matter",
      "write_paths": [
        "/ops/token/set-global",
        "/ops/token/unset-global"
      ]
    },
    {
      "bridge_scope": "section",
      "name": "section",
      "node_id_shape": "s0, s1, ...",
      "read_path": "/ops/token/read-local",
      "requires_node_id": true,
      "requires_path": true,
      "source_of_truth": "leading section attr block in markdown",
      "write_paths": [
        "/ops/token/set-local",
        "/ops/token/unset-local"
      ]
    },
    {
      "bridge_scope": "block",
      "name": "block",
      "node_id_shapes": [
        "s0:media",
        "team:0",
        "gallery:0",
        "contact:0",
        "stats:0",
        "testimonials:0",
        "faq:0",
        "buttons:0"
      ],
      "read_path": "/ops/token/read-local",
      "requires_node_id": true,
      "requires_path": true,
      "source_of_truth": "section media attr line or structured block attr/fence target in markdown",
      "write_paths": [
        "/ops/token/set-local",
        "/ops/token/unset-local"
      ]
    }
  ],
  "shared_inspector": {
    "page_types": [
      "homepage",
      "list",
      "landing",
      "detail",
      "single"
    ],
    "preview_widths": [
      "desktop",
      "tablet",
      "phone"
    ],
    "tabs": [
      "Content",
      "Layout",
      "Style",
      "Data",
      "Advanced"
    ]
  },
  "updated": "2026-03-20",
  "version": 1
}