Master Reference for All JSON Configuration Schemas
Version 2026Q1 | Last Updated: February 10, 2026 | SolidCut CAD 2025
Single Source of Truth: This document contains all JSON schema definitions for the Nucleo Fixture System. Feature documentation pages link here rather than duplicating schema content. When schemas are updated, this is the authoritative reference.
The top-level schema for blade generation. Used by both interactive UI and headless/batch modes.
| Section | Purpose | Required |
|---|---|---|
blade | Core geometry: position, normal, thickness, length | ✓ Yes |
profile | Profile generation: offset, gravity direction | ✓ Yes |
trimming | Open sides, extensions, gravity trim | No |
edgeModifications | Taper, blend, grippers, notches | No |
modularAssembly | Lego block system parameters | No |
dangerZone | Sharp edge safety marking and blending | No |
output | Layer, color, DXF options | No |
processingMode | headless, showProgress, debugLevel | No |
metadata | Job tracking (jobId, partFile) | No |
{
"version": "1.0",
"blade": {
"position": { "x": 100.0, "y": 0.0, "z": 0.0 },
"normal": { "x": 1.0, "y": 0.0, "z": 0.0 },
"thickness": 6.0
},
"profile": {
"offset": 2.0,
"gravityDirection": "AUTO"
}
}
{
"version": "1.0",
"metadata": {
"jobId": "BLD-2026-0001",
"partFile": "bracket_assembly.x_t",
"createdAt": "2026-01-11T17:30:00Z"
},
"blade": {
"position": { "x": 150.0, "y": 0.0, "z": 50.0 },
"normal": { "x": 1.0, "y": 0.0, "z": 0.0 },
"thickness": 6.0,
"length": "auto",
"overshoot": 25.0
},
"profile": {
"offset": 2.0,
"gravityDirection": "BOTTOM",
"gravityThreshold": 0.5
},
"trimming": {
"openSide": "top",
"openSideMargin": 15.0,
"sideExtension": { "left": 10.0, "right": 10.0 },
"gravityTrim": {
"enabled": true,
"side": "both",
"leftDist": 20.0,
"rightDist": 30.0
}
},
"edgeModifications": {
"blend": { "enabled": true, "radius": 1.0 }
},
"processingMode": {
"showProgress": true,
"debugLevel": 0
}
}
Per-blade customization of edge feature zones. Controls which zones receive grippers, plungers, or clamps.
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "BladeEdgeZoneConfig",
"type": "object",
"properties": {
"bladeId": {
"type": "integer",
"description": "Body number of the blade"
},
"zones": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"enum": [
"left-inside", "right-inside", "bottom-inside", "all-inside",
"left-outside", "right-outside", "bottom-outside",
"top-left", "top-right", "all-outside", "all-outside-except-base",
"all-no-topZFaces", "all-everything", "all-everything-except-base"
]
},
"enabled": { "type": "boolean", "default": true },
"toolType": { "type": "string", "enum": ["gripper", "plunger", "clamp"] },
"parameters": {
"type": "object",
"properties": {
"radius": { "type": "number" },
"interval": { "type": "number" },
"clearance": { "type": "number" },
"depthOffset": { "type": "number" }
}
}
},
"required": ["name"]
}
}
},
"required": ["bladeId", "zones"]
}
{
"bladeId": 80,
"zones": [
{
"name": "left-inside",
"enabled": true,
"toolType": "gripper",
"parameters": { "radius": 5.0, "interval": 50.0, "clearance": 2.0 }
},
{
"name": "right-inside",
"enabled": true,
"toolType": "gripper"
},
{
"name": "bottom-inside",
"enabled": false
}
]
}
Configuration for automatic detection and marking of sharp edges that pose safety hazards.
{
"dangerZone": {
"enabled": true,
"angle": 45,
"distance": 3.0,
"blend": {
"enabled": true,
"radius": 1.0
},
"marking": {
"color": { "r": 255, "g": 0, "b": 0 },
"pattern": "crosshatch"
}
}
}
| Field | Type | Description |
|---|---|---|
enabled | boolean | Enable danger zone detection |
angle | number | Threshold angle (degrees) for sharp edge detection |
distance | number | Detection zone width from edge |
blend.enabled | boolean | Auto-blend sharp edges |
blend.radius | number | Blend radius for sharp edges |
Clamp types are defined once at the file level in a reusable library, then referenced by ID at the blade level. This avoids duplication and ensures consistency.
{
"clampShelfLibrary": {
"BT-STD-14": {
"partNumber": "CMP-BT-001",
"description": "Standard 14ga bend-tab clamp, 40mm shelf",
"variant": "bendTab",
"material": { "gauge": 14, "thickness": 2.0, "material": "mild-steel" },
"shelf": { "span": 15, "width": 40 },
"leg": { "length": 60, "count": 1 },
"bends": {
"kick": -135,
"kFactor": 0.4,
"insideRadius": 1.5,
"relief": { "type": "notch", "width": 4.0, "depth": 2.5, "shape": "semicircle" }
},
"formingMethod": "hand",
"ribConnection": { "width": 8.0 },
"backStop": { "overhang": 10 },
"ratchet": { "slotCount": 5, "slotSpacing": 5.0 },
"holes": {
"shelf": {
"pattern": "linear",
"count": 3,
"dia": 5.0,
"spacing": 15.0,
"origin": "center",
"axis": "width"
},
"pin": { "dia": 3.0, "fromTop": 8 }
},
"cornerBlends": {
"shelfEdges": 1.5,
"backStopEdges": 1.0,
"lockingProngs": 0.5,
"legEdges": 1.0
}
},
"SP-HEAVY-2G": {
"partNumber": "CMP-SP-001",
"description": "Heavy-duty side plate, 2 gussets, bolted",
"variant": "sidePlate",
"material": { "gauge": 10, "thickness": 3.0 },
"shelf": { "width": 60, "depth": 25 },
"gussets": { "count": 2, "angle": 45, "height": 40 },
"fasteners": { "type": "bolt", "dia": 6.0, "count": 4 },
"holes": {
"shelf": {
"pattern": "grid",
"rows": 2, "cols": 2,
"dia": 6.5,
"spacingX": 30.0, "spacingY": 15.0,
"origin": "center",
"countersink": { "dia": 12.0, "depth": 3.0 }
}
}
}
}
}
Define custom cutout shapes for shelf mating plates. Supports PEPS kurve format (native), SVG path syntax, or parametric shapes.
{
"customProfiles": {
"SLOT-OBROUND": {
"description": "Obround slot for adjustment",
"origin": "center",
"format": "parametric",
"shape": "obround",
"width": 20,
"height": 8
},
"SLOT-RECT": {
"description": "Simple rectangular slot",
"origin": "center",
"format": "parametric",
"shape": "rectangle",
"width": 15,
"height": 6,
"cornerRadius": 1
},
"KEYHOLE-SM": {
"description": "Small keyhole slot",
"origin": "center",
"format": "peps-kurve",
"data": "x-3 y0 a-3 y6 x0 y3 tx-1.5 y6 tx-1.5 y12 a3 y12 x0 y9 ..."
},
"CUSTOM-PROFILE-001": {
"description": "Complex profile from SVG",
"origin": "center",
"format": "svg-path",
"data": "M-10,-5 L10,-5 A5,5 0 0,1 10,5 L-10,5 A5,5 0 0,1 -10,-5 Z"
}
}
}
| Format | Description | Use Case |
|---|---|---|
parametric | Simple shapes: rectangle, obround, circle | Standard slots and holes |
peps-kurve | Native PEPS kurve syntax | Complex profiles from CAD |
svg-path | SVG path data (d attribute) | Import from design tools |
Reference library clamp types at specific positions on blade faces.
{
"blades": {
"BLADE-001": {
"clamps": [
{
"ref": "BT-STD-14",
"face": "left-inside",
"position": { "mode": "percent", "value": 0 },
"ratchetSlotIndex": 3,
"tiltOverride": 10
},
{
"ref": "BT-STD-14",
"face": "left-inside",
"position": { "mode": "percent", "value": 100 }
},
{
"ref": "SP-HEAVY-2G",
"face": "right-outside",
"position": { "mode": "absolute", "value": 150.0 }
}
]
}
}
}
| Field | Type | Description |
|---|---|---|
ref | string | Key from clampShelfLibrary |
face | string | Zone name (left-inside, right-outside, etc.) |
position.mode | string | "percent" (0-100) or "absolute" (mm) |
position.value | number | Position along face edge |
ratchetSlotIndex | integer | Which ratchet slot to engage (optional) |
tiltOverride | number | Override default tilt angle (optional) |
Comprehensive hole pattern definitions for shelf plates. Supports linear, grid, radial, and custom arrangements.
{
"holes": {
"shelf": {
"pattern": "linear",
"count": 3,
"dia": 5.0,
"spacing": 15.0,
"origin": "center",
"axis": "width",
"rotation": 0
}
}
}
{
"holes": {
"shelf": {
"pattern": "grid",
"rows": 2,
"cols": 3,
"dia": 6.0,
"spacingX": 20.0,
"spacingY": 15.0,
"origin": "center",
"countersink": { "dia": 12.0, "depth": 3.0 }
}
}
}
{
"holes": {
"shelf": {
"pattern": "radial",
"count": 6,
"dia": 4.0,
"boltCircleDia": 40.0,
"startAngle": 0,
"origin": "center"
}
}
}
Control execution behavior for interactive vs batch processing.
{
"processingMode": {
"headless": false,
"showProgress": true,
"progressMinDelta": 10,
"debugLevel": 0,
"suppressGraphics": false,
"limitViewMode": false
}
}
| Field | Type | Default | Description |
|---|---|---|---|
headless | boolean | false | Run without UI prompts |
showProgress | boolean | true | Display progress indicator |
progressMinDelta | integer | 10 | Minimum % change before updating progress |
debugLevel | integer | 0 | 0=OFF, 1=SUMMARY, 2=VERBOSE, 3+=PAUSE |
suppressGraphics | boolean | false | Disable screen updates during heavy operations |
Control output layer, colors, and export options.
{
"output": {
"layer": "BLADE",
"color": { "r": 93, "g": 63, "b": 211 },
"dxf": {
"enabled": false,
"path": "output/",
"prefix": "blade_"
},
"refMarker": {
"color": { "r": 255, "g": 0, "b": 0 },
"diameter": 3.0
}
}
}
Schemas for flex clamps, integral springs, pivot hinges, and copper backing plates.
{
"edgeFeatureLibrary": {
"FLEX-CLAMP-TURNBUCKLE-01": {
"type": "turnbuckleFlexClamp",
"partNumber": "EF-TFC-001",
"description": "Turnbuckle-actuated flex clamp for laser welding",
"flexPlates": {
"count": 2,
"shape": "roundedRect",
"thickness": 3.0,
"width": 50,
"height": 100,
"cornerRadius": 15,
"spacing": 5.0
},
"waveSpring": {
"pattern": "serpentine",
"cuts": 3,
"amplitude": 5.0,
"slotWidth": 2.0,
"wavelength": 15.0
},
"actuator": {
"type": "turnbuckle",
"threadDia": 8.0,
"threadPitch": 1.25,
"length": 80.0,
"rodEnd": { "type": "female", "bore": 8.0, "bearingType": "spherical" }
},
"mounting": {
"slots": { "count": 6, "width": 10, "length": 25, "spacing": 20 }
},
"backingAccess": {
"slots": { "rows": 2, "cols": 3, "width": 20, "height": 15, "spacing": 25 }
},
"cornerBlends": { "flexPlateEdges": 2.0, "mountingBracket": 1.0 }
}
}
}
{
"edgeFeatureLibrary": {
"FLEX-SPRING-INTEGRAL-01": {
"type": "integralFlexSpring",
"partNumber": "EF-IFS-001",
"description": "Integral serpentine flex spring - passive compliance",
"pattern": "serpentine",
"material": { "gauge": 14, "thickness": 2.0 },
"spring": {
"slotWidth": 2.0,
"slotCount": 5,
"amplitude": 8.0,
"wavelength": 15.0,
"length": 60.0
},
"contactPad": { "width": 20.0, "height": 30.0, "shape": "rounded" },
"springRate": "medium",
"travelRange": { "min": 0, "max": 5.0 },
"mountStyle": "integral"
}
}
}
{
"edgeFeatureLibrary": {
"PIVOT-HINGE-01": {
"type": "pivotHinge",
"partNumber": "EF-PH-001",
"description": "45-degree indexed pivot hinge",
"pinDia": 6.0,
"bushing": { "type": "bronze", "id": 6.0, "od": 10.0 },
"range": { "min": -15, "max": 45 },
"detents": [0, 15, 30, 45],
"detentStrength": "medium",
"lockingPin": { "dia": 3.0, "type": "spring-loaded" }
}
}
}
{
"edgeFeatureLibrary": {
"COPPER-BACKING-01": {
"type": "copperBacking",
"partNumber": "EF-CB-001",
"description": "Copper backing plate for weld heat management",
"material": { "type": "copper", "thickness": 3.0 },
"width": 25.0,
"length": 100.0,
"standoff": 0.5,
"mounting": { "type": "clip", "slots": 2 },
"cooling": { "channels": false }
}
}
}