passerelle-geo-components 0.2.0-alpha.1

package/schemas/scene_manifest.pydantic.py

@@ -0,0 +1,1000 @@
+# generated by datamodel-codegen:
+#   filename:  scene_manifest.schema.json
+#   timestamp: 2026-07-10T13:35:15+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any, Literal
+from uuid import UUID
+
+from pydantic import (
+    AnyUrl,
+    AwareDatetime,
+    BaseModel,
+    ConfigDict,
+    Field,
+    RootModel,
+    constr,
+)
+
+
+class Projection(RootModel[str]):
+    root: str = Field(
+        "mercator",
+        description="Projection cartographique. 'mercator' (défaut), 'globe' (MapLibre v5+), 'lambert93' (via adapter proj-lambert93). Enum ouverte : accepte x_<projet>_* avec fallback graceful 'mercator'.",
+        pattern="^x_[a-z_]+$",
+        title="Extension nommée par projet",
+    )
+
+
+class Unit(Enum):
+    metric = "metric"
+    imperial = "imperial"
+    nautical = "nautical"
+
+
+class Producer(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Producteur du manifest. Enum ouverte : accepte x_<projet>_* avec fallback graceful 'manual'.",
+        pattern="^x_[a-z_]+$",
+    )
+
+
+class RecipeUsed(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    slug: str | None = None
+    version_sha: str | None = None
+
+
+class Provenance(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    producer: Literal["qgis-sspcloud"] | Literal["cerema-livrables"] | Literal[
+        "atlas"
+    ] | Literal["manual"] | Producer = Field(
+        ...,
+        description="Producteur du manifest. Enum ouverte : accepte x_<projet>_* avec fallback graceful 'manual'.",
+    )
+    producer_version: str
+    source_project: str | None = Field(
+        None, description="Chemin projet source (ex: .qgz path)."
+    )
+    qgz_hash: str | None = Field(None, pattern="^sha256:[0-9a-f]{64}$")
+    agent_conversation_id: str | None = Field(
+        None, description="ID conversation LLM si issu d'un agent."
+    )
+    recipe_used: RecipeUsed | None = None
+    extensions: dict[
+        constr(pattern=r"^[a-z][a-z_0-9]*$"), dict[str, Any]
+    ] | None = Field(
+        None,
+        description="Extensions provenance par-projet (ex: atlas.native_payload_hash pour round-trip fidèle).",
+    )
+
+
+class Id(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="ID du fond de carte. Enum ouverte : accepte x_<projet>_* avec fallback graceful 'osm'.",
+        pattern="^x_[a-z_]+$",
+        title="Extension nommée par projet",
+    )
+
+
+class Toggles(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    labels: bool = Field(
+        True, description="Toggle labels basemap (absorbé de ex-overlays)."
+    )
+    buildings_3d: bool = Field(
+        False, description="Toggle fill-extrusion bâtiments natifs basemap."
+    )
+
+
+class Basemap(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: Literal["osm"] | Literal["plan-ign-v2"] | Literal["plan-ign-v2-gris"] | Literal[
+        "ortho-ign"
+    ] | Literal["hillshade-ign"] | Literal["dsfr-sobre"] | Literal["etalab"] | Literal[
+        "openfreemap-liberty"
+    ] | Literal[
+        "openfreemap-bright"
+    ] | Literal[
+        "openfreemap-positron"
+    ] | Literal[
+        "cartodb-positron-nolabels"
+    ] | Literal[
+        "custom"
+    ] | Id = Field(
+        ...,
+        description="ID du fond de carte. Enum ouverte : accepte x_<projet>_* avec fallback graceful 'osm'.",
+    )
+    style: dict[str, Any] | None = Field(
+        None,
+        description="Style JSON MapLibre v8 (utilisé si id='custom' ou fallback si id inconnu).",
+    )
+    alternatives: list[str] | None = Field(
+        None, description="IDs alternatifs pour switcher UI runtime."
+    )
+    toggles: Toggles | None = None
+
+
+class Kind(Enum):
+    commune = "commune"
+    insee_arm = "insee_arm"
+
+
+class Zone2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Kind
+    insee: str = Field(
+        ...,
+        description="Code INSEE 5 chars (commune 75001-...; arrondissement 75101-75120, 13201-13216, 69381-69389).",
+        pattern="^[0-9AB]{5}$",
+    )
+    buffer_km: float | None = Field(
+        None,
+        description="Rayon buffer autour de la commune (facultatif).",
+        ge=0.0,
+        le=50.0,
+    )
+    pitch: float | None = Field(None, ge=0.0, le=85.0)
+    bearing: float | None = Field(None, ge=-180.0, le=180.0)
+    max_pitch: float = Field(60, ge=0.0, le=85.0)
+
+
+class Zone3(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Literal["auto_bounds"]
+    pitch: float | None = Field(None, ge=0.0, le=85.0)
+    bearing: float | None = Field(None, ge=-180.0, le=180.0)
+    max_pitch: float = Field(60, ge=0.0, le=85.0)
+
+
+class Zone4(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    kind: str = Field(
+        ..., description="Extension nommée par projet.", pattern="^x_[a-z_]+$"
+    )
+
+
+class BBox(RootModel[list[float]]):
+    root: list[float] = Field(
+        ...,
+        description="Bounding box [west, south, east, north] EPSG:4326 (GeoJSON RFC 7946 §5).",
+        max_length=4,
+        min_length=4,
+    )
+
+
+class Coord(RootModel[list[float]]):
+    root: list[float] = Field(
+        ...,
+        description="Coordonnée [longitude, latitude] EPSG:4326.",
+        max_length=2,
+        min_length=2,
+    )
+
+
+class CameraPreset(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: str = Field(
+        ..., description="Identifiant unique du preset (top, 3d, street, ...)."
+    )
+    pitch: float = Field(..., ge=0.0, le=85.0)
+    bearing: float = Field(..., ge=-180.0, le=180.0)
+    zoom: float = Field(..., ge=0.0, le=22.0)
+
+
+class SourceId(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Source DEM. Enum ouverte : accepte x_* pour custom.",
+        pattern="^x_[a-z_]+$",
+    )
+
+
+class Encoding(Enum):
+    mapbox = "mapbox"
+    terrarium = "terrarium"
+
+
+class Adapter(Enum):
+    ignmnt = "ignmnt"
+    NoneType_None = None
+
+
+class BlendMode(Enum):
+    multiply = "multiply"
+    normal = "normal"
+    overlay = "overlay"
+
+
+class Hillshade(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    opacity: float = Field(0.35, ge=0.0, le=1.0)
+    blend_mode: BlendMode = "multiply"
+
+
+class Terrain(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    source_id: Literal["ign-lidar"] | Literal["terrarium"] | Literal[
+        "custom"
+    ] | SourceId = Field(
+        ..., description="Source DEM. Enum ouverte : accepte x_* pour custom."
+    )
+    encoding: Encoding = "mapbox"
+    exaggeration: float = Field(1.0, ge=0.0, le=10.0)
+    adapter: Adapter | None = Field(
+        None,
+        description="Adapter chargé à la demande (registre ADAPTERS fermé). null si source_id ne nécessite pas d'adapter.",
+    )
+    custom_tiles_url: AnyUrl | None = Field(
+        None, description="URL tiles raster-dem si source_id='custom'."
+    )
+    hillshade: Hillshade | None = Field(
+        None, description="Effet hillshade (absorbe l'ex overlays.hillshade)."
+    )
+
+
+class LocationForSuncalc(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    lat: float | None = Field(None, ge=-90.0, le=90.0)
+    lng: float | None = Field(None, ge=-180.0, le=180.0)
+
+
+class Sky(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    enabled: bool = True
+    dynamic_sun: bool = Field(
+        True,
+        description="Recalcul SunCalc auto selon sun_datetime + location_for_suncalc.",
+    )
+    sun_datetime: AwareDatetime | None = None
+    location_for_suncalc: LocationForSuncalc | None = None
+
+
+class Role(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Rôle sémantique. Enum ouverte + fallback 'primary'.",
+        pattern="^x_[a-z_]+$",
+        title="Rôle métier custom (fallback: primary).",
+    )
+
+
+class GeometryType(Enum):
+    point = "point"
+    line = "line"
+    polygon = "polygon"
+    multipolygon = "multipolygon"
+    raster = "raster"
+
+
+class AttributeStats(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    min: float | None = None
+    max: float | None = None
+    null_count: int | None = None
+    distinct_count: int | None = None
+    distinct_values: list[Any] | None = None
+
+
+class Data(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["FeatureCollection"]
+    features: list[Any]
+
+
+class LayerSource1(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["geojson"]
+    data: AnyUrl | Data = Field(
+        ...,
+        description="FeatureCollection inline OU URL. AUTORISÉ UNIQUEMENT si n_features ≤ 500 (500 KB) — sinon warning validation, interdit au-delà de 5 MB.",
+    )
+    crs: Literal["EPSG:4326"] = "EPSG:4326"
+
+
+class LayerSource2(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["geojson_path"]
+    path: str = Field(..., description="Chemin PVC ou URL relative (résolu côté hub).")
+    crs: Literal["EPSG:4326"] = "EPSG:4326"
+
+
+class LayerSource3(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["vector"]
+    url: str = Field(
+        ..., description="URL template MapLibre : https://.../{z}/{x}/{y}.pbf"
+    )
+    source_layer: str
+    min_zoom: int | None = Field(None, ge=0, le=22)
+    max_zoom: int | None = Field(None, ge=0, le=22)
+    promote_id: str | None = None
+
+
+class LayerSource4(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["pmtiles"]
+    url: AnyUrl = Field(
+        ...,
+        description="URL fichier .pmtiles (résolu via pmtiles:// protocol MapLibre).",
+    )
+    source_layer: str
+    promote_id: str | None = None
+
+
+class Sync(Enum):
+    load = "load"
+    reactive = "reactive"
+    save = "save"
+
+
+class LayerSource5(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["grist_table"]
+    table: str = Field(..., description="Nom table Grist dans le doc courant.")
+    id_field: str = "id"
+    sync: Sync = Field(
+        "load",
+        description="load: one-shot fetch. reactive: subscribe onRecords. save: bidirectionnel.",
+    )
+
+
+class LayerSource6(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["wfs"]
+    url: AnyUrl
+    type_name: str = Field(..., description="WFS TypeName (ex: BATIMENT.BATIMENT).")
+
+
+class LayerSource7(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: Literal["boundary_admin"]
+    catalog_id: str = Field(
+        ...,
+        description="ID catalog IGN admin (arrondissements_marseille, communes, epci, ...).",
+    )
+    filter: dict[str, Any] | None = Field(
+        None, description="Filtre attributaire (ex: {insee_arm: '13204'})."
+    )
+
+
+class LayerSource8(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    type: str = Field(
+        ..., description="Extension source nommée par projet.", pattern="^x_[a-z_]+$"
+    )
+
+
+class LayerSource(
+    RootModel[
+        LayerSource1
+        | LayerSource2
+        | LayerSource3
+        | LayerSource4
+        | LayerSource5
+        | LayerSource6
+        | LayerSource7
+        | LayerSource8
+    ]
+):
+    root: LayerSource1 | LayerSource2 | LayerSource3 | LayerSource4 | LayerSource5 | LayerSource6 | LayerSource7 | LayerSource8 = Field(
+        ...,
+        description="Source de données. Discriminated union sur 'type'. Alignée MapLibre style spec (v8+).",
+    )
+
+
+class Extrusion(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    enabled: bool = Field(
+        False, description="Active fill-extrusion 2.5D (dérive dimension='2.5d')."
+    )
+    height_field: str | None = None
+    base_field: str | None = None
+    vertical_gradient: bool = True
+
+
+class Outline(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    enabled: bool = False
+    color: str = Field("#000091", pattern="^#[0-9a-fA-F]{6}$")
+    width: float = Field(1, ge=0.0)
+
+
+class HollowPoint(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    enabled: bool = False
+    stroke_color_from_field: str | None = None
+    radius: float = Field(7, ge=0.0)
+
+
+class Opacity1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Literal["static"]
+    value: float = Field(..., ge=0.0, le=1.0)
+
+
+class Opacity2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Literal["reactive"]
+    prop: str = Field(
+        ..., description="Event geo:bind prop (time, scenario, filter, ...)."
+    )
+    matched: float = Field(..., ge=0.0, le=1.0)
+    before: float = Field(..., ge=0.0, le=1.0)
+    after: float = Field(..., ge=0.0, le=1.0)
+    null_value: float | None = Field(None, ge=0.0, le=1.0)
+
+
+class Opacity(RootModel[Opacity1 | Opacity2]):
+    root: Opacity1 | Opacity2 = Field(
+        ..., description="Opacité statique ou réactive (bindée sur événement geo:bind)."
+    )
+
+
+class Label(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    enabled: bool = False
+    field: str | None = None
+
+
+class ColorClassification1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["single"]
+    value: str = Field(..., pattern="^#[0-9a-fA-F]{6}$")
+    default: str | None = Field(None, pattern="^#[0-9a-fA-F]{6}$")
+
+
+class Category(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    value: str | float | bool | None
+    color: str = Field(..., pattern="^#[0-9a-fA-F]{6}$")
+    count: int | None = Field(None, ge=0)
+
+
+class ColorClassification2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["categorized"]
+    field: str
+    categories: list[Category]
+    default: str = Field(..., pattern="^#[0-9a-fA-F]{6}$")
+
+
+class Method(Enum):
+    linear = "linear"
+    log = "log"
+    sqrt = "sqrt"
+    jenks = "jenks"
+    quantile = "quantile"
+    equal_interval = "equal_interval"
+    manual = "manual"
+
+
+class ColorClassification3(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    mode: Literal["graduated"]
+    field: str
+    method: Method = Field(
+        ...,
+        description="Méthode. INPUT agent : single/categorized/manual/linear. COMPUTED producteur : + jenks/quantile/equal_interval/log/sqrt (pré-calculés en 'manual').",
+    )
+    breaks: list[float] = Field(
+        ..., description="Bornes intérieures. N breaks = N+1 classes.", min_length=1
+    )
+    palette: str = Field(..., description="Nom palette (voir §4.3 CONTRACT-V0.3.1.md).")
+    default: str = Field(..., pattern="^#[0-9a-fA-F]{6}$")
+    field_compiled_expression: list[Any] | None = Field(
+        None,
+        alias="_compiled_expression",
+        description="MapLibre expression compilée. Source de vérité rendu. readOnly (généré producteur).",
+    )
+
+
+class ColorClassification4(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["expression"]
+    expr: list[Any] = Field(
+        ...,
+        description="MapLibre expression brute passthrough (non-portable renderers non-MapLibre).",
+    )
+    default: str | None = Field(None, pattern="^#[0-9a-fA-F]{6}$")
+
+
+class ColorClassification(
+    RootModel[
+        ColorClassification1
+        | ColorClassification2
+        | ColorClassification3
+        | ColorClassification4
+    ]
+):
+    root: ColorClassification1 | ColorClassification2 | ColorClassification3 | ColorClassification4 = Field(
+        ...,
+        description="Discriminated union sur 'mode'. Voir §4.4 CONTRACT-V0.3.1.md pour combinaisons valides.",
+    )
+
+
+class SizeClassification1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["single"]
+    value: float = Field(..., ge=0.0)
+
+
+class OutputRangeItem(RootModel[float]):
+    root: float = Field(..., ge=0.0)
+
+
+class Method1(Enum):
+    linear = "linear"
+    log = "log"
+    sqrt = "sqrt"
+
+
+class SizeClassification2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["graduated"]
+    field: str
+    output_range: list[OutputRangeItem] = Field(..., max_length=2, min_length=2)
+    method: Method1 = "linear"
+
+
+class SizeClassification(RootModel[SizeClassification1 | SizeClassification2]):
+    root: SizeClassification1 | SizeClassification2 = Field(
+        ...,
+        description="Discriminated union sur 'mode' pour size (cercles proportionnels, extrusion, ...).",
+    )
+
+
+class ModelClassification1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["single"]
+    value: str | None = Field(None, description="modelId ou null.")
+
+
+class Category1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    value: str | float | bool
+    model_id: str
+
+
+class ModelClassification2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["categorized"]
+    field: str
+    categories: list[Category1]
+    default_model_id: str | None
+
+
+class ModelClassification(RootModel[ModelClassification1 | ModelClassification2]):
+    root: ModelClassification1 | ModelClassification2 = Field(
+        ..., description="Discriminated union pour choix modèle 3D (Atlas)."
+    )
+
+
+class Kind1(Enum):
+    handlebars = "handlebars"
+    html = "html"
+
+
+class PopupTemplate(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Kind1
+    body: str = Field(..., max_length=4000)
+
+
+class Interactions(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    popup_template: PopupTemplate | None = None
+    tooltip_field: str | None = None
+    hover_attributes: list[str] | None = None
+    emits_events: bool = Field(
+        True,
+        description="Si true, émet geo:feature-click/hover canoniques. Noms d'événements fixés par la lib (voir §4.5).",
+    )
+    feature_state_selected_field: str | None = Field(
+        None,
+        description="Attribut identifiant pour setFeatureState('selected') MapLibre (bidirectionnel Grist bridge).",
+    )
+
+
+class Kind2(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Type sémantique du contenu (renderer neutre). Enum ouverte.",
+        pattern="^x_[a-z_]+$",
+        title="Extension custom layer nommée par projet.",
+    )
+
+
+class Adapter1(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Adapter registre ADAPTERS de la lib (chargé à la demande).",
+        pattern="^x_[a-z_]+$",
+    )
+
+
+class CustomLayer(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: str
+    kind: Literal["gltf_instances"] | Literal["custom_3d_layer"] | Kind2 = Field(
+        ..., description="Type sémantique du contenu (renderer neutre). Enum ouverte."
+    )
+    adapter: Literal["geo-3d-scene"] | Adapter1 = Field(
+        ..., description="Adapter registre ADAPTERS de la lib (chargé à la demande)."
+    )
+    source_layer_id: str | None = Field(
+        None,
+        description="Référence un layers[].id porteur des features instances (P0-K, évite instances[] inline).",
+    )
+    params: dict[str, Any] | None = Field(
+        None, description="Params spécifiques adapter (gltf_base_url, shadow_map, ...)."
+    )
+    extensions: dict[constr(pattern=r"^[a-z][a-z_0-9]*$"), dict[str, Any]] | None = None
+
+
+class Item(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    label: str
+    color: str | None = Field(None, pattern="^#[0-9a-fA-F]{6}$")
+    count: int | None = Field(None, ge=0)
+    size: float | None = Field(None, ge=0.0)
+    layer: str | None = None
+
+
+class LegendFormat(Enum):
+    chips = "chips"
+    gradient_bar = "gradient_bar"
+    proportional = "proportional"
+
+
+class OverlayPosition(Enum):
+    top_left = "top-left"
+    top_right = "top-right"
+    bottom_left = "bottom-left"
+    bottom_right = "bottom-right"
+    bottom = "bottom"
+    right = "right"
+    floating = "floating"
+
+
+class Bind(RootModel[str]):
+    root: str = Field(
+        ...,
+        description="Source de mise à jour du compteur. Enum ouverte.",
+        pattern="^x_[a-z_]+$",
+    )
+
+
+class Expr(RootModel[str]):
+    root: str = Field(..., description="Expression du compteur.", pattern="^x_[a-z_]+$")
+
+
+class Counter(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: str
+    bind: Literal["time"] | Literal["scenario"] | Literal["filter"] | Literal[
+        "selection"
+    ] | Bind = Field(
+        ..., description="Source de mise à jour du compteur. Enum ouverte."
+    )
+    expr: Literal["filtered_count"] | Literal["total"] | Literal[
+        "percentage"
+    ] | Expr = Field(..., description="Expression du compteur.")
+    template: str = Field(
+        ..., description="Template Handlebars avec vars {{count}}, {{total}}, {{pct}}."
+    )
+    position: OverlayPosition | None = "bottom-left"
+
+
+class Scalebar(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    position: OverlayPosition | None = "bottom-left"
+    unit: Unit = "metric"
+
+
+class NorthArrow(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    position: OverlayPosition | None = "bottom-left"
+
+
+class Zone1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    kind: Literal["manual"]
+    bbox: BBox | None = None
+    center: Coord | None = None
+    zoom: float | None = Field(None, ge=0.0, le=22.0)
+    pitch: float | None = Field(None, ge=0.0, le=85.0)
+    bearing: float | None = Field(None, ge=-180.0, le=180.0)
+    max_pitch: float = Field(60, ge=0.0, le=85.0)
+
+
+class Zone(RootModel[Zone1 | Zone2 | Zone3 | Zone4]):
+    root: Zone1 | Zone2 | Zone3 | Zone4 = Field(
+        ...,
+        description="Zone d'étude / vue caméra initiale. Discriminated union sur 'kind'.",
+    )
+
+
+class Classification(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    color: ColorClassification | None = None
+    size: SizeClassification | None = None
+    model: ModelClassification | None = None
+    label: Label | None = None
+
+
+class Legend1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["auto"]
+    from_layer: str = Field(..., description="layers[].id source de la classification.")
+    position: OverlayPosition | None = "bottom-left"
+    format: LegendFormat | None = "chips"
+    title: str | None = Field(None, max_length=200)
+
+
+class Legend2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    mode: Literal["manual"]
+    items: list[Item]
+    position: OverlayPosition | None = "bottom-left"
+    format: LegendFormat | None = "chips"
+    title: str | None = Field(None, max_length=200)
+
+
+class Legend(RootModel[Legend1 | Legend2]):
+    root: Legend1 | Legend2 = Field(
+        ..., description="Légende. Discriminated union sur 'mode'."
+    )
+
+
+class LayerStyle(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    visible: bool = True
+    z_index: int | None = Field(
+        None,
+        description="Ordre d'affichage (plus élevé = au-dessus). null = ordre du tableau.",
+    )
+    opacity: Opacity | None = None
+    classification: Classification | None = None
+    extrusion: Extrusion | None = None
+    outline: Outline | None = Field(
+        None,
+        description="Ajoute automatiquement un layer 'line' sur la même source (absorbe workaround Livrables).",
+    )
+    hollow_point: HollowPoint | None = Field(
+        None,
+        description="Point creux pour features approximatives (absorbe workaround Livrables addPoints).",
+    )
+    maplibre_paint_override: dict[str, Any] | None = Field(
+        None,
+        description="Passthrough MapLibre setPaintProperty pour props avancées non-couvertes par classification.",
+    )
+
+
+class Layer(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    id: str = Field(
+        ...,
+        description="Identifiant slug unique dans le manifest.",
+        pattern="^[a-z][a-z0-9_-]*$",
+    )
+    name: str = Field(..., description="Nom affiché en légende.", max_length=300)
+    role: Literal["primary"] | Literal["context"] | Literal["emprise"] | Literal[
+        "members"
+    ] | Literal["site"] | Role = Field(
+        ..., description="Rôle sémantique. Enum ouverte + fallback 'primary'."
+    )
+    geometry_type: GeometryType = Field(
+        ...,
+        description="Type géométrie MapLibre (guide l'auto-split polygon+point si Feature Collection mixte).",
+    )
+    source: LayerSource
+    n_features: int | None = Field(
+        None,
+        description="Nombre de features (pré-calculé — obligatoire si source.type ≠ geojson).",
+        ge=0,
+    )
+    bbox: BBox | None = None
+    attribute_stats: dict[
+        constr(pattern=r"^[a-zA-Z_][a-zA-Z0-9_]*$"), AttributeStats
+    ] | None = None
+    style: LayerStyle
+    interactions: Interactions | None = None
+    min_zoom: float | None = Field(None, ge=0.0, le=22.0)
+    max_zoom: float | None = Field(None, ge=0.0, le=22.0)
+    extensions: dict[constr(pattern=r"^[a-z][a-z_0-9]*$"), dict[str, Any]] | None = None
+
+
+class ScenemanifestV031(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    field_schema: AnyUrl | None = Field(
+        None,
+        alias="$schema",
+        description="Pointeur JSON Schema self-description (facultatif si absent).",
+    )
+    manifest_version: str = Field(
+        ...,
+        description="Version SemVer strict du contract. V0.3.x lit tout 0.3.y avec y ≤ x (compat descendante 2 versions mineures).",
+        pattern="^0\\.3\\.[0-9]+$",
+    )
+    scene_hash: str | None = Field(
+        None,
+        description="Hash SHA-256 canonique du manifest_body. Calculé UNIQUEMENT côté producteur (au snapshot dans scene_store/). Le consommateur ne recalcule jamais côté main thread. Helper computeSceneHashInWorker() disponible pour vérification offline.",
+        pattern="^sha256:[0-9a-f]{64}$",
+    )
+    manifest_id: UUID | None = Field(
+        None, description="UUID4 unique du manifest. Généré au publish."
+    )
+    produced_at: AwareDatetime = Field(
+        ..., description="Timestamp ISO 8601 avec TZ. Généré au publish."
+    )
+    title: str = Field(
+        ...,
+        description="Titre principal de la scène (affiché en header carto).",
+        max_length=300,
+    )
+    subtitle: str | None = Field(
+        None, description="Sous-titre optionnel.", max_length=300
+    )
+    description: str | None = Field(
+        None, description="Description longue (paragraphe intro).", max_length=2000
+    )
+    source_text: str | None = Field(
+        None,
+        description="Citation datée des sources de données (BD TOPO IGN 2024, ...).",
+        max_length=500,
+    )
+    caveat: str | None = Field(
+        None,
+        description="Disclaimer méthodologique (marge d'erreur, données pédagogiques, ...).",
+        max_length=2000,
+    )
+    provenance: Provenance
+    projection: Literal["mercator"] | Literal["globe"] | Literal[
+        "lambert93"
+    ] | Projection = Field(
+        "mercator",
+        description="Projection cartographique. 'mercator' (défaut), 'globe' (MapLibre v5+), 'lambert93' (via adapter proj-lambert93). Enum ouverte : accepte x_<projet>_* avec fallback graceful 'mercator'.",
+        validate_default=True,
+    )
+    basemap: Basemap
+    basemap_switcher: list[str] | None = Field(
+        None,
+        description="IDs de basemaps proposés en toggle runtime UI (opt.). Défaut : uniquement basemap.id actuel.",
+    )
+    zone: Zone
+    camera_presets: list[CameraPreset] | None = Field(
+        None,
+        description="Presets caméra nommés (top, 3d, street, ...). Utilisés par API impérative flyToPreset().",
+    )
+    terrain: Terrain | None = None
+    sky: Sky | None = None
+    layers: list[Layer] = Field(
+        ...,
+        description="Couches cartographiques. Ordre = ordre de rendu (z_index respecté si défini).",
+    )
+    custom_layers: list[CustomLayer] | None = Field(
+        None,
+        description="Couches custom Three.js. Trigger dimension='3d' auto (lib dérivée). Chargé uniquement si <geo-3d-scene> composition slot présent.",
+    )
+    legend: Legend | None = None
+    scalebar: Scalebar | None = None
+    north_arrow: NorthArrow | None = None
+    counters: list[Counter] | None = Field(
+        None, description="Compteurs live bindés (nb features filtrés, %, ...)."
+    )
+    extensions: dict[
+        constr(pattern=r"^[a-z][a-z_0-9]*$"), dict[str, Any]
+    ] | None = Field(
+        None,
+        description="Extensions par-projet indexees par prefix (x_livrables, x_atlas, x_sig, x_zebra, ...). Contenu libre (additionalProperties: true).",
+    )