@pasquelin/map3d-plugin-geopf 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +52 -6
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -16,25 +16,71 @@ import { geopfBatiments } from '@pasquelin/map3d-plugin-geopf'
16
16
  <Map plugins={[geopfBatiments()]} />
17
17
  ```
18
18
 
19
+ **Compatibilité** : `@pasquelin/map3d` `>=0.2.0 <0.8.0` (peerDependency — de 0.2 à 0.7),
20
+ `react` / `react-dom` 19, `three` ≥ 0.169.
21
+
19
22
  Le plugin est **désactivé par défaut** (`enabledByDefault: false`) : l'utilisateur l'active depuis
20
23
  le hub des plugins (menu Réglages). Une fois actif, il s'active sur l'outil « sélectionner un
21
24
  bâtiment » (pick de bâtiment 3D) déjà fourni par map3D.
22
25
 
26
+ Cet outil n'existe que lorsque la carte montre le **volume interne** de map3D : mode `'3d'` et
27
+ `providers.tiles3d.provider: 'internal'` (le défaut), bâtiments extrudés servis par l'origine
28
+ interne. Sur une carte plate ou sur des tuiles 3D photoréalistes — un maillage fusionné, sans
29
+ bâtiment distinct — il n'y a rien à désigner, donc rien à enrichir.
30
+
23
31
  Pour lire l'enrichissement dans l'hôte, monter un composant enfant de `<Map>` (le hook exige le
24
32
  contexte carte) :
25
33
 
26
34
  ```tsx
35
+ import type { CSSProperties } from 'react'
27
36
  import { useBuildingEnrichment } from '@pasquelin/map3d'
28
37
 
38
+ const panel: CSSProperties = {
39
+ position: 'absolute',
40
+ top: 16,
41
+ left: 16,
42
+ right: 16,
43
+ width: 'fit-content',
44
+ margin: '0 auto',
45
+ zIndex: 'var(--m3d-z-floating-hud)',
46
+ padding: '10px 14px',
47
+ border: '1px solid var(--m3d-border)',
48
+ borderRadius: 'var(--m3d-radius-lg)',
49
+ background: 'var(--m3d-panel)',
50
+ fontSize: 'var(--m3d-size-sm)',
51
+ lineHeight: 1.5,
52
+ }
53
+
29
54
  function BuildingInfo() {
30
55
  const e = useBuildingEnrichment()
31
- if (e.loading) return <div>Chargement…</div>
32
- if (e.error) return <div>Indisponible : {e.error.message}</div>
56
+ if (e.loading) return <div style={panel}>Chargement…</div>
57
+ if (e.error) return <div style={panel}>Indisponible : {e.error.message}</div>
33
58
  if (!e.data) return null
34
- return <div>{Object.entries(e.data).map(([k, v]) => <div key={k}>{k} : {String(v)}</div>)}</div>
59
+ const attrs = Object.entries(e.data)
60
+ if (attrs.length === 0) return <div style={panel}>Aucun attribut IGN pour ce bâtiment</div>
61
+ return (
62
+ <div style={panel}>
63
+ {attrs.map(([k, v]) => (
64
+ <div key={k}>
65
+ <b>{k}</b> : {String(v)}
66
+ </div>
67
+ ))}
68
+ </div>
69
+ )
35
70
  }
36
71
  ```
37
72
 
73
+ L'exemple du dépôt
74
+ ([`example/src/App.tsx`](https://github.com/pasquelin/plugingsMap3D/blob/main/packages/geopf/example/src/App.tsx))
75
+ monte ce même composant. Le canvas de la carte est en position absolue : un enfant de `<Map>`
76
+ laissé dans le flux reste dessous, invisible. D'où la position et le niveau « HUD flottant » de la
77
+ carte (`--m3d-z-floating-hud`, qui suit `style.zIndex.floatingHud`) : au-dessus d'elle, sous ses
78
+ barres. Fond, bordure et arrondi viennent du thème de la carte ; la couleur du texte et la police
79
+ en sont héritées. Le panneau est ici centré en haut : placez-le où votre interface laisse de la
80
+ place (avec `<Map search>`, le champ de recherche occupe le coin haut-gauche sur 320 px et passe
81
+ au-dessus). `e.data` vaut `{}` quand le plugin n'a aucun attribut à remonter : le plus souvent,
82
+ aucun bâtiment BDTOPO dans la zone de recherche (`searchRadius`) autour du point cliqué.
83
+
38
84
  ## Configuration (`geopfConfig`)
39
85
 
40
86
  | Clé | Type | Défaut | Refetch | Description |
@@ -60,6 +106,6 @@ function BuildingInfo() {
60
106
  pnpm --filter @pasquelin/map3d-plugin-geopf-example dev
61
107
  ```
62
108
 
63
- Nécessite `VITE_CESIUM_ION_TOKEN` (fichier `.env` du package `example/`) pour de vrais bâtiments 3D ;
64
- sans token l'exemple retombe sur le globe ellipsoïde de repli (le pick de bâtiment ne peut alors
65
- rien enrichir).
109
+ Aucune clé n'est nécessaire. L'exemple tourne sur les sources par défaut de map3D : le fond de
110
+ carte et les bâtiments extrudés viennent de son origine interne (`providers.internal.origin`). Il
111
+ démarre en 3D (`mapMode="3d"`), là où l'outil de sélection de bâtiment existe.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pasquelin/map3d-plugin-geopf",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Plugin map3D — enrichit les bâtiments 3D au clic avec les attributs BDTOPO de la Géoplateforme IGN (WFS), via useBuildingEnrichment().",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -37,7 +37,7 @@
37
37
  "typecheck": "tsc --noEmit"
38
38
  },
39
39
  "peerDependencies": {
40
- "@pasquelin/map3d": "^0.2.0",
40
+ "@pasquelin/map3d": ">=0.2.0 <0.8.0",
41
41
  "react": "^19.0.0",
42
42
  "react-dom": "^19.0.0",
43
43
  "three": ">=0.169.0"