diff --git a/schemas/code-crispies-module-schema.json b/schemas/code-crispies-module-schema.json index 81d2a1e..08cb8ed 100644 --- a/schemas/code-crispies-module-schema.json +++ b/schemas/code-crispies-module-schema.json @@ -99,6 +99,26 @@ "type": "string", "description": "ID of the container element for the preview" }, + "concept": { + "type": "object", + "description": "Conceptual explanation of WHY the CSS/HTML works, not just syntax", + "properties": { + "explanation": { + "type": "string", + "description": "Beginner-friendly explanation (2-4 sentences) of the concept behind the lesson" + }, + "diagram": { + "type": "string", + "description": "Optional SVG markup or ASCII art diagram to visualize the concept" + }, + "containerVsItem": { + "type": "string", + "description": "Optional explanation for Flexbox/Grid lessons to clarify container vs item distinction" + } + }, + "required": ["explanation"], + "additionalProperties": false + }, "validations": { "type": "array", "description": "Rules to validate user input",