Immobilier

{
  "type": "object",
  "required": [
    "bailleur_nom",
    "locataire_nom",
    "logement_adresse",
    "loyer_actuel",
    "date_effet"
  ],
  "properties": {
    "lieu": {
      "type": "string",
      "description": "Lieu d'émission imprimé avant la date (« Fait à … »)."
    },
    "annee": {
      "type": "integer",
      "description": "Année du nouvel indice (défaut : la plus récente publiée)."
    },
    "trimestre": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Trimestre de référence du bail (1-4) : les deux IRL et leurs libellés sont lus dans les indices INSEE tenus à jour."
    },
    "date_effet": {
      "type": "string",
      "description": "Date d'application du nouveau loyer. Format ISO AAAA-MM-JJ. Par défaut, la date du jour. La révision ne rétroagit pas au-delà d'un an (art. 17-1, loi 89-462)."
    },
    "irl_nouveau": {
      "type": "number",
      "description": "Valeur de l'IRL du même trimestre, publiée par l'INSEE cette année (facultatif si `trimestre` est donné)."
    },
    "bailleur_nom": {
      "type": "string",
      "description": "Bailleur qui notifie la révision."
    },
    "loyer_actuel": {
      "type": "number",
      "description": "Loyer hors charges en vigueur avant révision, en euros."
    },
    "irl_reference": {
      "type": "number",
      "description": "Valeur de l'IRL du trimestre de référence inscrit au bail (facultatif si `trimestre` est donné)."
    },
    "locataire_nom": {
      "type": "string",
      "description": "Locataire destinataire de la notification."
    },
    "bailleur_adresse": {
      "type": "string",
      "description": "Adresse du bailleur, en en-tête."
    },
    "logement_adresse": {
      "type": "string",
      "description": "Adresse du bien loué (objet du courrier)."
    },
    "locataire_adresse": {
      "type": "string",
      "description": "Adresse POSTALE du locataire (fenêtre) — ex. \"12 rue de la Paix\\n75002 Paris\"."
    },
    "trimestre_nouveau": {
      "type": "string",
      "description": "Trimestre correspondant de l'année en cours — « T2 2026 »."
    },
    "trimestre_reference": {
      "type": "string",
      "description": "Trimestre de référence du bail — « T2 2025 ». C'est le bail qui le fixe, pas l'usage."
    }
  }
}

{
  "type": "object",
  "required": [
    "bailleur_nom",
    "locataire_nom",
    "periode"
  ],
  "properties": {
    "bic": {
      "type": "string",
      "description": "BIC de la banque du bailleur, facultatif pour un virement SEPA."
    },
    "iban": {
      "type": "string",
      "description": "IBAN de encaissement affiché pour le virement. Reproduit tel quel, jamais vérifié ni stocké."
    },
    "lieu": {
      "type": "string",
      "description": "Lieu d'émission imprimé avant la date (« Fait à … »)."
    },
    "loyer": {
      "type": "number",
      "description": "Loyer hors charges, en euros. Nombre, sans symbole ni séparateur de milliers."
    },
    "lignes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Lignes supplémentaires à ajouter au décompte (parking, garage, régularisation). Chaque objet porte un libellé et un montant."
    },
    "charges": {
      "type": "number",
      "description": "Provision pour charges du mois, en euros. Régularisée séparément par `regularisation_charges`."
    },
    "periode": {
      "type": "string",
      "description": "Période appelée, en clair — par exemple « mars 2026 » ou « 1er au 31 mars 2026 »."
    },
    "reference": {
      "type": "string",
      "description": "Référence à rappeler par le locataire dans le libellé de son virement."
    },
    "bailleur_nom": {
      "type": "string",
      "description": "Nom du bailleur émetteur, tel qu'il doit figurer sur l'avis."
    },
    "date_echeance": {
      "type": "string",
      "description": "Date limite de paiement, format ISO AAAA-MM-JJ. Par défaut, la date d'émission."
    },
    "date_emission": {
      "type": "string",
      "description": "Date d'émission, format ISO AAAA-MM-JJ. Par défaut, la date du jour."
    },
    "locataire_nom": {
      "type": "string",
      "description": "Nom du locataire appelé à payer ; apparaît dans le bloc destinataire."
    },
    "bailleur_adresse": {
      "type": "string",
      "description": "Adresse postale complète du bailleur (expéditeur)."
    },
    "logement_adresse": {
      "type": "string",
      "description": "Adresse du logement loué, si elle diffère de celle du locataire."
    },
    "locataire_adresse": {
      "type": "string",
      "description": "Adresse du locataire. Sert au bloc fenêtre : elle est poussée À DROITE pour une enveloppe à fenêtre."
    }
  }
}

{
  "type": "object",
  "required": [
    "titre"
  ],
  "properties": {
    "lots": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Lots de copropriété concernés, quand l'intervention est refacturée à plusieurs."
    },
    "type": {
      "type": "string",
      "description": "Corps d'état concerné : plomberie, électricité, serrurerie, chauffage, menuiserie."
    },
    "titre": {
      "type": "string",
      "description": "Objet de l'intervention en une ligne — « Fuite sous l'évier, cuisine »."
    },
    "urgence": {
      "type": "string",
      "description": "Degré d'urgence : « normale », « urgente » (sous 48 h) ou « immédiate » (sécurité, dégât des eaux, coupure)."
    },
    "echeance": {
      "type": "string",
      "description": "Date souhaitée d'achèvement, format ISO AAAA-MM-JJ."
    },
    "agence_nom": {
      "type": "string",
      "description": "Nom du donneur d'ordre — agence ou syndic qui commande l'intervention."
    },
    "cout_estime": {
      "type": "number",
      "description": "Plafond de dépense autorisé sans nouvel accord, en euros. Le mandat de gérance en fixe souvent le seuil."
    },
    "description": {
      "type": "string",
      "description": "Constat détaillé : ce qui est cassé, depuis quand, ce qui a déjà été tenté. C'est ce que l'artisan lira pour chiffrer."
    },
    "agence_adresse": {
      "type": "string",
      "description": "Adresse du donneur d'ordre, pour la facturation."
    },
    "prestataire_nom": {
      "type": "string",
      "description": "Artisan ou entreprise à qui le bon est adressé."
    },
    "prestataire_adresse": {
      "type": "string",
      "description": "Adresse du prestataire. Sert au bloc fenêtre, poussé À DROITE."
    },
    "adresse_intervention": {
      "type": "string",
      "description": "Adresse exacte du lieu à dépanner, avec bâtiment, étage et numéro de lot si nécessaire."
    }
  }
}

{
  "type": "object",
  "required": [
    "candidat_nom",
    "agence_adresse"
  ],
  "properties": {
    "lieu": {
      "type": "string",
      "description": "Lieu d'établissement du dossier (« Fait à … »)."
    },
    "message": {
      "type": "string",
      "description": "Mot du candidat à l'agence, ajouté au corps du dossier."
    },
    "agence_nom": {
      "type": "string",
      "description": "Agence ou bailleur destinataire du dossier."
    },
    "garant_nom": {
      "type": "string",
      "description": "Nom du garant, s'il y en a un. La caution se formalise par un acte distinct."
    },
    "candidat_nom": {
      "type": "string",
      "description": "Nom et prénom du candidat locataire."
    },
    "candidat_tel": {
      "type": "string",
      "description": "Téléphone du candidat, pour que l'agence puisse le rappeler."
    },
    "nb_occupants": {
      "type": "number",
      "description": "Nombre de personnes qui occuperont le logement, enfants compris."
    },
    "date_emission": {
      "type": "string",
      "description": "Date d'établissement, format ISO AAAA-MM-JJ. Par défaut, la date du jour."
    },
    "situation_pro": {
      "type": "string",
      "description": "Situation professionnelle : CDI, CDD, indépendant, retraité, étudiant. Détermine les pièces attendues."
    },
    "agence_adresse": {
      "type": "string",
      "description": "Adresse de l'agence. Sert au bloc fenêtre, poussé À DROITE."
    },
    "candidat_email": {
      "type": "string",
      "description": "Adresse e-mail du candidat."
    },
    "pieces_jointes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Libellés des pièces jointes au dossier. ⚠️ Les libellés seulement : ce service ne transporte aucun document."
    },
    "candidat_adresse": {
      "type": "string",
      "description": "Adresse actuelle du candidat, avant emménagement."
    },
    "logement_adresse": {
      "type": "string",
      "description": "Adresse du logement demandé."
    },
    "revenus_mensuels": {
      "type": "number",
      "description": "Revenus nets mensuels du foyer, en euros. Sert au taux d'effort ; aucun seuil n'est appliqué ici."
    },
    "reference_annonce": {
      "type": "string",
      "description": "Référence de l'annonce, pour rattacher le dossier au bon lot."
    },
    "date_entree_souhaitee": {
      "type": "string",
      "description": "Date d'emménagement souhaitée, format ISO AAAA-MM-JJ."
    }
  }
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Optional date, YYYY-MM-DD: the state of the site on that day."
    },
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "debut": {
      "type": "string",
      "description": "Site start date, YYYY-MM-DD (today by default)."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "images": {
      "type": "boolean",
      "default": true,
      "description": "Include the SVG views."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "ifc": {
      "type": "string",
      "description": "IFC file content as STEP text (IFC2X3 or IFC4), e.g. an architect's model. When given, scene fields are ignored."
    },
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "number",
      "description": "Coefficient de comportement sismique"
    },
    "sol": {
      "type": "string",
      "description": "Classe de sol EC8 (A-E)"
    },
    "zone": {
      "type": "number",
      "description": "Zone sismique 1-5"
    },
    "debut": {
      "type": "string",
      "description": "Date de debut ISO (courbe S + CPM)"
    },
    "phase": {
      "type": "string",
      "description": "esquisse | aps | apd | dce | execution"
    },
    "scene": {
      "type": "object",
      "description": "Scene CAO complete"
    },
    "seuils": {
      "type": "object",
      "description": "Seuils des ratios de conception"
    },
    "terrain": {
      "type": "object",
      "description": "{pays: fr | usa | ch | gb | de | es | it}"
    },
    "maille_m": {
      "type": "number",
      "description": "Maille du terrassement (defaut 5)"
    },
    "date_limite": {
      "type": "string",
      "description": "Date limite contractuelle (retard CPM)"
    },
    "points_terrain": {
      "type": "array",
      "description": "[{x, y, z}] du terrain"
    },
    "type_structure": {
      "type": "string",
      "description": "portique | voile | mixte"
    },
    "altitude_plateforme": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "csv": {
      "type": "string",
      "description": "Pour action=importer_csv : texte CSV (type;param1;param2...)"
    },
    "type": {
      "type": "string",
      "description": "Pour action=instancier : nom du type"
    },
    "action": {
      "type": "string",
      "description": "stats (defaut) | rechercher | instancier | selectionner | catalogue | importer | importer_csv | exporter | exporter_json"
    },
    "entree": {
      "type": "array",
      "description": "Pour action=importer : [{nom, fabricant, categorie, parametres, types, ...}]"
    },
    "famille": {
      "type": "string",
      "description": "Pour action=instancier : nom de la famille"
    },
    "mot_cle": {
      "type": "string",
      "description": "Pour action=rechercher : mot-cle"
    },
    "criteres": {
      "type": "object",
      "description": "Pour action=selectionner : {parametre: valeur} ou {parametre: [min, max]}"
    },
    "appliquer": {
      "type": "boolean",
      "description": "Pour action=importer : appliquer au catalogue memoire (defaut false)"
    },
    "categorie": {
      "type": "string",
      "description": "menuiserie | sanitaire | chauffage | ventilation | electricite | structure | cloison_isolation"
    },
    "fabricant": {
      "type": "string",
      "description": "Pour action=rechercher : nom du fabricant"
    },
    "supplements": {
      "type": "array",
      "description": "Pour action=exporter_json : familles supplementaires a fusionner"
    }
  }
}

{
  "type": "object",
  "required": [],
  "properties": {
    "c": {
      "type": "number",
      "description": "Pour action=pertes_reseau/hmt : coefficient Hazen-Williams (defaut 140)"
    },
    "zeta": {
      "type": "number"
    },
    "action": {
      "type": "string",
      "description": "reseau (defaut) | debits | pertes_reseau | hmt | tableau | chute_tension | disjoncteur | gaine | gaine_friction"
    },
    "courbe": {
      "type": "string"
    },
    "reseau": {
      "type": "object",
      "description": "Reseau MEP : {noeuds:{id:source|appareil|noeud}, liaisons:[{de, vers, diametre_mm, debit_l_min}]}"
    },
    "circuit": {
      "type": "object",
      "description": "Pour action=chute_tension : {puissance_kw|courant_a, section_mm2, longueur_m, usage}"
    },
    "circuits": {
      "type": "array",
      "description": "Pour action=tableau : [{nom, puissance_kw, usage, tri, section_mm2, longueur_m}]"
    },
    "demandes": {
      "type": "object",
      "description": "Pour action=debits/pertes_reseau/hmt : {noeud_appareil: debit_l_min}"
    },
    "courant_a": {
      "type": "number"
    },
    "debit_m3h": {
      "type": "number"
    },
    "denivele_m": {
      "type": "number",
      "description": "Pour action=hmt : denivele geometrique (m)"
    },
    "longueur_m": {
      "type": "number"
    },
    "diametre_mm": {
      "type": "number"
    },
    "rugosite_mm": {
      "type": "number"
    },
    "perte_lin_pa_m": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "x": {
      "type": "number"
    },
    "y": {
      "type": "number"
    },
    "nom": {
      "type": "string",
      "description": "Pour creer/placer : nom du niveau (RDC, R+1...)"
    },
    "type": {
      "type": "string",
      "description": "Pour placer : type du catalogue"
    },
    "z_mm": {
      "type": "number",
      "description": "Pour creer : altitude du niveau (mm)"
    },
    "scene": {
      "type": "object",
      "description": "Scene CAO avec niveaux_definition [{nom, z_mm}]"
    },
    "action": {
      "type": "string",
      "description": "creer | niveaux | placer | verifier (defaut)"
    },
    "famille": {
      "type": "string",
      "description": "Pour placer : famille du catalogue"
    },
    "type_donnees": {
      "type": "object",
      "description": "Pour placer : donnees directes de l'instance"
    }
  }
}

{
  "type": "object",
  "properties": {
    "x": {
      "type": "number"
    },
    "y": {
      "type": "number"
    },
    "z": {
      "type": "number"
    },
    "type": {
      "type": "string",
      "description": "Pour placer : nom du type catalogue (EI30, 900x1350...)"
    },
    "scene": {
      "type": "object",
      "description": "Scene CAO courante"
    },
    "action": {
      "type": "string",
      "description": "placer (defaut) | instances | nomenclature | verifier"
    },
    "famille": {
      "type": "string",
      "description": "Pour placer : nom de famille du catalogue (porte_coupe_feu, fenetre_bois, poteau_prefab...)"
    },
    "position": {
      "type": "object",
      "description": "Position {x, y, z} alternative"
    },
    "rotation": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "required": [
    "scene"
  ],
  "properties": {
    "q": {
      "type": "number",
      "description": "Pour action=dossier : coefficient de comportement sismique"
    },
    "sol": {
      "type": "string",
      "description": "Pour action=dossier : classe de sol EC8 (A-E)"
    },
    "zone": {
      "type": "number",
      "description": "Pour action=dossier : zone sismique 1-5 (sismique incluse si fournie)"
    },
    "debut": {
      "type": "string",
      "description": "Pour action=dossier : date ISO de debut (courbe en S incluse si fournie)"
    },
    "phase": {
      "type": "string",
      "description": "Phase : esquisse, aps, apd, dce, execution (defaut apd)"
    },
    "scene": {
      "type": "object",
      "description": "Scene CAO (murs, boites, ouvertures, escaliers, garde_corps, rampes, pieces...)"
    },
    "action": {
      "type": "string",
      "description": "defaut (vue projet) | dossier"
    },
    "format": {
      "type": "string",
      "description": "Pour action=dossier : json (defaut) | html | pdf — le document unique imprimable"
    },
    "terrain": {
      "type": "object",
      "description": "Localisation : {pays: fr | usa | ch | gb} (defaut fr)"
    },
    "maille_m": {
      "type": "number",
      "description": "Pour action=dossier : maille (m) du terrassement (defaut 5)"
    },
    "points_terrain": {
      "type": "array",
      "description": "Pour action=dossier : [{x, y, z}] du terrain (piece terrain incluse si fournis)"
    },
    "type_structure": {
      "type": "string",
      "description": "Pour action=dossier : portique | voile | mixte"
    },
    "altitude_plateforme": {
      "type": "number",
      "description": "Pour action=dossier : altitude (m) de la plateforme"
    }
  }
}

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "g_kn": {
      "type": "number"
    },
    "lx_m": {
      "type": "number"
    },
    "ly_m": {
      "type": "number"
    },
    "n_kn": {
      "type": "number"
    },
    "psi2": {
      "type": "number"
    },
    "q_kn": {
      "type": "number"
    },
    "type": {
      "type": "string",
      "description": "poutre | dalle | poteau | tranchant | flexion_composee | flambement | moment_dalle | poinconnement | dalle_complete | voile | pieu | combinaisons | tranchant_arme"
    },
    "as_m2": {
      "type": "number"
    },
    "m_knm": {
      "type": "number"
    },
    "cu_kpa": {
      "type": "number"
    },
    "continu": {
      "type": "boolean"
    },
    "fcd_mpa": {
      "type": "number"
    },
    "fck_mpa": {
      "type": "number"
    },
    "n_ed_kn": {
      "type": "number"
    },
    "v_ed_kn": {
      "type": "number"
    },
    "mu_kn_m2": {
      "type": "number"
    },
    "portee_m": {
      "type": "number"
    },
    "largeur_m": {
      "type": "number"
    },
    "diametre_m": {
      "type": "number"
    },
    "longueur_m": {
      "type": "number"
    },
    "section_m2": {
      "type": "number"
    },
    "charge_kn_m": {
      "type": "number"
    },
    "epaisseur_m": {
      "type": "number"
    },
    "as_tendu_cm2": {
      "type": "number"
    },
    "hauteur_utile_m": {
      "type": "number"
    },
    "perimetre_controle_m": {
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "jeton": {
      "type": "string",
      "description": "Jeton de session"
    },
    "scene": {
      "type": "object",
      "description": "Pour action=creer : la scene initiale partagee"
    },
    "acteur": {
      "type": "string",
      "description": "Acteur courant (architecte, bet_structure, bet_fluides...)"
    },
    "action": {
      "type": "string",
      "description": "creer (defaut) | joindre | modifier | verrouiller | deverrouiller | etat | scene | synchroniser | terminer"
    },
    "acteurs": {
      "type": "array",
      "description": "Pour action=creer : [acteurs initiaux]"
    },
    "element": {
      "type": "string",
      "description": "Pour verrouiller/deverrouiller : ex. murs[0]"
    },
    "base_version": {
      "type": "number",
      "description": "Pour action=modifier : version sur laquelle l'acteur a travaille"
    },
    "modifications": {
      "type": "array",
      "description": "Pour action=modifier : [{action: modifier|ajouter|retirer, element|conteneur, champs|valeur}]"
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "projet": {
      "type": "object",
      "description": "Title block: titre, maitre_ouvrage (client), auteur, adresse, phase (ESQ, APS, APD, PC, PRO, DCE, EXE, DOE), format_feuille (A3 or A1), revisions [{indice, date, objet}] with the current revision last."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "ifc": {
      "type": "string",
      "description": "IFC file content as STEP text (IFC2X3 or IFC4), e.g. an architect's model. When given, scene fields are ignored."
    },
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "prix": {
      "type": "object",
      "description": "Optional unit prices excluding VAT, keyed by the item codes this tool returns, e.g. {'GO-SEMELLES': 250, 'CV-RADIATEUR': 450}."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "tva_pct": {
      "type": "number",
      "maximum": 30,
      "minimum": 0,
      "description": "Optional VAT rate in percent (5.5, 10 or 20 in France), to add a total including tax."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "appliquer": {
      "type": "boolean",
      "description": "Apply the proposed fixes to a copy of the scene."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "revalider": {
      "type": "boolean",
      "description": "With appliquer: re-run the check on the corrected scene."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  },
  "additionalProperties": true
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "climat": {
      "type": "object",
      "description": "{dju_base18, irradiation_saison_chauffe_kwh_m2: {sud, est, ouest, nord}, irradiation_aout_kwh_m2_jour: {...}} — Météo-France and PVGIS."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "options": {
      "type": "object",
      "description": "nord_deg, g_vitrage, inertie_kj_m2k, occupants…"
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "systeme": {
      "type": "object",
      "description": "{chauffage: {type, cop|rendement}, ecs: {...}, ventilation: 'simple_flux'|'double_flux'}."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    },
    "facteurs_carbone": {
      "type": "object",
      "description": "{item code: kgCO2e per unit}, same codes as cao_devis."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "required": [
    "base",
    "central",
    "locale"
  ],
  "properties": {
    "base": {
      "type": "object",
      "description": "The version both sides started from."
    },
    "locale": {
      "type": "object",
      "description": "Your changed copy, started from `base`."
    },
    "central": {
      "type": "object",
      "description": "The shared version as it is now (changed by others)."
    },
    "resolutions": {
      "type": "object",
      "description": "Optional: for each conflict id returned by a first call, \"central\" or \"local\"."
    },
    "empreinte_base": {
      "type": "string",
      "description": "Optional: sha256 of the base as you loaded it (sorted JSON, compact separators) — a different base is refused (409)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "armatures": {
      "type": "boolean",
      "default": false,
      "description": "Add the reinforcement computed per Eurocode 2 (bars and slab meshes)."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "bcf": {
      "type": "boolean",
      "default": false,
      "description": "True to add the failures as a BCF 2.1 zip in base64 (bcf_base64)."
    },
    "ids": {
      "type": "string",
      "description": "Optional IDS 1.0 XML text; default: our French housing IDS."
    },
    "ifc": {
      "type": "string",
      "description": "Optional IFC text (STEP) to check instead of the scene; an architect's model keeps its GlobalIds."
    },
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "appliquer": {
      "type": "boolean",
      "description": "Apply the proposed fixes to a copy of the scene."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "revalider": {
      "type": "boolean",
      "description": "With appliquer: re-run the check on the corrected scene."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  },
  "additionalProperties": true
}

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "string",
      "description": "Optional IDS (XML text) the IFC must satisfy."
    },
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "auteur": {
      "type": "string",
      "description": "Author, copied to the manifest."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "version": {
      "type": [
        "integer",
        "string"
      ],
      "description": "Version number, copied to the manifest."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "livrables": {
      "type": "array",
      "items": {
        "enum": [
          "ifc",
          "dxf",
          "pdf",
          "metres",
          "nomenclatures"
        ],
        "type": "string"
      },
      "description": "Deliverables to produce. Default: ifc, dxf, metres, nomenclatures."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    },
    "warnings_expliques": {
      "type": "object",
      "description": "{warning code: justification} for the warnings you accept."
    }
  },
  "additionalProperties": true
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "murs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start point X of the wall axis (mm)"
          },
          "x2": {
            "type": "number",
            "description": "End point X of the wall axis (mm)"
          },
          "y1": {
            "type": "number",
            "description": "Start point Y of the wall axis (mm)"
          },
          "y2": {
            "type": "number",
            "description": "End point Y of the wall axis (mm)"
          },
          "couches": {
            "type": "array",
            "description": "Optional inline material layers [{cle, epaisseur?}]. cle is one of enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer so it takes the remainder of the wall thickness."
          },
          "hauteur": {
            "type": "number",
            "default": 2500,
            "description": "Wall height (mm) from floor level. Default 2500, a usual French ceiling height"
          },
          "existant": {
            "type": "boolean",
            "description": "Optional: true for a wall of the EXISTING building when the scene is an extension. cao_permis then counts as created only what the works add."
          },
          "materiau": {
            "type": "string",
            "description": "Optional single material key: the whole thickness becomes one load-bearing layer instead of a type composition."
          },
          "epaisseur": {
            "type": "number",
            "default": 200,
            "description": "Wall thickness (mm), spread evenly on both sides of the axis — the axis is the centreline, not a face. Default 200"
          },
          "composition": {
            "type": "string",
            "description": "Optional key into the scene-level compositions object. When omitted, the exporter infers mur_exterieur / refend / cloison from geometry. A matching declared composition drops the Hypothese flag in the IFC."
          }
        }
      },
      "description": "Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you."
    },
    "plan": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x1",
          "y1",
          "x2",
          "y2"
        ],
        "properties": {
          "x1": {
            "type": "number",
            "description": "Start X (mm), same frame as murs[]"
          },
          "x2": {
            "type": "number",
            "description": "End X (mm), same frame as murs[]"
          },
          "y1": {
            "type": "number",
            "description": "Start Y (mm), same frame as murs[]"
          },
          "y2": {
            "type": "number",
            "description": "End Y (mm), same frame as murs[]"
          }
        }
      },
      "description": "2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks."
    },
    "titre": {
      "type": "string",
      "description": "Project title shown as the sheet's heading."
    },
    "auteur": {
      "type": "string",
      "description": "Optional: shown as 'Réalisé pour ...'."
    },
    "boites": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "l",
          "p",
          "h"
        ],
        "properties": {
          "h": {
            "type": "number",
            "description": "Height along Z (mm)"
          },
          "l": {
            "type": "number",
            "description": "Length along X before rotation (mm)"
          },
          "p": {
            "type": "number",
            "description": "Depth along Y before rotation (mm)"
          },
          "x": {
            "type": "number",
            "description": "Centre X of the box (mm) — not a corner"
          },
          "y": {
            "type": "number",
            "description": "Centre Y of the box (mm) — not a corner"
          },
          "z": {
            "type": "number",
            "default": 0,
            "description": "Underside height above the floor (mm). 0 = resting on the floor; raise it for a wall unit or a shelf"
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Rotation around the box centre, in DEGREES counter-clockwise (not radians). Default 0"
          }
        }
      },
      "description": "Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]."
    },
    "georef": {
      "type": "object",
      "properties": {
        "crs": {
          "type": "string",
          "description": "Projected CRS name. Default EPSG:2154 (Lambert-93)."
        },
        "est": {
          "type": "number",
          "description": "Easting in metres in the CRS. Omit if unknown — never invent."
        },
        "nord": {
          "type": "number",
          "description": "Northing in metres in the CRS. Omit if unknown — never invent."
        },
        "altitude": {
          "type": "number",
          "description": "Orthogonal height in metres (NGF-IGN69 for Lambert-93)."
        },
        "orientation": {
          "type": "number",
          "description": "Angle in degrees of the project's X axis from map East, counterclockwise. Default 0."
        }
      },
      "description": "Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise."
    },
    "cercles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "x",
          "y",
          "r"
        ],
        "properties": {
          "r": {
            "type": "number",
            "description": "Radius, same unit as plan[]"
          },
          "x": {
            "type": "number",
            "description": "Centre X, same unit as plan[]"
          },
          "y": {
            "type": "number",
            "description": "Centre Y, same unit as plan[]"
          }
        }
      },
      "description": "Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes."
    },
    "reseaux": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "trace"
        ],
        "properties": {
          "type": {
            "enum": [
              "ef",
              "ec",
              "eu",
              "ev",
              "ep",
              "chauffage"
            ],
            "type": "string",
            "default": "ef"
          },
          "trace": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "At least 2 points (mm), freely drawn in plan"
          },
          "diametre": {
            "type": "number",
            "description": "mm, default per type"
          }
        }
      },
      "description": "Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type)."
    },
    "toitures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "description": "'chien_assis' only: center x"
          },
          "y": {
            "type": "number",
            "description": "'chien_assis' only: center y — POSITION it on the carrying roof slope"
          },
          "z": {
            "type": "number",
            "description": "Base altitude (mm) — default: top of the walls covered"
          },
          "apex": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "z": {
                "type": "number"
              }
            },
            "description": "Free apex position — 'personnalise' only (default: 'plat' if omitted)"
          },
          "murs": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Wall indices this roof section covers (default: all walls). Ignored if `polygone` is given."
          },
          "type": {
            "enum": [
              "chien_assis",
              "conique",
              "deux_pans",
              "dome",
              "personnalise",
              "plat",
              "quatre_pans"
            ],
            "type": "string",
            "default": "plat"
          },
          "rayon": {
            "type": "number",
            "description": "Base radius (mm) — 'conique'/'dome' (default: from footprint)"
          },
          "debord": {
            "type": "number",
            "default": 200,
            "description": "Eaves overhang (mm) on the auto footprint"
          },
          "hauteur": {
            "type": "number",
            "description": "'chien_assis' only: front wall height, default 900"
          },
          "largeur": {
            "type": "number",
            "description": "'chien_assis' only, default 1000"
          },
          "polygone": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number"
                },
                "y": {
                  "type": "number"
                }
              }
            },
            "description": "Custom footprint (mm) — overrides the auto rectangle. Any type except 'chien_assis'."
          },
          "rotation": {
            "type": "number",
            "default": 0,
            "description": "Ridge orientation in degrees — 'deux_pans' only (0 = along X axis)"
          },
          "segments": {
            "type": "integer",
            "default": 16,
            "description": "Facet count — 'conique'/'dome'"
          },
          "epaisseur": {
            "type": "number",
            "default": 180,
            "description": "Slab thickness (mm) — 'plat' only"
          },
          "profondeur": {
            "type": "number",
            "description": "'chien_assis' only, default 800"
          },
          "hauteur_faitage": {
            "type": "number",
            "default": 1200,
            "description": "Ridge/apex/dome height above z (mm); 600 for 'chien_assis'"
          }
        }
      },
      "description": "Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof."
    },
    "plomberie": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "h": {
            "type": "number"
          },
          "l": {
            "type": "number"
          },
          "p": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "baignoire",
              "chauffe_eau",
              "compteur_eau",
              "douche",
              "evier",
              "lavabo",
              "module_hydraulique",
              "pac_exterieure",
              "radiateur",
              "wc"
            ],
            "type": "string",
            "default": "evier"
          },
          "position": {
            "type": "number"
          },
          "rotation": {
            "type": "number",
            "default": 0
          }
        }
      },
      "description": "Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite."
    },
    "decoration": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur"
        ],
        "properties": {
          "mur": {
            "type": "integer",
            "description": "Index in murs[]"
          },
          "face": {
            "enum": [
              "interieur",
              "exterieur"
            ],
            "type": "string",
            "default": "interieur"
          },
          "type": {
            "enum": [
              "beton_cire",
              "carrelage_mural",
              "enduit",
              "lambris",
              "papier_peint",
              "peinture"
            ],
            "type": "string",
            "default": "peinture"
          },
          "couleur": {
            "type": "string",
            "description": "Hex color, e.g. '#e2e0d5' — default per type"
          },
          "finition": {
            "enum": [
              "mat",
              "satin",
              "brillant",
              "structure"
            ],
            "type": "string",
            "description": "Informational only, doesn't affect rendering"
          }
        }
      },
      "description": "Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid)."
    },
    "ouvertures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mur",
          "position",
          "largeur",
          "hauteur"
        ],
        "properties": {
          "z": {
            "type": "number",
            "description": "Sill height (mm) — default 900 (window) or 0 (door)"
          },
          "mur": {
            "type": "integer",
            "description": "Index of the host wall in murs[] (0-based)"
          },
          "type": {
            "enum": [
              "fenetre",
              "porte"
            ],
            "type": "string",
            "default": "fenetre"
          },
          "hauteur": {
            "type": "number",
            "description": "Opening height (mm), measured up from `z`. `z + hauteur` must stay under the wall height"
          },
          "largeur": {
            "type": "number",
            "description": "Opening width (mm) measured along the wall, from `position`. Must fit inside the wall segment"
          },
          "position": {
            "type": "number",
            "description": "Distance in mm from the wall's start (x1,y1)"
          }
        }
      },
      "description": "Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres."
    },
    "electricite": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "z": {
            "type": "number",
            "description": "Default per type (NF C 15-100-informed: outlets 30cm, switches 110cm; light/smoke detector/vmc default to ceiling height)"
          },
          "mur": {
            "type": "integer"
          },
          "type": {
            "enum": [
              "detecteur_fumee",
              "interrupteur",
              "luminaire",
              "prise",
              "prise_rj45",
              "prise_spe",
              "tableau_electrique",
              "va_et_vient",
              "vmc"
            ],
            "type": "string",
            "default": "prise"
          },
          "position": {
            "type": "number"
          }
        }
      },
      "description": "Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`)."
    },
    "compositions": {
      "type": "object",
      "description": "Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer."
    }
  }
}