PresetInput

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/rendry-io/json-schema/rendry-io-preset-input-schema.json",
  "title": "PresetInput",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/rendry-io-openapi.json#/components/schemas/PresetInput",
  "type": "object",
  "required": [
    "name",
    "canvas",
    "layers"
  ],
  "properties": {
    "sample_rows": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        }
      },
      "description": "Sample rows of repeat groups and tables, drawn until a render passes real rows"
    },
    "derived": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Colours FROM a photo: [{\"name\": \"hero\", \"from\": \"<image layer id>\"}]; then $hero.bg | .support | .accent | .on | .0..5 as any colour"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "canvas": {
      "$ref": "#/$defs/Canvas"
    },
    "layers": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Ordinary DSL layers. Text may use text_overflow:\"clip_lines\" with positive integer max_lines and explicit width. It keeps complete native lines without an ellipsis after full-source auto_fit/fit_group; height is optional and never a second line cap. Plates size retained content; text_flow cannot truncate. Every layer, including nested children, accepts an optional literal printable single-line Unicode name label. Absent, null or empty is unnamed; duplicate labels are allowed. C0 controls (U+0000–U+001F), DEL (U+007F), and line/paragraph separators (U+2028/U+2029) are refused. Emoji, RTL and combining marks are preserved. Names never render, substitute variables, or define output IDs or metadata."
    },
    "modifications": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Sources of the template's variables: the sample (default) value of each {name} when dynamic_data does not supply one — or, with a mode in variable_modes, the template or formula that computes it."
    },
    "variable_modes": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "enum": [
          "text",
          "template",
          "formula"
        ]
      },
      "description": "How each modifications source is read (grammar and limits: GET /capabilities nested_variables). Missing, null or {} means every source is text, literal. template: {name} inserts that variable's value, {{ and }} print one brace. formula: exact decimal arithmetic (+ - * /, unary signs, parentheses, round(x[, decimals]), min(a,b,...), max(a,b,...), abs(x)) over numbers and {name}; additive grammar 3 adds count({items}) and sum({items},{amount}) over the effective whole rows source. Aggregate brace arguments are source/field handles, not variable edges. Empty count/sum is zero; every needed sum cell must be decimal, with a private one-based row/field refusal before charge. Unused, hidden and overridden aggregates read nothing; table and aggregate sources share the fetch cache/budget. Aggregate-dependent visible_if inside link_dest/follows refuses before reads; a literal controller override is allowed; a terminating result prints in full, a repeating one is rounded to nested_variables.projection_digits significant digits. A mode needs a source under the same name; page and pages are engine facts and take no mode; row.* names take none. A save refuses a schema problem (VariableDiagnosticCode invalid_mode, invalid_name, reserved_name, unsupported_row_scope, source_limit) and writes nothing; a definition that does not resolve from the saved values is saved and named in warnings, and a render refuses it before any charge unless dynamic_data supplies a literal for it. dynamic_data is always literal: a supplied value replaces the definition of that name for the call and is never parsed as a template or a formula. What a caller sends and what the template computes is told apart by InputDescriptor."
    },
    "palettes": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "description": "Colours a field takes from data: {\"tier\": {\"gold\": \"#C9A227\", \"default\": \"#444444\"}}. A colour field then refers to one by the variable that chooses it — \"fill_color\": \"{tier}\" reads dynamic_data.tier, and inside a repeat the row's own tier field. An unknown value takes \"default\"; a palette without one refuses the render and names the values it admits."
    },
    "variable_formats": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "$ref": "#/$defs/DisplayFormat"
      },
      "description": "Sparse name -> display format beside modifications and variable_modes. A name needs a source in modifications and cannot be page, pages or row.*. Applied after source evaluation and also to caller overrides; formulas consume raw exact values while templates insert formatted text. Invalid schema refuses save; invalid data refuses dry run and render before any charge, without echoing values. update_preset patches: absent or {} keeps; name:null removes; top-level null clears. Whole preset and document saves replace the map."
    }
  },
  "additionalProperties": true,
  "$defs": {
    "Canvas": {
      "type": "object",
      "properties": {
        "width": {
          "type": "integer"
        },
        "height": {
          "type": "integer"
        },
        "background_color": {
          "type": "string"
        },
        "output_format": {
          "type": "string"
        },
        "quality": {
          "type": "integer"
        },
        "max_width": {
          "type": "integer"
        },
        "finish_profile": {
          "type": "string",
          "description": "Optional whole-canvas finish applied once after composition using the profile-specific paint policy. Use an exact id from the finish_profiles field returned by GET /capabilities; that runtime catalog also declares compatible formats and minimum dimensions."
        }
      },
      "additionalProperties": true
    },
    "DisplayFormat": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "number",
            "currency",
            "percent",
            "date",
            "upper",
            "lower"
          ]
        },
        "decimals": {
          "type": "integer",
          "minimum": 0,
          "maximum": 34,
          "default": 0
        },
        "grouping": {
          "type": "boolean",
          "default": false
        },
        "decimal_mark": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1,
          "default": "."
        },
        "group_mark": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1,
          "default": ","
        },
        "symbol": {
          "type": "string",
          "maxLength": 32
        },
        "symbol_position": {
          "type": "string",
          "enum": [
            "prefix",
            "suffix"
          ],
          "default": "prefix"
        },
        "prefix": {
          "type": "string",
          "maxLength": 32
        },
        "suffix": {
          "type": "string",
          "maxLength": 32
        },
        "pattern": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128,
          "default": "YYYY-MM-DD"
        }
      },
      "description": "One deterministic display vocabulary. Numbers use exact arithmetic and half away from zero rounding. Currency needs symbol (a symbol or ISO code), with explicit spacing in that text. Percent multiplies a raw ratio by 100. Dates accept strict YYYY-MM-DD only and patterns D, DD, M, MM, MMM, MMMM, YY, YYYY with English month names. upper/lower use Unicode simple case mapping; no locale or multi-character expansions. No format leaves existing text untouched. Fields unrelated to the selected type are refused."
    }
  }
}