atlas.paperclips.workers.dev

{
  "type": "object",
  "properties": {
    "headline": {
      "type": "string",
      "maxLength": 120,
      "description": "Specific conclusion or subject shown prominently over the globe."
    },
    "subheadline": {
      "type": "string",
      "maxLength": 220,
      "description": "One concise sentence explaining what is shown and why it matters."
    },
    "layers": {
      "type": "array",
      "minItems": 1,
      "maxItems": 8,
      "description": "Ordered back-to-front scene layers. The last layer also becomes the active table result.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 80,
            "description": "Stable scene-unique layer ID."
          },
          "resultId": {
            "type": "string",
            "maxLength": 80,
            "description": "Saved result ID returned by execute_sql."
          },
          "type": {
            "type": "string",
            "enum": [
              "points",
              "paths",
              "rings",
              "polygons"
            ],
            "description": "Normalized spatial mark type."
          },
          "title": {
            "type": "string",
            "maxLength": 120,
            "description": "Compact label used in the globe legend."
          },
          "encoding": {
            "type": "object",
            "description": "Result columns assigned to visual roles. Geographic roles are inferred when omitted.",
            "properties": {
              "latitude": {
                "type": "string",
                "description": "Latitude column."
              },
              "longitude": {
                "type": "string",
                "description": "Longitude column."
              },
              "altitude": {
                "type": "string",
                "description": "Optional altitude in kilometers above the Earth reference ellipsoid."
              },
              "geometry": {
                "type": "string",
                "description": "GeoJSON Polygon or MultiPolygon geometry column."
              },
              "group": {
                "type": "string",
                "description": "Series or path identifier column."
              },
              "order": {
                "type": "string",
                "description": "Path point ordering column."
              },
              "label": {
                "type": "string",
                "description": "Hover and selection label column."
              },
              "size": {
                "type": "string",
                "description": "Optional numeric ring-size column."
              },
              "image": {
                "type": "string",
                "description": "Optional image URL or bundled image-path column for previews."
              }
            },
            "additionalProperties": false
          },
          "style": {
            "type": "object",
            "description": "Validated fixed styling. Width and animate affect paths; radius affects points or rings.",
            "properties": {
              "color": {
                "type": "string",
                "maxLength": 60,
                "description": "CSS color; omit for deterministic group colors."
              },
              "opacity": {
                "type": "number",
                "minimum": 0.1,
                "maximum": 1,
                "description": "Layer opacity."
              },
              "width": {
                "type": "number",
                "minimum": 0.1,
                "maximum": 4,
                "description": "Path stroke width."
              },
              "radius": {
                "type": "number",
                "minimum": 0.05,
                "maximum": 20,
                "description": "Point radius or ring maximum radius."
              },
              "animate": {
                "type": "boolean",
                "description": "Whether path dashes move."
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "resultId",
          "type"
        ],
        "additionalProperties": false
      }
    },
    "camera": {
      "type": "object",
      "description": "Initial camera behavior after the scene is committed.",
      "properties": {
        "fit": {
          "type": "string",
          "enum": [
            "all-layers",
            "active-layer",
            "none"
          ],
          "description": "Fit every layer, one layer, or preserve the camera."
        },
        "layerId": {
          "type": "string",
          "maxLength": 80,
          "description": "Layer to fit when fit is active-layer; defaults to the last layer."
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "headline",
    "subheadline",
    "layers"
  ],
  "additionalProperties": false
}