# headerFooters.resolve

> Resolve the effective header/footer reference for a slot, walking the section inheritance chain.



- Member path: `doc.headerFooters.resolve(…)`
- Mutates document: no
- Idempotency: `idempotent`
- Supports tracked mode: no
- Supports dry run: no

## Expected result

Returns a HeaderFooterResolveResult indicating explicit, inherited, or none status with the resolved refId.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SectionAddress": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "section"
        },
        "sectionId": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "kind",
        "sectionId"
      ]
    }
  },
  "type": "object",
  "properties": {
    "target": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "headerFooterSlot"
        },
        "section": {
          "$ref": "#/$defs/SectionAddress"
        },
        "headerFooterKind": {
          "enum": [
            "header",
            "footer"
          ]
        },
        "variant": {
          "enum": [
            "default",
            "first",
            "even"
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "kind",
        "section",
        "headerFooterKind",
        "variant"
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "target"
  ]
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SectionAddress": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "section"
        },
        "sectionId": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "kind",
        "sectionId"
      ]
    }
  },
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "status": {
          "const": "explicit"
        },
        "refId": {
          "type": "string"
        },
        "section": {
          "$ref": "#/$defs/SectionAddress"
        }
      },
      "additionalProperties": false,
      "required": [
        "status",
        "refId",
        "section"
      ]
    },
    {
      "type": "object",
      "properties": {
        "status": {
          "const": "inherited"
        },
        "refId": {
          "type": "string"
        },
        "resolvedFromSection": {
          "$ref": "#/$defs/SectionAddress"
        },
        "resolvedVariant": {
          "enum": [
            "default",
            "first",
            "even"
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "status",
        "refId",
        "resolvedFromSection",
        "resolvedVariant"
      ]
    },
    {
      "type": "object",
      "properties": {
        "status": {
          "const": "none"
        }
      },
      "additionalProperties": false,
      "required": [
        "status"
      ]
    }
  ]
}
```

## Pre-apply throws

- `TARGET_NOT_FOUND`
- `INVALID_TARGET`
- `INVALID_INPUT`

## Non-applied receipt codes

- None