# Spécifications — Interface Bootstrap OntoWave
**Langue** : Français (référence) — [English version](interface.en.md)
**Statut** : Document vivant — toute implémentation doit y être conforme
---
## 1. Principe fondateur
> **La page HTML est quasi-vide. La librairie crée tout le DOM.**
Une page OntoWave correcte contient uniquement :
```html
Mon site
```
La librairie détecte automatiquement la configuration, crée l'interface et charge le contenu. **L'utilisateur n'a rien à définir en HTML.**
---
## 2. Injection de la configuration
OntoWave **ne requête jamais de fichier de configuration externe**. La configuration doit être injectée par la page hôte avant le chargement de la librairie. Deux API sont disponibles.
### Option A — `window.ontoWaveConfig` (recommandée)
L'API la plus simple : déclarer l'objet de configuration directement dans la page.
```html
```
La librairie lit `window.ontoWaveConfig` et le convertit automatiquement en entrée de `window.__ONTOWAVE_BUNDLE__['/config.json']`.
### Option B — `window.__ONTOWAVE_BUNDLE__` (API bas niveau)
Pour les pages qui doivent injecter plusieurs fichiers en une seule opération (config, nav, sitemap, search-index) — utilisé notamment par les pages de démo.
```html
```
### Comportement sans configuration
Si aucune API n'est définie, OntoWave démarre en **mode unilingue minimal** :
- Config par défaut : `{ roots: [{ base: '/', root: '/' }] }`
- Charge la page d'accueil : `#/index.md`
- Aucune requête réseau pour trouver une configuration
---
## 3. Bootstrap automatique
Au chargement, la librairie applique l'algorithme suivant :
```
1. Lire la configuration (window.ontoWaveConfig ou window.__ONTOWAVE_BUNDLE__)
2. Si document.getElementById('app') existe → STOP TOTAL (mode custom)
→ Aucun DOM créé, aucun style injecté, aucun menu flottant
3. Sinon → créer le DOM complet :
a. Injecter