passerelle-geo-components 0.2.0-alpha.1

package/schemas/scene_manifest.zod.ts

@@ -0,0 +1,66 @@
+import { z } from "zod"
+
+export const SceneManifestSchema = z.object({ "$schema": z.string().url().describe("Pointeur JSON Schema self-description (facultatif si absent).").optional(), "manifest_version": z.string().regex(new RegExp("^0\\.3\\.[0-9]+$")).describe("Version SemVer strict du contract. V0.3.x lit tout 0.3.y avec y ≤ x (compat descendante 2 versions mineures).").readonly(), "scene_hash": z.string().regex(new RegExp("^sha256:[0-9a-f]{64}$")).describe("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.").readonly().optional(), "manifest_id": z.string().uuid().describe("UUID4 unique du manifest. Généré au publish.").readonly().optional(), "produced_at": z.string().datetime({ offset: true }).describe("Timestamp ISO 8601 avec TZ. Généré au publish.").readonly(), "title": z.string().max(300).describe("Titre principal de la scène (affiché en header carto)."), "subtitle": z.string().max(300).describe("Sous-titre optionnel.").optional(), "description": z.string().max(2000).describe("Description longue (paragraphe intro).").optional(), "source_text": z.string().max(500).describe("Citation datée des sources de données (BD TOPO IGN 2024, ...).").optional(), "caveat": z.string().max(2000).describe("Disclaimer méthodologique (marge d'erreur, données pédagogiques, ...).").optional(), "provenance": z.any(), "projection": z.any().superRefine((x, ctx) => {
+    const schemas = [z.literal("mercator"), z.literal("globe"), z.literal("lambert93"), z.string().regex(new RegExp("^x_[a-z_]+$"))];
+    const { errors, failed } = schemas.reduce<{
+      errors: z.core.$ZodIssue[];
+      failed: number;
+    }>(
+      ({ errors, failed }, schema) =>
+        ((result) =>
+          result.error
+            ? {
+                errors: [...errors, ...result.error.issues],
+                failed: failed + 1,
+              }
+            : { errors, failed })(
+          schema.safeParse(x),
+        ),
+      { errors: [], failed: 0 },
+    );
+    const passed = schemas.length - failed;
+    if (passed !== 1) {
+      ctx.addIssue(errors.length ? {
+        path: [],
+        code: "invalid_union",
+        errors: [errors],
+        message: "Invalid input: Should pass single schema. Passed " + passed,
+      } : {
+        path: [],
+        code: "custom",
+        errors: [errors],
+        message: "Invalid input: Should pass single schema. Passed " + passed,
+      });
+    }
+  }).describe("Projection cartographique. 'mercator' (défaut), 'globe' (MapLibre v5+), 'lambert93' (via adapter proj-lambert93). Enum ouverte : accepte x_<projet>_* avec fallback graceful 'mercator'.").default("mercator"), "basemap": z.any(), "basemap_switcher": z.array(z.string()).describe("IDs de basemaps proposés en toggle runtime UI (opt.). Défaut : uniquement basemap.id actuel.").optional(), "zone": z.any(), "camera_presets": z.array(z.any()).describe("Presets caméra nommés (top, 3d, street, ...). Utilisés par API impérative flyToPreset().").optional(), "terrain": z.any().optional(), "sky": z.any().optional(), "layers": z.array(z.any()).describe("Couches cartographiques. Ordre = ordre de rendu (z_index respecté si défini)."), "custom_layers": z.array(z.any()).describe("Couches custom Three.js. Trigger dimension='3d' auto (lib dérivée). Chargé uniquement si <geo-3d-scene> composition slot présent.").optional(), "legend": z.any().optional(), "scalebar": z.object({ "position": z.any().optional(), "unit": z.enum(["metric","imperial","nautical"]).default("metric") }).strict().optional(), "north_arrow": z.object({ "position": z.any().optional() }).strict().optional(), "counters": z.array(z.any()).describe("Compteurs live bindés (nb features filtrés, %, ...).").optional(), "extensions": z.record(z.string(), z.union([z.record(z.string(), z.any()), z.never()])).superRefine((value, ctx) => {
+for (const key in value) {
+let evaluated = false
+if (key.match(new RegExp("^[a-z][a-z_0-9]*$"))) {
+evaluated = true
+const result = z.record(z.string(), z.any()).safeParse(value[key])
+if (!result.success) {
+ctx.addIssue({
+          path: [key],
+          code: 'custom',
+          message: `Invalid input: Key matching regex /${key}/ must match schema`,
+          params: {
+            issues: result.error.issues
+          }
+        })
+}
+}
+if (!evaluated) {
+const result = z.never().safeParse(value[key])
+if (!result.success) {
+ctx.addIssue({
+          path: [key],
+          code: 'custom',
+          message: `Invalid input: must match catchall schema`,
+          params: {
+            issues: result.error.issues
+          }
+        })
+}
+}
+}
+}).describe("Extensions par-projet indexees par prefix (x_livrables, x_atlas, x_sig, x_zebra, ...). Contenu libre (additionalProperties: true).").optional() }).strict().describe("Contract unifie passerelle-geo-components pivot cross-projet (workspace SIG + editeur livrables + widget carto). Voir CONTRACT-V0.3.1.md pour la spec humaine complete.")