/**
 * #370 — Où proposer le sélecteur de mode d'affichage (absolu / proportionnel / échelle
 * adaptée) ?
 *
 * Le mode est porté par CHAQUE DIMENSION (`Class_DataTagGroup.position_mode`) : il dit
 * comment le diagramme doit réagir quand on fait défiler cette dimension-là — échelle
 * adaptée pour des unités, proportionnel pour des années. Il n'y a donc plus de réglage
 * global du diagramme, et la règle d'affichage devient uniforme : **un bouton à côté de
 * chaque dimension, quel que soit son hôte** — ligne du panneau Filtres, sélecteur de la
 * barre du haut, ou frise de séquence.
 *
 * Cette règle REMPLACE celle du #367, qui posait un bouton unique en en-tête de la
 * section « Flux et dimensions » (le mode y était encore un réglage global) et excluait
 * les bannières `sequence` / `topbar` / `none`. Une dimension en Séquence n'avait alors
 * aucun sélecteur nulle part : c'est le constat qui a ouvert ce ticket.
 *
 * Extrait de l'interface pour être testable sans rendu.
 *
 * os#1366 — Ce module a QUITTÉ le paquet éditeur (`opensankey-editor/components/topmenus`)
 * pour la zone viewer d'OpenSankey : le mode d'affichage n'est pas un outil d'édition mais
 * une façon de LIRE la donnée quand la sélection change. Les deux couches consomment
 * désormais la même règle — une copie dans le viewer aurait divergé de celle de l'éditeur.
 */
import type { Class_ApplicationData } from '../../types/ApplicationData';
import type { Class_DataTagGroup } from '../../types/TagGroup';
import type { Type_PositionMode } from '../../types/PublishOptions';
/** Sections du tiroir de filtres (miroir de `TagFilterMode` dans Toolbar.tsx). */
export type Type_TagFilterMode = 'element' | 'level' | 'data' | 'flux';
/** Ce que la décision a besoin de savoir d'un groupe de tags. */
export type Type_PositionModeCandidate = {
    id: string;
    banner: string;
    tags_dict?: object | null;
};
/**
 * Vrai si CE groupe doit porter le sélecteur de mode d'affichage.
 *
 * @param tagg groupe de tags rendu par l'hôte
 * @param is_data_group vrai si le groupe est une DIMENSION (et non une étiquette) — les
 * sections « Étiquettes de nœuds » et « Niveaux » rendent des groupes qui ne
 * pilotent aucune donnée : le mode n'y a pas de sens.
 * @param enabled gate d'affichage (cf. `positionModeSelectorEnabled`)
 */
export declare const shouldShowDimensionPositionMode: (tagg: Type_PositionModeCandidate, is_data_group: (tagg: Type_PositionModeCandidate) => boolean, enabled: boolean) => boolean;
/**
 * os#1366 — Ce que « déclarer une référence » veut dire, lu sur la zone de dessin.
 *
 * Typé STRUCTURELLEMENT (et non par `Class_DrawingArea`) : la décision reste une fonction
 * pure, testable sans monter un diagramme ni un rendu.
 */
export type Type_PositionReferenceDeclaration = {
    /** `prop_reference_datatag` du fichier (cf. NodePositioningReference). */
    prop_reference_datatag_ids?: string[] | null;
    /** `scale_reference_by_viewtag` du fichier (cf. DrawingArea). */
    scale_reference_by_viewtag?: {
        [view_tag_id: string]: unknown;
    } | null;
};
/**
 * os#1366 — Vrai si le diagramme est CONFIGURÉ pour les modes proportionnel / échelle
 * adaptée : il désigne un élément de référence au datatag (`prop_reference_datatag`) ou un
 * flux de référence d'épaisseur par view tag (`scale_reference_by_viewtag`).
 *
 * C'est la seule chose qui distingue un sélecteur utile d'un piège : sur un diagramme sans
 * référence, les trois modes ne se distinguent pas à la lecture.
 */
export declare const diagramDeclaresPositionReference: (declaration: Type_PositionReferenceDeclaration) => boolean;
/** Ce que le gate a besoin de savoir des options de publication. */
export type Type_PositionModePublishGate = {
    /** Option historique #370 : expose le sélecteur sur TOUTES les dimensions en publish. */
    toolbar: boolean;
    /** os#1366 : autorise l'apparition automatique quand une référence est déclarée. */
    position_mode_selector: boolean;
};
/**
 * os#1366 — Gate unique des trois hôtes du sélecteur (ligne du panneau Filtres, sélecteur
 * de la barre du haut, frise de séquence), en ÉDITION comme en LECTURE.
 *
 * - Éditeur : inchangé, toujours proposé (l'auteur règle le mode de chaque dimension).
 * - Publication : `toolbar` reste l'opt-in EXPLICITE de l'auteur (toutes les dimensions,
 *   référence ou non) — les pages déjà publiées avec cette option gardent donc exactement
 *   leur barre. À défaut, le sélecteur apparaît de lui-même si le diagramme DÉCLARE une
 *   référence, et l'auteur peut couper cet automatisme par `position_mode_selector: false`.
 *
 * Un diagramme publié sans référence n'affiche rien : un sélecteur inerte serait un piège.
 */
export declare const positionModeSelectorEnabled: (is_static: boolean, publish: Type_PositionModePublishGate, declaration: Type_PositionReferenceDeclaration) => boolean;
/** Ce que le gate a besoin de savoir de l'application (typage structurel, cf. ci-dessus). */
export type Type_PositionModeHostApp = {
    is_static: boolean;
    publish_options: Type_PositionModePublishGate;
    drawing_area: {
        scale_reference_by_viewtag: {
            [view_tag_id: string]: unknown;
        };
        nodePositioning: {
            proportionalReferenceDatatagIds: string[] | undefined;
        };
    };
};
/**
 * os#1366 — Même décision, lue directement sur l'application : les trois hôtes appelaient
 * chacun `!is_static || publish_options.toolbar`, une règle recopiée trois fois qui ne
 * pouvait qu'évoluer de travers.
 */
export declare const positionModeSelectorEnabledFor: (app: Type_PositionModeHostApp) => boolean;
/**
 * #370 — Choisit le mode d'affichage (absolu / proportionnel / échelle adaptée) D'UNE
 * DIMENSION, et l'applique aussitôt au dessin pour que le choix se voie.
 *
 * Le mode dit comment le diagramme doit réagir au défilement de CETTE dimension : il vit
 * donc sur elle (`Class_DataTagGroup.position_mode`) et non plus sur le diagramme. Le moteur
 * de dessin, lui, n'a qu'un mode courant : c'est la dimension que l'on manipule qui le lui
 * impose (cf. `applyPositionModeToDrawing`). `force` : ce clic est un choix explicite, il
 * l'emporte donc même sur un mode hérité `parametric`.
 *
 * os#1366 — Côté LECTEUR le geste ne persiste RIEN : il pose le mode en mémoire et redessine.
 * Aucun marqueur d'enregistrement (`ref_to_save_in_cache_indicator`) n'est levé, et une page
 * publiée n'a de toute façon aucun chemin d'écriture vers le fichier servi.
 *
 * Vit ici, et non dans `PositionModeMenu.tsx`, pour rester TESTABLE : aucune suite jest du
 * dépôt ne peut charger `@chakra-ui/react`. Le composant n'importe donc que ce geste-ci.
 * Les classes ne sont prises qu'en `import type` — ce module reste une feuille sans arête
 * runtime.
 */
/**
 * os#1383 — DÉSIGNE (ou libère) le datatag de RÉFÉRENCE du mode « échelle adaptée », pour la
 * dimension `tagg`.
 *
 * Ce que le réglage veut dire : « une espèce + un mode = une échelle, quel que soit le chemin ».
 * Sans référence désignée, la grandeur de référence est CAPTURÉE au vol — celle qui se trouvait à
 * l'écran quand le mode a pris effet. Personne ne l'a choisie, et elle dépend donc de l'ordre des
 * clics. Ici elle est ÉNONCÉE, et `NodePositioningScaleAdapted.referenceDataTagMagnitude` la
 * recalcule à chaque dessin : le chemin cesse de compter.
 *
 * UN SEUL datatag de référence pour le document : celui du couple élément/datatag,
 * `prop_reference_datatag` (`NodePositioning.proportionalReferenceDatatagIds`), persisté depuis
 * #1231 et déjà lu par le régime `element` — CARTOFOB le porte (84). Le geste écrit celui-là ;
 * la désignation propre au mode adapté d'os#1372 (`scale_adapted_reference_datatag`) reste un
 * simple alias de repli, jamais posé par l'interface.
 *
 * `tag_id` `undefined` = retour à la sélection courante (aucune référence pour cette dimension).
 * La référence nomme AU PLUS UN tag par dimension : on retire donc d'abord ceux de `tagg`, les
 * autres dimensions gardant la leur.
 *
 * Comme `applyPositionMode`, ce geste ne persiste rien de lui-même : il pose la valeur en mémoire
 * et redessine. En édition, l'enregistrement suit le rythme habituel du document.
 */
export declare const setScaleAdaptedReferenceDataTag: (app_data: Class_ApplicationData, tagg: Class_DataTagGroup, tag_id: string | undefined) => void;
/** os#1383 — Tag de `tagg` actuellement désigné comme référence, `undefined` si aucun. */
export declare const scaleAdaptedReferenceDataTagOf: (app_data: Class_ApplicationData, tagg: Class_DataTagGroup) => string | undefined;
export declare const applyPositionMode: (app_data: Class_ApplicationData, tagg: Class_DataTagGroup, m: Type_PositionMode) => void;