export type Type_PositionMode = 'absolute' | 'proportional' | 'scale_adapted';
import type { Type_ScaleAdaptedReference } from './DrawingArea';
/**
 * sa#398 — Une entrée de `diagrams_list` : la CHAÎNE historique (nom de fichier servi en
 * `<valeur>.gz`, ou nom de variable posée sur window.sankey par un script de données), OU un
 * objet portant sa PROPRE sélection de vues. `view` / `view_label` ont exactement les
 * sémantiques des options de page sa#397 (ouvrir une vue / restreindre le sélecteur aux vues
 * portant ce LABEL DE VUE — cf. sa#396, rien à voir avec les view tags générateurs), mais
 * appliquées au moment où CE diagramme est affiché. Rétro-compatible : la chaîne reste
 * valide ; un objet sans `file` est ignoré (warn).
 */
export type Type_DiagramsListEntry = string | {
    file: string;
    view?: string;
    view_label?: string;
};
/** sa#398 — Sélection de vues effective d'une entrée de `diagrams_list` (entrée ?? page). */
export type Type_DiagramViewOptions = {
    view: string | null;
    view_label: string | null;
};
/**
 * sa#398 — Le fichier/nom de variable d'une entrée de `diagrams_list`, quelle que soit sa
 * forme (chaîne historique ou objet `{file, ...}`). null si l'entrée est invalide.
 */
export declare const diagramsListEntryFile: (entry: unknown) => string | null;
export interface SankeyGlobals {
    publish?: boolean;
    editable?: boolean;
    topbar?: boolean;
    footer?: boolean;
    toolbar?: boolean;
    position_mode_selector?: boolean;
    fit_toolbar?: boolean;
    fullscreen?: boolean;
    filter_bar?: boolean;
    embedded?: boolean;
    recenter?: boolean;
    edit_button?: boolean;
    unitary?: boolean;
    doc?: boolean;
    doc_file?: string;
    navigation_help?: boolean;
    badge?: boolean;
    app_info?: boolean;
    sidebar_toggle?: boolean;
    language?: string;
    logo?: string;
    header?: string;
    header_i18n?: Record<string, string>;
    diagram?: string | Record<string, unknown>;
    diagram_layout?: string;
    diagram_layout_options?: string[];
    diagrams_list?: Record<string, Type_DiagramsListEntry>;
    /** @deprecated utiliser `diagrams_list` */
    sous_filieres?: Record<string, string>;
    /**
     * @deprecated Désignation HISTORIQUE du diagramme courant : ces pages chargent
     * leurs données par `<script src="X.json">` (le fichier est une affectation
     * `window.sankey['X'] = {…}`) et désignent l'affiché par une RÉFÉRENCE —
     * `window.sankey.filiere = window.sankey['X']`. Utiliser `diagram`.
     */
    filiere?: Record<string, unknown>;
    data_type?: boolean;
    data_type_intervals?: boolean;
    value_filter?: boolean;
    view_filter?: boolean;
    level_filter?: boolean;
    node_filter?: boolean;
    data_filter?: boolean;
    lock_zoom?: boolean;
    zoom_control?: boolean;
    tooltip_on_hover?: boolean;
    minimum_flux?: number;
    position_mode?: Type_PositionMode;
    scale_adapted_reference?: Type_ScaleAdaptedReference;
    data_tag_selection?: Record<string, string>;
    view_tag_selection?: Record<string, string>;
    view?: string;
    view_label?: string | string[];
    export_json?: boolean;
    [key: string]: unknown;
}
export interface PublishOptions {
    publish: boolean;
    editable: boolean;
    topbar: boolean;
    footer: boolean;
    toolbar: boolean;
    position_mode_selector: boolean;
    fit_toolbar: boolean;
    fullscreen: boolean;
    filter_bar: boolean;
    embedded: boolean;
    recenter: boolean;
    edit_button: boolean;
    unitary: boolean;
    doc: boolean;
    doc_file: string | null;
    navigation_help: boolean;
    badge: boolean;
    app_info: boolean;
    sidebar_toggle: boolean;
    data_type: boolean;
    data_type_intervals: boolean;
    value_filter: boolean;
    view_filter: boolean;
    level_filter: boolean;
    node_filter: boolean;
    data_filter: boolean;
    lock_zoom: boolean;
    zoom_control: boolean;
    tooltip_on_hover: boolean;
    language: string | null;
    minimum_flux: number | null;
    position_mode: Type_PositionMode | null;
    scale_adapted_reference: Type_ScaleAdaptedReference | null;
    data_tag_selection: Record<string, string> | null;
    view_tag_selection: Record<string, string> | null;
    view: string | null;
    view_label: string | null;
    view_labels: string[] | null;
    export_json: boolean;
    logo: string | null;
    header: string | null;
    diagram: string | Record<string, unknown> | null;
    diagram_layout: string | null;
    diagram_layout_options: string[] | null;
    diagrams_list: Record<string, string> | null;
    diagrams_views: Record<string, Type_DiagramViewOptions> | null;
}
declare global {
    interface Window {
        sankey?: SankeyGlobals;
    }
}
/**
 * #370 — Garde de type des trois modes proposés par le sélecteur. Exporté depuis que le
 * mode est porté par chaque dimension (`Class_DataTagGroup.position_mode`) et relu d'un
 * fichier : une valeur inconnue, ou l'ancien mode hérité `parametric`, doit être rejetée
 * plutôt que castée à l'aveugle.
 */
export declare const isPositionMode: (v: unknown) => v is Type_PositionMode;
export declare const getPublishOptions: () => PublishOptions;
export type ViewerSankeyOptions = {
    editable?: boolean;
    topbar?: boolean;
    footer?: boolean;
    toolbar?: boolean;
    position_mode_selector?: boolean;
    fit_toolbar?: boolean;
    fullscreen?: boolean;
    filter_bar?: boolean;
    embedded?: boolean;
    recenter?: boolean;
    edit_button?: boolean;
    unitary?: boolean;
    doc?: boolean;
    navigation_help?: boolean;
    badge?: boolean;
    logo?: string;
    header?: string;
    diagram?: string | Record<string, unknown>;
    diagram_layout?: string;
    diagram_layout_options?: string[];
    diagrams_list?: Record<string, Type_DiagramsListEntry>;
    /** @deprecated utiliser `diagrams_list` */
    sous_filieres?: Record<string, string>;
    data_type?: boolean;
    data_type_intervals?: boolean;
    value_filter?: boolean;
    view_filter?: boolean;
    level_filter?: boolean;
    node_filter?: boolean;
    data_filter?: boolean;
    lock_zoom?: boolean;
    zoom_control?: boolean;
    tooltip_on_hover?: boolean;
    language?: string;
    header_i18n?: Record<string, string>;
    minimum_flux?: number;
    position_mode?: Type_PositionMode;
    scale_adapted_reference?: Type_ScaleAdaptedReference;
    data_tag_selection?: Record<string, string>;
    view_tag_selection?: Record<string, string>;
    view?: string;
    view_label?: string | string[];
    diagrams_config?: Record<string, Record<string, unknown>>;
};
/**
 * Merge des props Viewer dans window.sankey (force `publish: true`).
 * Props prioritaires : une clé fournie en prop écrase la valeur existante de window.sankey.
 */
export declare const applyViewerOptions: (options?: ViewerSankeyOptions) => void;
/**
 * Langue imposée par la page hôte : paramètre d'URL `?lang=` prioritaire,
 * sinon `window.sankey.language`. Retourne null si absente ou non supportée.
 * Utilisé par les index.tsx (OS/SA) AVANT la logique de langue mémorisée :
 * les pages publiées (portfolio multilingue) lient leurs diagrams.html avec
 * `?lang=<lang>` pour que le viewer s'ouvre dans la langue de la page.
 */
export declare const getForcedLanguage: (supported_langs: string[]) => string | null;
/**
 * Normalise un code de langue quelconque (navigateur, `?lang=`, cache localStorage)
 * vers un code effectivement supporté par l'appli. Les codes supportés sont
 * majoritairement sur 2 lettres ('fr', 'en', …) mais le chinois est régionalisé
 * ('zh-CN', simplifié) : un simple `slice(0, 2)` ne suffit donc plus.
 * Ordre de résolution : correspondance exacte → insensible à la casse →
 * première variante supportée de la même langue de base ('zh', 'zh-Hans',
 * 'zh-SG' → 'zh-CN'). Retourne null si rien ne correspond.
 */
export declare const normalizeLanguage: (raw: string | null | undefined, supported_langs: string[]) => string | null;