@micheeeeel/yinyangapp 3.0.1 → 3.1.0

package/dist/types/components/controller/action-stack/ActionStackController.d.ts

@@ -75,6 +75,8 @@ export declare class ActionStackController {
      * ActionStackState.addItem, sans muter la pile. null hors zone de dépôt.
      */
     getPriorIdsIfInsertedAtPreview(anchorItemId: string, insertedActionId: string): string[] | null;
+    /** Projection d'une insertion externe, sans mutation de la pile ni de l'historique. */
+    getItemsIfInsertedAtPreview(inserted: ActionStackItem): ActionStackItem[] | null;
     /** Fin du glisser (dépôt ou abandon). Les barres restent affichées ; un
      *  dépôt consomme le guide, un abandon le garde pour un nouvel essai. */
     endPrereqDragGuide(dropped: boolean): void;
@@ -100,6 +102,15 @@ export declare class ActionStackController {
      */
     private _hitboxEmphasisStyle;
     private _applyHitboxEmphasisStyles;
+    /** Couleur du libellé d'un item — éclairci pour l'item en focus. */
+    private _stackLabelFill;
+    /**
+     * Marques propres à l'item en focus, indépendantes du cadre : liseré plein
+     * à sa couleur sur le bord gauche (pendant du border-left du bloc
+     * .ff-block--focused dans le panneau) et libellé éclairci en gras. Elles
+     * restent visibles quand le survol lié prend la main sur le cadre.
+     */
+    private _applyFocusMarks;
     /**
      * Affiche temporairement le highlight combo (cercles de fenêtre) pendant ~1.8 s.
      * Sans effet si un highlight permanent est déjà actif.
@@ -142,7 +153,7 @@ export declare class ActionStackController {
      *  ActionStackState.addItemAtSlot. Même remise à zéro de l'aperçu de
      *  glisser qu'addItem, pour la même raison (rendu synchrone dans
      *  state.addItemAtSlot). */
-    addItemAtSlot(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, slotIndex: number): ActionStackItem;
+    addItemAtSlot(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, slotIndex: number): ActionStackItem | null;
     syncActiveAction(sourceChildKey: string | null, actionId: string | null): void;
     setExternalDragActive(active: boolean): void;
     clearDropPreview(): void;
@@ -195,5 +206,9 @@ export declare class ActionStackController {
     copyRangeToClipboard(): void;
     /** Pastes the clipboard at the top of the currently active stack. */
     pasteClipboard(): void;
+    /** Fin de vie : observer déconnecté, minuterie du flash et écouteur
+     *  clavier retirés. */
+    destroy(): void;
+    private keydownHandler;
     private ensureKeyboardListeners;
 }

package/dist/types/components/controller/action-stack/ActionStackDragHandler.d.ts

@@ -83,6 +83,10 @@ export declare class ActionStackDragHandler {
         compactLength: number;
     }): void;
     clearDropPreview(): void;
+    /** Zone de dépôt relue à l'instant : un glisser venu du diagramme ou de
+     *  RECHERCHE bascule en mode STACK, dont le panneau entre alors en glissant
+     *  depuis la gauche — la géométrie du dernier rendu serait périmée. */
+    private liveDropZone;
     updateDropPreview(clientX: number, clientY: number, _localY: number): boolean;
     isDropZoneHit(clientX: number, clientY: number): boolean;
     getInsertionPreviewIndex(): number | null;

package/dist/types/components/controller/action-stack/ActionStackManager.d.ts

@@ -41,7 +41,7 @@ type ActionStackManagerDeps = {
     prepareForComponentSwitch: (targetComponentId: string) => void;
     animateChildrenHide: () => void;
     recomputeIncomingForceFieldForItems: (items: ActionStackItem[], sourceComponentId: string, currentComponentId: string) => boolean;
-    buildProjectionActionsFromStackItems: (items: ActionStackItem[]) => SequentialActionProjectionInput[];
+    buildProjectionActionsFromStackItems: (items: ActionStackItem[], eventContextItems?: ActionStackItem[]) => SequentialActionProjectionInput[];
     buildForceFieldSourceIndicesFromStackItems: (items: ActionStackItem[]) => number[];
     clearProjectedActionState: (options?: {
         deselect?: boolean;
@@ -119,7 +119,18 @@ export declare class ActionStackManager {
      *  ODD, métadonnées de son cutting. Null si le satellite est inconnu. */
     private buildActionStackItem;
     activateActionFromChild(childController: IYinYangController, actionId?: string, label?: string, clearStack?: boolean): void;
-    applyProjectedGhostFromStackItems(items: ActionStackItem[]): void;
+    private panelsRefreshFrameId;
+    /** Rend, à la frame suivante, les panneaux dépendants de l'action active :
+     *  détails du ghost, deltas des satellites, puis le menu radial en dernier
+     *  (il rebranche ses closures de clic sur l'activeActionId posé par
+     *  l'activation, voir refreshChildActionMenu). Plusieurs activations dans la
+     *  même frame se fondent en un seul rendu. Si l'action n'est plus active à
+     *  l'échéance (désactivée, ou remplacée), le flux qui l'a remplacée a rendu
+     *  son propre état : rien à faire. */
+    /** Fin de vie : annule le rendu différé des panneaux. */
+    destroy(): void;
+    private schedulePanelsRefresh;
+    applyProjectedGhostFromStackItems(items: ActionStackItem[], eventContextItems?: ActionStackItem[]): void;
     onStackItemVisibilityToggle(activeItems: ActionStackItem[]): void;
     private updateProjectedGhostTensions;
     private applyEmptyGhostProjectionState;

package/dist/types/components/controller/action-stack/ActionStackState.d.ts

@@ -2,8 +2,7 @@ export type ActionStackItem = {
     id: string;
     /**
      * Nature de l'item — "action" (par défaut) pour une action satellite
-     * classique, "keyEvent" pour un Événement Clé joué depuis le cercle
-     * central d'une facette. Un keyEvent n'a pas de satellite cible (les
+     * classique, "keyEvent" pour un Événement Clé joué depuis le satellite-facette. Un keyEvent n'a pas de satellite cible (les
      * champs source* ci-dessous sont des sentinels dans ce cas) ni de delta
      * propre (effectiveDelta reste 0) — son seul effet est d'amplifier les
      * actions listées dans sa définition, si elles sont jouées après lui
@@ -31,6 +30,7 @@ export type ActionStackItem = {
     comboResults?: import("../../../data/combo-engine").ComboResult[];
     /** Index du slot occupé dans la pile (0 = en bas, croissant vers le haut). */
     slotIndex: number;
+    unrecognized?: boolean;
 };
 /** Champs persistants d'un item copié — sans id/validatedAt/slotIndex, qui sont
  *  réattribués à l'insertion (dans la même pile ou une autre, via un bookmark). */
@@ -61,6 +61,7 @@ export type ActionStackSnapshot = StackState & {
 export declare class ActionStackState {
     private readonly onActiveItemsChange;
     private readonly onClear?;
+    private readonly isKnownItem?;
     readonly ACTION_STACK_MAX_ITEMS = 30;
     readonly HISTORY_LIMIT = 120;
     readonly CONFIG_BOOKMARKS_MAX = 4;
@@ -76,7 +77,7 @@ export declare class ActionStackState {
     stackClipboard: StackClipboardEntry[] | null;
     configBookmarks: ConfigBookmark[];
     activeBookmarkIndex: number;
-    constructor(onActiveItemsChange: (activeItems: ActionStackItem[]) => void, onClear?: (() => void) | undefined);
+    constructor(onActiveItemsChange: (activeItems: ActionStackItem[]) => void, onClear?: (() => void) | undefined, isKnownItem?: ((item: ActionStackItem) => boolean) | undefined);
     canUndo(): boolean;
     canRedo(): boolean;
     getItemById(id: string): ActionStackItem | undefined;
@@ -106,7 +107,7 @@ export declare class ActionStackState {
      * @param compactLength  Current number of visible slots (from render context).
      *                       Null when called without a specific insertion index.
      */
-    addItem(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, insertAtVisibleIndex: number | null, compactLength: number | null): ActionStackItem;
+    addItem(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, insertAtVisibleIndex: number | null, compactLength: number | null): ActionStackItem | null;
     /**
      * Insère à un slot ABSOLU (0 = bas de pile), en décalant d'un cran tout
      * item situé à ce slot ou au-dessus — inconditionnellement, même si le
@@ -115,8 +116,10 @@ export declare class ActionStackState {
      * insertion. addItem, lui, n'a pas cette garantie (il ne décale qu'en
      * présence d'un occupant, et raisonne en index visible).
      */
-    addItemAtSlot(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, slotIndex: number): ActionStackItem;
+    addItemAtSlot(item: Omit<ActionStackItem, "id" | "validatedAt" | "slotIndex">, slotIndex: number): ActionStackItem | null;
     private pushItemAtSlot;
+    /** Unicité par carte sur toute la STAC, y compris les items décochés. */
+    private hasKeyEvent;
     removeItem(itemId: string): void;
     clearAll(): void;
     deselectAllItems(): void;

package/dist/types/components/controller/action-stack/StackFocusController.d.ts

@@ -45,9 +45,11 @@ export declare class StackFocusController {
     setStackItemEmphasisPreview(stackItemId: string | null): void;
     /**
      * Point d'accroche unique de la mise en valeur du satellite source de
-     * l'action portant l'emphase (aperçu ?? focus). Réutilise pour l'instant
-     * le glow de highlightOddByStackItemId (ou le segment de bordure si la
-     * source est dans une autre facette) — l'anneau animé viendra ici.
+     * l'action portant l'emphase (aperçu ?? focus) : pour l'action en focus,
+     * la même mise en lumière que le satellite sélectionné en RECHERCHE
+     * (anneaux de visée, pings, onde de scan) ; pour un simple aperçu au
+     * survol, le glow doux. Segment de bordure si la source est dans une
+     * autre facette.
      * `clearIfNone` : sans emphase, efface la mise en valeur (sorties de
      * survol, défocus) ; false pour les simples re-applications (satellites
      * recréés, fin d'un survol de satellite) afin de ne pas écraser d'autres
@@ -89,10 +91,9 @@ export declare class StackFocusController {
         sourceIndex: number;
     } | null;
     /**
-     * Point de départ « bulle » du champ de force de l'action en focus : la
-     * bulle de son action dans le menu radial si le satellite source est celui
-     * sélectionné, sinon la bulle détachée posée sur la source. null si
-     * aucune bulle n'est visible (le champ démarre alors au satellite).
+     * Point de départ « bulle » du champ de force de l'action en focus : sa
+     * bulle détachée, posée sur le satellite source. null si aucune bulle
+     * n'est visible (le champ démarre alors au satellite).
      */
     resolveFocusBubbleStub(): {
         sourceChildIndex: number;

package/dist/types/components/controller/action-stack/stackChromePalette.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Habillage ambre de la pile (mode STACK) — pendant SVG des variables
+ * --stack-* de layout.css. Ne couvre que le décor (bordures, en-tête,
+ * boutons, frise temporelle) : les couleurs porteuses d'état (configurations
+ * A/B/C/D, placeholder de dépôt, phases, items actifs) restent les leurs.
+ */
+export declare const STACK_CHROME: {
+    readonly line: "#3a2f1e";
+    readonly headerText: "#e8c07a";
+    readonly buttonStroke: "#6a5028";
+    readonly buttonIcon: "#e8c07a";
+    readonly ghostSlotDots: "rgba(130, 98, 48, 0.55)";
+    readonly ghostSlotNumber: "rgba(120, 90, 45, 0.50)";
+    readonly timelineBandFill: "rgba(232, 168, 64, 0.06)";
+    readonly timelineBandStroke: "rgba(232, 168, 64, 0.18)";
+    readonly timelineAxis: "rgba(232, 168, 64, 0.50)";
+    readonly timelineArrow: "rgba(232, 168, 64, 0.65)";
+    readonly timelineTickOccupied: "rgba(240, 195, 110, 0.75)";
+    readonly timelineTick: "rgba(232, 168, 64, 0.40)";
+};

package/dist/types/components/controller/actions/ActionProjectionService.d.ts

@@ -1,5 +1,7 @@
+import type { KeyEventPropagationContext } from "../../../data/key-event-propagation";
 import { YinYangInternalModel } from "../../../interfaces/IYinYangInternalModel";
 import { type PropagatedActionEdge, type PropagationTruncation } from "../../../utils/actionPropagation";
+import { type StabilityProtection, type ProtectedSign, type DirectionalShield } from "../../../data/stability-shield";
 import { ForceFieldLink } from "../force-field/types";
 export type ProjectedCuttingState = {
     cuttingId: number;
@@ -15,6 +17,7 @@ export type GhostProjectionResult = {
     projectedGhostCuttingStatesByOddId: Map<string, ProjectedCuttingState[]>;
 };
 export type SequentialActionProjectionInput = {
+    eventPropagation?: KeyEventPropagationContext;
     sourceOddId: string;
     sourceCuttingIndex: number;
     /** Bouclier de stabilité (points d'état) que cette action crée sur son
@@ -23,6 +26,7 @@ export type SequentialActionProjectionInput = {
      *  résolutions suivantes de la séquence, jamais consommé ; le plus fort
      *  remplace le précédent sur un même satellite. */
     shield?: number;
+    protectedSign?: ProtectedSign;
 };
 export type EmptyGhostProjectionState = {
     projectedGhostTensionByOddId: null;
@@ -45,6 +49,7 @@ export type ShieldAbsorption = {
     shield: number;
     aggregated: number;
     applied: number;
+    protectedSign?: ProtectedSign;
 };
 /**
  * Bouclier de stabilité sur UNE résolution : pour chaque satellite protégé,
@@ -53,11 +58,16 @@ export type ShieldAbsorption = {
  * total une seule fois — jamais chaque contribution séparément, jamais
  * au-delà de 0. Mute `projectedStates` et rend les réductions appliquées.
  */
-export declare function applyStabilityShieldsToResolution(startStates: Record<string, Record<number, number>>, projectedStates: Record<string, Record<number, number>>, activeShields: Map<string, Map<number, number>>): ShieldAbsorption[];
+export type SignedResolutionContributions = Record<string, Record<number, {
+    positive: number;
+    negative: number;
+}>>;
+export declare function applyStabilityShieldsToResolution(startStates: Record<string, Record<number, number>>, projectedStates: Record<string, Record<number, number>>, activeShields: Map<string, Map<number, StabilityProtection>>, contributions?: SignedResolutionContributions): ShieldAbsorption[];
 export type ActionSequenceStepInfo = {
     actionIndex: number;
     action: SequentialActionProjectionInput;
     effectiveDelta: number;
+    createdProtection?: DirectionalShield;
     /** Boucliers ayant réduit une contribution négative de cette étape — vide
      *  si aucun satellite protégé n'a été touché négativement. */
     shieldAbsorptions: ShieldAbsorption[];
@@ -97,6 +107,7 @@ export declare function projectGhostStateForComponent(params: {
     sourceOddId: string | undefined;
     sourceCuttingIndex: number;
     actionDelta: number;
+    eventPropagation?: KeyEventPropagationContext;
 }): GhostProjectionResult | null;
 /** Tension projetée de la facette : même règle que sa tension courante
  *  (`facetTensionFromOdds`, moyenne pondérée sur tous ses satellites), sur

package/dist/types/components/controller/actions/ChildActionMenuController.d.ts

@@ -3,16 +3,31 @@ import { IYinYangView } from "../../../interfaces/IYinYangView";
 import { type ActionDefinition } from "../../../data/yasuni_actions";
 import { ChildrenOrbitEntry } from "../utils/childrenOrbit";
 import { type Point } from "./radialItemMenu";
+/** Mise en scène d'une bulle détachée : "focus" = l'action regardée (style
+ *  ambre, faisceau pulsé) ; "plain" = pleine, style ordinaire (aucune action
+ *  en focus) ; "dimmed" = translucide (une autre action est en focus). */
+export type DetachedBubbleEmphasis = "focus" | "plain" | "dimmed";
+export type DetachedBubble = {
+    /** Identité stable de la bulle (id de l'item de pile, par exemple) : une
+     *  bulle qui ne change que d'emphase est restylée, pas rejouée. */
+    key: string;
+    /** Satellite source porteur de la bulle. */
+    sourceChildKey: string;
+    action: ActionDefinition;
+    /** Actions du menu RECHERCHE de la source dans le mode de l'action : la
+     *  bulle reprend sa place (son angle) dans cet éventail, pour apparaître
+     *  exactement où l'utilisateur l'a trouvée. */
+    menuActions: ActionDefinition[];
+    emphasis: DetachedBubbleEmphasis;
+};
 type DetachedBubbleContext = {
     orbitData: ChildrenOrbitEntry[];
-    /** Satellite source porteur de la bulle — null = aucune bulle détachée. */
-    sourceChildKey: string | null;
-    action: ActionDefinition | null;
+    /** Bulles à afficher — [] les replie toutes. */
+    bubbles: DetachedBubble[];
     childActionMenuItemDistance: number;
     childActionMenuItemScale: number;
     childActionIconFontScale: number;
-    /** Clic sur la bulle : typiquement, sélectionner le satellite source. */
-    onClick: (sourceChildKey: string, actionId: string) => void;
+    onClick: (bubble: DetachedBubble) => void;
 };
 type ChildActionMenuContext = {
     orbitData: ChildrenOrbitEntry[];
@@ -23,10 +38,10 @@ type ChildActionMenuContext = {
     childActionIconFontScale: number;
     /** Actions filtrées pour le cutting actif (depuis yasuniCause + actionMap). */
     actionsForActiveChild: ActionDefinition[];
-    /** Mode STACK : la seule bulle déployée est celle de l'item en focus, et
-     *  son clic vaut clic sur le libellé de cet item dans la pile (ni aperçu,
-     *  ni glisser). null hors STACK. */
-    onStackBubbleClick: (() => void) | null;
+    /** RECHERCHE multi-blocs : un panneau verrouillé fige l'action source.
+     *  Les autres bulles s'estompent, et tout clic passe par ce refus, qui
+     *  peut rejouer le clic (`retry`) une fois déverrouillé. null sinon. */
+    onBlockedActionClick: ((retry: () => void) => void) | null;
 };
 export declare class ChildActionMenuController {
     private readonly view;
@@ -34,6 +49,9 @@ export declare class ChildActionMenuController {
     private readonly refreshActionStackVisual;
     /** Aperçu — clic sur une action : affiche sa carte, ne joue rien. */
     private readonly activateActionFromChild;
+    /** Re-clic sur l'action déjà active : la désélectionne et replie ses
+     *  champs de force, comme un re-clic dans la hiérarchie RECHERCHE. */
+    private readonly deactivateActionFromChild;
     /** Validation — dépôt d'une bulle glissée sur la pile : l'y ajoute. */
     private readonly validateActionSelection;
     /** Glisser une bulle vers une position précise de la pile — cœur partagé
@@ -46,7 +64,7 @@ export declare class ChildActionMenuController {
     /** Groupe séparé pour les traits satellite → bulle, repositionné à chaque
      *  update() juste devant children-group (voir ensureLineLayer) pour
      *  qu'ils s'affichent derrière les satellites plutôt que par-dessus —
-     *  même technique que CoreEventMenuController.coreEventLineLayer. */
+     *  même technique que KeyEventMenuController.coreEventLineLayer. */
     private childActionLineLayer;
     private lastChildActionMenuSourceCenter;
     /** Poignée d'annulation du glisser-déposer en cours (voir startActionDrag),
@@ -59,21 +77,28 @@ export declare class ChildActionMenuController {
      *  le contexte courant) et rejoué au survol : rallumer une impulsion ne
      *  doit pas relancer la chorégraphie d'ouverture. */
     private linkStyleGetter;
-    /** Positions du dernier update() — exposées au champ de force (le segment
-     *  « bulle → source » démarre au centre de la bulle de l'action en focus). */
-    private lastPositions;
+    /** Réglages de la dernière passe de rendu, pour retailler les icônes
+     *  affichées quand une mesure abaisse le facteur admissible. */
+    private iconScaleSetting;
+    private iconActiveActionId;
     private detachedGroup;
     private detachedLineLayer;
-    private lastDetachedCenter;
-    private lastDetachedPosition;
-    /** Centre (coordonnées du globalGroup) de la bulle `actionId` du menu radial
-     *  ouvert, ou null si elle n'y est pas. */
-    getItemCenter(actionId: string): Point | null;
-    /** Centre de la bulle détachée si elle porte `actionId`, sinon null. */
-    getDetachedCenter(actionId: string): Point | null;
+    /** Bulles détachées affichées, par uniqueKey de position — relu pour faire
+     *  rentrer une bulle sortante dans SON satellite source. */
+    private detachedMeta;
+    private detachedPositions;
+    /** Dernière mise en page rendue, relue par followOrbit. null : rien à
+     *  suivre (menu fermé, ou bulles détachées repliées). */
+    private menuLayout;
+    private detachedContext;
+    /** Centre de la bulle détachée de clé `bubbleKey`, ou null si absente. */
+    getDetachedCenter(bubbleKey: string): Point | null;
     constructor(view: IYinYangView, getChildRenderedCenter: (childController: IYinYangController) => Point | null, refreshActionStackVisual: () => void, 
     /** Aperçu — clic sur une action : affiche sa carte, ne joue rien. */
     activateActionFromChild: (childController: IYinYangController, actionId: string, label?: string) => void, 
+    /** Re-clic sur l'action déjà active : la désélectionne et replie ses
+     *  champs de force, comme un re-clic dans la hiérarchie RECHERCHE. */
+    deactivateActionFromChild: (childController: IYinYangController, actionId: string) => void, 
     /** Validation — dépôt d'une bulle glissée sur la pile : l'y ajoute. */
     validateActionSelection: (childController: IYinYangController, actionId: string, label: string, insertAtVisibleIndex?: number | null, entryOrigin?: Point) => void, 
     /** Glisser une bulle vers une position précise de la pile — cœur partagé
@@ -87,8 +112,8 @@ export declare class ChildActionMenuController {
     setOnActionHover(cb: (actionId: string | null, activeChildKey: string) => void): void;
     /**
      * Applique un highlight de survol sur le cercle d'action identifié, ou le retire si null.
-     * Le highlight est posé sur le <g> wrapper (pas sur le <circle>) pour éviter le conflit
-     * avec le filtre inline déjà présent sur le cercle.
+     * Halo blanc à la place de la lueur de la bulle (voir setRadialItemHaloHighlight) :
+     * pas de filtre, la bulle suit l'orbite de son satellite.
      */
     highlightActionById(actionId: string | null): void;
     /** Restyle les seuls liens (impulsion allumée/éteinte), sans toucher à leur
@@ -96,8 +121,8 @@ export declare class ChildActionMenuController {
     private setHoveredAction;
     retractAndDispose(): void;
     clearImmediately(): void;
-    /** Retire la bulle détachée et son faisceau, tout de suite (0) ou après un
-     *  délai (fin d'une transition de facette). */
+    /** Retire les bulles détachées et leurs faisceaux, tout de suite (0) ou
+     *  après un délai (fin d'une transition de facette). */
     private disposeDetached;
     /**
      * Starts the fold-out animation on the visible action buttons, then removes
@@ -106,19 +131,36 @@ export declare class ChildActionMenuController {
      * that follows is a no-op and won't cancel the in-flight transition.
      */
     animateClose(): void;
-    /** Replie la bulle détachée (chorégraphie de fermeture), groupes conservés. */
+    /** Replie les bulles détachées (chorégraphie de fermeture), groupes
+     *  conservés. */
     private closeDetached;
     /**
-     * Bulle détachée de l'action en focus : quand un bloc de propagation est
-     * en focus, le satellite sélectionné n'est pas la source et son menu ne
-     * montre donc pas la bulle de l'action. On pose alors, sur le satellite
-     * source, la seule bulle de cette action (pas ses sœurs), en style
-     * « regardée », avec son faisceau — le champ de force peut ainsi toujours
-     * démarrer à la bulle. Un clic sélectionne le satellite source (le menu
-     * complet prend alors le relais et la bulle détachée se replie).
+     * Bulles détachées : la seule bulle d'une action (pas ses sœurs), posée sur
+     * son satellite source avec son faisceau, hors de tout menu radial.
+     *  - STACK : une par action activée de la pile — celle en focus en style
+     *    « regardée », les autres translucides comme leurs champs de force,
+     *    toutes pleines sans focus. Le champ de l'action en focus démarre à sa
+     *    bulle.
+     *  - RECHERCHE multi-blocs : celle de l'action source du panneau
+     *    verrouillé, quand on consulte un autre satellite.
+     * Chaque bulle garde la place qu'elle occupe dans le menu RECHERCHE de
+     * sa source (voir DetachedBubble.menuActions) : deux actions d'un même
+     * satellite ne s'y chevauchent donc pas.
      * Cluster indépendant du menu radial : update() n'en sait rien.
      */
     updateDetached(context: DetachedBubbleContext): void;
+    /**
+     * Frame d'orbite : recale le menu radial et les bulles détachées déjà
+     * affichés sur la position courante de leur satellite, avec la mise en
+     * page de leur dernier rendu. Ni data join, ni transition, ni listeners :
+     * leur contenu ne change que par update() / updateDetached().
+     */
+    followOrbit(orbitData: ChildrenOrbitEntry[]): void;
+    private computeDetachedLayout;
+    /** Retaille les icônes déjà affichées (menu et bulle détachée) sans
+     *  repasser par update() : un simple satellite sélectionné, sans action
+     *  active, ne déclencherait pas de rendu via le réglage du debug. */
+    private refitActionIcons;
     private ensureDetachedGroups;
     update(context: ChildActionMenuContext): void;
     private ensureChildActionMenuGroup;