{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://paramlet.com/tools/gingerbread-cutter/schema.json",
 "title": "Gingerbread & Cookie Cutter Generator — parameters",
 "description": "Design 1-piece 3D printable gingerbread and cookie cutters with tapered blades, embossing details, stamps, plungers, nested sets, names, or custom SVG paths. All lengths are millimetres. Unknown keys are rejected; out-of-range values are rejected by the URL and API and clamped when a project file is opened.",
 "x-tool": "gingerbread-cutter",
 "x-toolVersion": "0.1.0",
 "x-specVersion": "1.0",
 "x-apiVersion": "1",
 "x-groups": [
  {
   "id": "shape",
   "title": "Shape & outline"
  },
  {
   "id": "blade",
   "title": "Blade & rim"
  },
  {
   "id": "details",
   "title": "Details, stamp & plunger"
  },
  {
   "id": "nested",
   "title": "Nested cutter set"
  },
  {
   "id": "print",
   "title": "Printing & food safety"
  }
 ],
 "x-presets": {
  "note": "Choosing a preset resets every key marked x-resetOnPreset to its default and then applies the preset values.",
  "items": [
   {
    "id": "classic-gingerbread",
    "title": "Classic gingerbread man (100 mm)",
    "description": "Traditional 100 mm gingerbread man with embossed face and buttons.",
    "values": {
     "source": "preset",
     "shape": "gingerbread-man",
     "sizeMm": 100,
     "cutHeight": 14,
     "bladeTip": 0.6,
     "innerDetails": true,
     "includeStamp": false,
     "includePlunger": false,
     "nestedCount": 1
    }
   },
   {
    "id": "star-set-3",
    "title": "Star set (3 nested)",
    "description": "Three concentric 5-pointed stars (100, 80, and 60 mm) for stacked gingerbread trees.",
    "values": {
     "source": "preset",
     "shape": "star",
     "sizeMm": 100,
     "cutHeight": 14,
     "bladeTip": 0.6,
     "innerDetails": false,
     "includeStamp": false,
     "includePlunger": false,
     "nestedCount": 3,
     "nestedStep": 20
    }
   },
   {
    "id": "house-windows",
    "title": "House with window details",
    "description": "110 mm gingerbread house cutter with embossed door and multi-pane windows.",
    "values": {
     "source": "preset",
     "shape": "house",
     "sizeMm": 110,
     "cutHeight": 15,
     "bladeTip": 0.6,
     "innerDetails": true,
     "detailRecess": 3.5,
     "includeStamp": false,
     "includePlunger": false,
     "nestedCount": 1
    }
   },
   {
    "id": "heart-stamp",
    "title": "Heart with stamp",
    "description": "85 mm heart cutter paired with a matching debossed handle stamp.",
    "values": {
     "source": "preset",
     "shape": "heart",
     "sizeMm": 85,
     "cutHeight": 14,
     "bladeTip": 0.6,
     "innerDetails": false,
     "includeStamp": true,
     "stampText": "LOVE",
     "embossDepth": 1.2,
     "clearance": 0.6,
     "includePlunger": false,
     "nestedCount": 1
    }
   },
   {
    "id": "name-anna",
    "title": "Name cutter \"ANNA\"",
    "description": "Personalized 110 mm cookie cutter outlining and embossing the name ANNA.",
    "values": {
     "source": "text",
     "textString": "ANNA",
     "sizeMm": 110,
     "cutHeight": 14,
     "bladeTip": 0.6,
     "innerDetails": true,
     "includeStamp": false,
     "includePlunger": false,
     "nestedCount": 1
    }
   },
   {
    "id": "tree-plunger",
    "title": "Tree with plunger",
    "description": "95 mm Christmas tree cutter with a fitted dough ejector plunger.",
    "values": {
     "source": "preset",
     "shape": "tree",
     "sizeMm": 95,
     "cutHeight": 14,
     "bladeTip": 0.6,
     "innerDetails": true,
     "includeStamp": false,
     "includePlunger": true,
     "clearance": 0.6,
     "nestedCount": 1
    }
   }
  ]
 },
 "x-coreParams": {
  "exportFormat": {
   "type": "string",
   "title": "File format",
   "description": "3mf = 3MF (mm); stl = STL files in a zip (mm)",
   "x-group": "download",
   "x-role": "core.exportFormat",
   "x-unit": "none",
   "x-agentSafe": true,
   "enum": [
    "3mf",
    "stl"
   ],
   "default": "3mf"
  },
  "exportTol": {
   "type": "number",
   "title": "Mesh precision",
   "description": "Simplification tolerance in mm (0 = original mesh).",
   "x-group": "download",
   "x-role": "core.exportTolerance",
   "x-unit": "mm",
   "x-agentSafe": true,
   "enum": [
    0,
    0.01,
    0.02
   ],
   "default": 0.02
  },
  "units": {
   "type": "string",
   "title": "Units shown",
   "description": "Display only: mm or inches (1 in = 25.4 mm). Stored values, the API and exports are always mm.",
   "x-group": "view",
   "x-role": "core.displayUnits",
   "x-unit": "none",
   "x-agentSafe": true,
   "enum": [
    "mm",
    "in"
   ],
   "x-enumTitles": {
    "mm": "Millimetres",
    "in": "Inches"
   },
   "default": "mm"
  }
 },
 "type": "object",
 "properties": {
  "source": {
   "type": "string",
   "enum": [
    "preset",
    "text",
    "svg"
   ],
   "x-enumTitles": {
    "preset": "Built-in shape",
    "text": "Name / letter cutter",
    "svg": "Custom SVG path"
   },
   "title": "Outline source",
   "description": "Choose a built-in cookie shape, a text name outline, or a single closed SVG path.",
   "x-group": "shape",
   "x-agentSafe": true,
   "x-label-lv": "Kontūras avots",
   "default": "preset",
   "x-resetOnPreset": true
  },
  "shape": {
   "type": "string",
   "enum": [
    "gingerbread-man",
    "gingerbread-woman",
    "star",
    "heart",
    "tree",
    "house",
    "bell",
    "mitten",
    "snowflake",
    "deer",
    "circle",
    "scalloped-circle"
   ],
   "x-enumTitles": {
    "gingerbread-man": "Gingerbread man",
    "gingerbread-woman": "Gingerbread woman",
    "star": "Star",
    "heart": "Heart",
    "tree": "Christmas tree",
    "house": "Gingerbread house",
    "bell": "Bell",
    "mitten": "Mitten",
    "snowflake": "Snowflake",
    "deer": "Deer silhouette",
    "circle": "Circle",
    "scalloped-circle": "Scalloped circle"
   },
   "title": "Built-in shape",
   "description": "Classic gingerbread and holiday cookie outlines with optional embossing details.",
   "x-group": "shape",
   "x-visibleIf": {
    "source": "preset"
   },
   "x-agentSafe": true,
   "x-label-lv": "Iebūvētā forma",
   "default": "gingerbread-man",
   "x-resetOnPreset": true
  },
  "textString": {
   "type": "string",
   "maxLength": 24,
   "title": "Name or letter",
   "description": "Letters A-Z, digits 0-9, and basic punctuation rendered with a built-in vector font.",
   "x-group": "shape",
   "x-visibleIf": {
    "source": "text"
   },
   "x-agentSafe": true,
   "x-label-lv": "Vārds vai burts",
   "default": "ANNA",
   "x-resetOnPreset": true
  },
  "svgPath": {
   "type": "string",
   "maxLength": 4000,
   "title": "SVG path data (d)",
   "description": "Single closed SVG path (must end with Z and not self-intersect); parsed safely without scripts.",
   "x-group": "shape",
   "x-visibleIf": {
    "source": "svg"
   },
   "x-agentSafe": true,
   "x-label-lv": "SVG ceļa dati (d)",
   "default": "",
   "x-resetOnPreset": true
  },
  "sizeMm": {
   "type": "number",
   "minimum": 30,
   "maximum": 150,
   "multipleOf": 1,
   "title": "Longest side",
   "description": "Overall inner cookie size measured along the longest bounding-box axis.",
   "x-group": "shape",
   "x-unit": "mm",
   "x-agentSafe": true,
   "x-label-lv": "Garākā mala",
   "default": 100,
   "x-resetOnPreset": true
  },
  "cutHeight": {
   "type": "number",
   "minimum": 8,
   "maximum": 20,
   "x-step": 0.5,
   "title": "Cut height",
   "description": "Total height of the cutter from the flat rim to the cutting edge.",
   "x-group": "blade",
   "x-unit": "mm",
   "x-agentSafe": true,
   "x-label-lv": "Griešanas augstums",
   "default": 14,
   "x-resetOnPreset": true
  },
  "bladeTip": {
   "type": "number",
   "minimum": 0.4,
   "maximum": 1.2,
   "x-step": 0.05,
   "title": "Blade tip thickness",
   "description": "Width at the cutting edge; clamped to at least the configured nozzle diameter (0.4 mm min).",
   "x-group": "blade",
   "x-unit": "mm",
   "x-agentSafe": true,
   "x-label-lv": "Asmens gala biezums",
   "default": 0.6,
   "x-resetOnPreset": true
  },
  "wallThickness": {
   "type": "number",
   "minimum": 1,
   "maximum": 3,
   "x-step": 0.1,
   "title": "Wall thickness",
   "description": "Main body wall thickness that tapers smoothly down to the blade tip.",
   "x-group": "blade",
   "x-unit": "mm",
   "x-role": "core.wallThickness",
   "x-agentSafe": true,
   "x-label-lv": "Sienas biezums",
   "default": 1.6,
   "x-resetOnPreset": true
  },
  "rimWidth": {
   "type": "number",
   "minimum": 2,
   "maximum": 10,
   "x-step": 0.5,
   "title": "Rim flange width",
   "description": "Reinforcing flange around the base that strengthens the cutter and protects fingers.",
   "x-group": "blade",
   "x-unit": "mm",
   "x-agentSafe": true,
   "x-label-lv": "Malas atloka platums",
   "default": 5,
   "x-resetOnPreset": true
  },
  "rimHeight": {
   "type": "number",
   "minimum": 1.6,
   "maximum": 5,
   "x-step": 0.2,
   "title": "Rim flange height",
   "description": "Thickness of the flat rim resting on the build plate (z = 0).",
   "x-group": "blade",
   "x-unit": "mm",
   "x-agentSafe": true,
   "x-label-lv": "Malas atloka augstums",
   "default": 2.6,
   "x-resetOnPreset": true
  },
  "innerDetails": {
   "type": "integer",
   "enum": [
    0,
    1
   ],
   "title": "Inner embossing ridges",
   "description": "Lower-height internal detail lines (face, buttons, windows, letters) that mark dough without cutting through.",
   "x-group": "details",
   "x-agentSafe": true,
   "x-label-lv": "Iekšējās reljefa līnijas",
   "default": 1,
   "x-resetOnPreset": true
  },
  "detailRecess": {
   "type": "number",
   "minimum": 2,
   "maximum": 8,
   "x-step": 0.5,
   "title": "Detail recess below blade",
   "description": "How far below the cutting edge the inner ridges stop so they emboss rather than cut.",
   "x-group": "details",
   "x-unit": "mm",
   "x-visibleIf": {
    "innerDetails": true
   },
   "x-agentSafe": true,
   "x-label-lv": "Reljefa atkāpe zem asmens",
   "default": 3.5,
   "x-resetOnPreset": true
  },
  "includeStamp": {
   "type": "integer",
   "enum": [
    0,
    1
   ],
   "title": "Separate embossing stamp",
   "description": "Add a matching debossed stamp plate with an upright printable handle.",
   "x-group": "details",
   "x-agentSafe": true,
   "x-label-lv": "Atsevišķs reljefa zīmogs",
   "default": 0,
   "x-resetOnPreset": true
  },
  "stampText": {
   "type": "string",
   "maxLength": 16,
   "title": "Stamp text (optional)",
   "description": "Short word debossed onto the stamp face; leave blank to use the shape details.",
   "x-group": "details",
   "x-visibleIf": {
    "includeStamp": true
   },
   "x-agentSafe": true,
   "x-label-lv": "Zīmoga teksts (pēc izvēles)",
   "default": "",
   "x-resetOnPreset": true
  },
  "embossDepth": {
   "type": "number",
   "minimum": 0.8,
   "maximum": 2.4,
   "x-step": 0.2,
   "title": "Stamp deboss depth",
   "description": "Depth of the recessed grooves on the stamp face.",
   "x-group": "details",
   "x-unit": "mm",
   "x-visibleIf": {
    "includeStamp": true
   },
   "x-agentSafe": true,
   "x-label-lv": "Zīmoga reljefa dziļums",
   "default": 1.2,
   "x-resetOnPreset": true
  },
  "includePlunger": {
   "type": "integer",
   "enum": [
    0,
    1
   ],
   "title": "Fitted dough plunger",
   "description": "Add an ejector plate with a push rod sized to slide inside the cutter.",
   "x-group": "details",
   "x-agentSafe": true,
   "x-label-lv": "Pielāgots mīklas virzulis",
   "default": 0,
   "x-resetOnPreset": true
  },
  "clearance": {
   "type": "number",
   "minimum": 0.2,
   "maximum": 2,
   "x-step": 0.05,
   "title": "Stamp / plunger clearance",
   "description": "Gap per side between the cutter inner wall and the stamp or plunger plate.",
   "x-group": "details",
   "x-unit": "mm",
   "x-role": "core.clearance",
   "x-visibleIf": {
    "any": [
     {
      "includeStamp": true
     },
     {
      "includePlunger": true
     }
    ]
   },
   "x-agentSafe": true,
   "x-label-lv": "Zīmoga / virzuļa atstarpe",
   "default": 0.6,
   "x-resetOnPreset": true
  },
  "nestedCount": {
   "type": "integer",
   "minimum": 1,
   "maximum": 5,
   "multipleOf": 1,
   "title": "Cutters in nested set",
   "description": "Create 1 to 5 progressively smaller cutters in a single print.",
   "x-group": "nested",
   "x-unit": "count",
   "x-agentSafe": true,
   "x-label-lv": "Formiņu skaits komplektā",
   "default": 1,
   "x-resetOnPreset": true
  },
  "nestedStep": {
   "type": "number",
   "minimum": 5,
   "maximum": 25,
   "multipleOf": 1,
   "title": "Size shrink step",
   "description": "Millimetres removed from the longest side for each smaller cutter in the set.",
   "x-group": "nested",
   "x-unit": "mm",
   "x-visibleIf": {
    "nestedCount": {
     "gt": 1
    }
   },
   "x-agentSafe": true,
   "x-label-lv": "Izmēra samazinājuma solis",
   "default": 15,
   "x-resetOnPreset": true
  },
  "nozzleSize": {
   "type": "number",
   "minimum": 0.4,
   "maximum": 0.8,
   "x-step": 0.1,
   "title": "Nozzle diameter",
   "description": "Sets the nozzle-safe minimum blade tip and wall thickness (at least 0.4 mm).",
   "x-group": "print",
   "x-unit": "mm",
   "x-advanced": true,
   "x-agentSafe": true,
   "x-label-lv": "Sprauslas diametrs",
   "default": 0.4
  },
  "printMaterial": {
   "type": "string",
   "enum": [
    "petg",
    "pla"
   ],
   "x-enumTitles": {
    "petg": "Food-safe PETG (recommended)",
    "pla": "Food-safe PLA (cool hand-wash only)"
   },
   "title": "Print material",
   "description": "Used for print mass estimation and food-safety guidance in the README.",
   "x-group": "print",
   "x-role": "core.printMaterial",
   "x-agentSafe": true,
   "x-label-lv": "Drukas materiāls",
   "default": "petg"
  },
  "resolution": {
   "type": "integer",
   "minimum": 24,
   "maximum": 96,
   "multipleOf": 4,
   "title": "Curve resolution",
   "description": "Segments for curved outlines and rounded corners; higher values are smoother.",
   "x-group": "print",
   "x-unit": "count",
   "x-role": "core.resolution",
   "x-advanced": true,
   "x-agentSafe": true,
   "x-label-lv": "Līkņu izšķirtspēja",
   "default": 48
  },
  "color": {
   "type": "string",
   "pattern": "^#[0-9a-fA-F]{6}$",
   "title": "Preview colour",
   "description": "Changes the 3D viewer colour only.",
   "x-group": "print",
   "x-role": "core.previewColor",
   "x-agentSafe": true,
   "x-label-lv": "Priekšskata krāsa",
   "default": "#c86d3b"
  }
 },
 "additionalProperties": false
}