{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://spec.super-arc.com/0.1.0/location.json",
  "title": "Location",
  "description": "A Location in the Narrative Spec. Required core is deliberately tiny: a stub is valid, and depth is scored rather than demanded. Depth groups are the optional top-level objects below; a group is started when its key is present and its value is a non-null object, including {}.",
  "type": "object",
  "required": [
    "id",
    "specType",
    "specVersion",
    "name",
    "kind"
  ],
  "properties": {
    "id": {
      "$ref": "common.json#/$defs/id"
    },
    "specType": {
      "const": "location"
    },
    "specVersion": {
      "$ref": "common.json#/$defs/specVersion"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Display name. May change; the slug in id may not."
    },
    "status": {
      "$ref": "common.json#/$defs/status"
    },
    "extensions": {
      "$ref": "common.json#/$defs/extensions"
    },
    "kind": {
      "type": "string",
      "description": "city, room, ship, region, …"
    },
    "geography": {
      "type": [
        "object",
        "null"
      ],
      "description": "Where it sits and what surrounds it.",
      "properties": {
        "region": {
          "type": "string"
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "sensory": {
      "type": [
        "object",
        "null"
      ],
      "description": "What it is like to be there.",
      "properties": {
        "sight": {
          "type": "string"
        },
        "sound": {
          "type": "string"
        },
        "smell": {
          "type": "string"
        },
        "texture": {
          "type": "string"
        }
      }
    },
    "control": {
      "type": [
        "object",
        "null"
      ],
      "description": "Who holds it.",
      "properties": {
        "holders": {
          "type": "array",
          "items": {
            "$ref": "common.json#/$defs/ref"
          }
        },
        "contested": {
          "type": "boolean"
        }
      }
    },
    "travel": {
      "type": [
        "object",
        "null"
      ],
      "description": "What it costs to get here from elsewhere.",
      "properties": {
        "routes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "notes": {
          "type": "string"
        }
      }
    },
    "secrets": {
      "type": [
        "object",
        "null"
      ],
      "description": "What the place is hiding.",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-depthOrder": [
    "geography",
    "sensory",
    "control",
    "travel",
    "secrets"
  ]
}
