@the-inclusionist/engine 9.0.0 → 10.0.0

package/dist-pkg/ui/settings-aac.js

@@ -0,0 +1,189 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+import { DEFAULTS } from '../core/setting-defaults.js';
+import { AAC_SETS, AAC_BY_KEY, aacReason } from './aac-sets.js';
+import { markChanged, markMenuChanged } from './changed-mark.js';
+import { controlRow, labelRow, sectionHeader } from './panel-widgets.js';
+import { toggleLabel } from './dom.js';
+/**
+ * The LETTERS row is a SWITCH, not two options (the Dev's decision). On = upper case only; off = upper and lower case.
+ * A binary question presented as two rows makes the child compare both to discover they are the same question.
+ */
+export function upperCaseOn(letterCase) {
+    return letterCase === 'upper';
+}
+/** The id of a set's control. It comes from the catalogue `key`, unique by construction (`AAC_BY_KEY`). */
+export const aacControlId = (key) => `caa-set-${key}`;
+/** The letters switch. Always available: it is the offline floor, and never depended on any file. */
+export function lettersRowSpec(t) {
+    return { id: 'caa-caixa-alta', label: t('aac.letras'), hint: t('aac.letras.dica') };
+}
+/**
+ * A menu row: a SHORT LABEL and nothing else in view.
+ *
+ * Everything that explains — note, licence, status — goes into a single `.opt-hint`, which the shell (`fillExplain`)
+ * recognises and MOVES to the footer. Prose hung inside the row turns the menu into a manual, closer to a configuration
+ * file than to a videogame menu — the Dev saw exactly that.
+ *
+ * `ariaLabel` carries the reason, so whoever navigates by keyboard hears why the row does not respond without hunting
+ * for the footer. `disabled` belongs to the CONTROL and not the text: the status leaves the label, never the button.
+ */
+export function aacRowSpec(t, s) {
+    const reason = aacReason(s);
+    const explains = [s.note, s.license ? `Licença: ${s.license}` : '', reason ? t(reason) : '']
+        .filter(Boolean).join(' · ');
+    return {
+        id: aacControlId(s.key),
+        label: s.name,
+        ...(explains ? { hint: explains } : {}),
+        ariaLabel: `${s.name}${reason ? ', ' + t(reason) : ''}`,
+    };
+}
+/**
+ * The menu's three sections, in decision order: the section says WHOSE turn it is to act.
+ *
+ * 📌 Each produces its own rows instead of filtering the catalogue, because the first does not come from the catalogue
+ * — the letters are a switch and not a set, the Dev's decision that took them out of the list. A table whose first row
+ * is the exception to all the others lies about what it is.
+ */
+export const AAC_SECTIONS = [
+    { title: 'aac.secao.agora', tag: 'aac.secao.agoraTag', rows: (t) => [lettersRowSpec(t)] },
+    {
+        title: 'aac.secao.preparo',
+        tag: 'aac.secao.preparoTag',
+        rows: (t) => AAC_SETS.filter((s) => s.tier !== 'negotiating').map((s) => aacRowSpec(t, s)),
+    },
+    {
+        title: 'aac.secao.negociacao',
+        tag: 'aac.secao.negociacaoTag',
+        rows: (t) => AAC_SETS.filter((s) => s.tier === 'negotiating').map((s) => aacRowSpec(t, s)),
+    },
+];
+/**
+ * Mounts the menu's inside ONCE. Called again, it RELABELS instead of rebuilding.
+ *
+ * ⚠️ Relabel and not rebuild, for the reason `labelRow` already states: listeners are wired at boot, and remaking the
+ * row would leave a control in the document with no listener — a dead button that looks alive (ADR-0106 §5). And the
+ * text may have been captured at boot, while the language was still the fallback.
+ */
+export function mountAacInside(t, ctx, list) {
+    for (const section of AAC_SECTIONS) {
+        const specs = section.rows(t);
+        const header = sectionHeader(ctx, t(section.title), t(section.tag), specs.length);
+        if (header && !list.querySelector(`[data-caa-section="${section.title}"]`)) {
+            header.setAttribute('data-caa-section', section.title);
+            list.appendChild(header);
+        }
+        for (const spec of specs) {
+            const old = ctx.find('#' + spec.id)?.closest('.ctrl-row');
+            if (old)
+                labelRow(old, spec);
+            else
+                list.appendChild(newRow(ctx, spec));
+        }
+    }
+}
+/**
+ * A new row, with what the kit does not know about this panel: the set's key and the lock.
+ *
+ * No set is available today. A button that does nothing is worse than absence, because it spends trust — so it comes
+ * locked, and the reason is already in `ariaLabel` for whoever navigates by keyboard.
+ */
+function newRow(ctx, spec) {
+    const { row: row, control: control } = controlRow(ctx, spec);
+    if (spec.id === 'caa-caixa-alta') {
+        row.id = 'caa-letras';
+        return row;
+    }
+    const key = spec.id.replace('caa-set-', '');
+    control.setAttribute('data-caa', key);
+    if (!AAC_BY_KEY[key]?.available)
+        control.setAttribute('disabled', '');
+    return row;
+}
+export function initSettingsAac(ctx) {
+    const { t } = ctx;
+    /*
+     * 📌 THE KIT'S CTX COMES FROM THE LIST NODE ITSELF, not from a global `document` nor a new contract field.
+     * `ownerDocument` is the document that list LIVES in — exactly the document the rows must be born in —, so this
+     * module's global reach stays ZERO (ADR-0221) and `SettingsAacCtx`, which is published surface, gains no required
+     * member (ADR-0172).
+     */
+    const panelCtx = (list) => ({
+        find: (sel) => ctx.$(sel),
+        create: (tag) => list.ownerDocument.createElement(tag),
+    });
+    function reflect() {
+        const b = ctx.$('#caa-caixa-alta');
+        if (!b)
+            return;
+        const on = upperCaseOn(ctx.getLetterCase());
+        b.classList.toggle('is-on', on);
+        b.setAttribute('aria-pressed', String(on));
+        // The switch's text is the STATE; its name is in the `<strong>` beside it and in the `aria-label`.
+        b.textContent = toggleLabel(t, on);
+    }
+    function render() {
+        const el = ctx.$('#caa-list');
+        if (!el)
+            return;
+        mountAacInside(t, panelCtx(el), el);
+        reflect();
+        ctx.fillExplain(ctx.$('#caa .overlay__card'));
+        refreshMarks();
+    }
+    /** The left-the-default mark (ADR-0029), on the chosen row and on the menu's button. */
+    function refreshMarks() {
+        const changed = ctx.getLetterCase() !== DEFAULTS.letterCase;
+        markChanged(t, ctx.$('#caa-letras'), changed);
+        markMenuChanged(t, ctx.$('[data-act="caa"]'), [changed]);
+    }
+    function open() {
+        const ov = ctx.$('#caa');
+        if (!ov)
+            return;
+        render();
+        ov.hidden = false;
+        ctx.frontOverlay(ov);
+        const f = ov.querySelector('button');
+        if (f)
+            f.focus();
+    }
+    function close() {
+        const ov = ctx.$('#caa');
+        if (!ov)
+            return;
+        ov.hidden = true;
+        ctx.restoreFocus?.('caa');
+    }
+    /*
+     * The listeners are wired ONCE, on the list, by delegation — which mounting once allows. What protects an
+     * unavailable set is its own button's `disabled`, written where it is born; a listener that only guards and then does
+     * nothing would be inert code dressed as protection.
+     */
+    const list = ctx.$('#caa-list');
+    if (list)
+        list.addEventListener('click', (ev) => {
+            const hit = ev.target?.closest('#caa-caixa-alta');
+            if (!hit)
+                return;
+            const turnOn = !upperCaseOn(ctx.getLetterCase());
+            ctx.setLetterCase(turnOn ? 'upper' : 'mixed');
+            render();
+            ctx.srSay(t(turnOn ? 'sr.aac.caixaAltaOn' : 'sr.aac.caixaAltaOff'));
+        });
+    const closeBtn = ctx.$('#caa-close');
+    if (closeBtn)
+        closeBtn.addEventListener('click', close);
+    // ---- reset THIS menu's defaults (ADR-0028) ----
+    // The menu has one choice, so the reset is one line — but where it returns to is worth saying: the default case,
+    // where Brazilian literacy usually starts. A child who switched the case and can no longer read the screen needs a way
+    // back that ends at what their teacher uses.
+    const resetBtn = ctx.$('#caa-reset');
+    if (resetBtn)
+        resetBtn.addEventListener('click', () => {
+            ctx.setLetterCase(DEFAULTS.letterCase);
+            render();
+            ctx.srSay(t('sr.aac.reset'));
+        });
+    return { render, open, close };
+}

package/dist-pkg/ui/settings-audio.d.ts

@@ -1,49 +1,46 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
+import type { Translate, Translator } from '../core/i18n.js';
 import type { PlayerView } from '../core/entity.js';
 import type { PlayerAudioOut } from '../platform/audio-sonar.js';
 import type { DomQuery } from '../core/dom-query.js';
+import type { PanelShellCtx } from './panel-shell.js';
+import { type TtsPanel, type VoiceSettingsStore } from './voice-settings.js';
 export type { DomQuery } from '../core/dom-query.js';
 /** Minimal platform/storage.ts shape this module needs (get/set only — no direct localStorage access). */
 export interface AudioStore {
     get(key: string, fallback?: string | null): string | null;
     set(key: string, value: string | number | boolean): boolean;
 }
-export interface AudioCatDef {
-    k: string;
-    lbl: string;
-}
-export interface AudioCatState {
-    on: boolean;
-    vol: number;
-}
-export interface TtsPanelEngine {
-    id: string;
-    speak: (text: string) => void;
-}
-/** Minimal shape of the injected `tts` (platform/tts.ts's createTts() instance) this panel drives. */
-export interface TtsPanel {
-    getEngineSel: () => string;
-    setEngineSel: (v: string) => void;
-    getEngine: () => TtsPanelEngine | null;
-    getVoiceObj: () => SpeechSynthesisVoice | null;
-    setVoiceObj: (v: SpeechSynthesisVoice | null) => void;
-    loadTTS: () => void;
-    narrate: (text: string) => void;
-    /**
-     * ESTA MONTAGEM TEM MOTOR NEURAL? (ADR-0094) OPCIONAL, e a ausência vale `true`: um falso de teste
-     * escrito antes deste campo não tem opinião sobre motores neurais, e fazê-lo esconder o Piper mudaria o
-     * que esse teste afirma sem que ninguém tenha escrito a mudança.
-     */
-    neuralDisponivel?: boolean;
-}
+import { type AudioCatDef, type AudioCatState } from './audio-choices.js';
 /**
- * Saída de áudio dedicada de um jogador: o id do dispositivo e o AudioContext/ganho que ele abriu.
+ * A player's dedicated audio output: the device id and the AudioContext/gain it opened.
  *
- * O id é da entidade (é preferência do jogador, persistida); o par `_ac`/`_acOut` é do
- * `platform/audio-sonar`, que os cria. Daí a intersecção em vez de três chaves numa vista só.
+ * The id is the entity's (a persisted player preference); the `_ac`/`_acOut` pair is `platform/audio-sonar`'s, which
+ * creates them. Hence the intersection instead of three keys in one view.
  */
 export type SinkPlayer = PlayerView<'audioSink'> & PlayerAudioOut;
+/**
+ * THE SETTINGS THIS PANEL READS AND WRITES — the page's settings store, built by the root (ADR-0232 D2c, issue #207): the
+ * voice section's (the spoken index and the speech rate) and the default blind-mode writer. A root passes `core/state`.
+ */
+export interface SettingsAudioSettings extends VoiceSettingsStore {
+    /** Write, persist, notify — used when the host injects no `setBlindMode`. */
+    setBlindModeValue(on: boolean): void;
+}
 export interface SettingsAudioCtx {
+    /**
+     * The root's translator (ADR-0232 D3): its `t`, and the page's language as a BCP-47 tag, which picks the system voices the
+     * list offers. A Pick and not a bare `t`, because the voice list reads the language.
+     */
+    translator: Pick<Translator, 't' | 'bcp47'>;
+    /** The page's settings store (see `SettingsAudioSettings`). REQUIRED (ADR-0232): no module reads it by import. */
+    settings: SettingsAudioSettings;
+    /**
+     * Subscribes to a setting's change and returns the release. REQUIRED, and it is the ROOT'S door (`stateOn` in
+     * `createGame`): a subscription made through it ends with the root's `dispose()` (ADR-0220), where one made on the
+     * page's bus by import went on redrawing the panel of an ended root.
+     */
+    on: (setting: 'blindMode', react: (on: boolean) => void) => () => void;
     /** DOM selector (querySelector), injected — never reaches `document` globally. */
     $: DomQuery;
     /** Screen-reader "polite" announcement (core/a11y-sr's srSay), injected. */
@@ -51,15 +48,38 @@ export interface SettingsAudioCtx {
     /** Persistence (platform/storage.ts) — only the TTS engine/voice choice and the per-player audio sink live
      *  here; the mixer categories persist through `setCatGain` (platform/audio.ts already saves them). */
     store: AudioStore;
-    /** Category catalog (platform/audio-mixer.ts's AUDIO_CATS) — pure data, injected like game.js's own import. */
+    /**
+     * Creates an element KEEPING its type — the outputs' `<select>` answers `.value`, the voice list needs `<option>`.
+     *
+     * 📌 Named like its neighbour, `ui/voice-settings`'s `newOption`.
+     */
+    newElement: <K extends keyof HTMLElementTagNameMap>(tag: K) => HTMLElementTagNameMap[K];
+    /** THIS device's speech synthesis. With no voices, `voices` returns an empty list — which is an answer. */
+    speech: {
+        voices: () => readonly SpeechSynthesisVoice[];
+        speakSample: (sample: string, chosen: SpeechSynthesisVoice | null) => void;
+        whenVoicesChange: (again: () => void) => void;
+    };
+    /** This device's audio outputs, and what it can do with them. */
+    audioOutputs: {
+        /** Can this browser LIST outputs? */
+        canList: () => boolean;
+        /** Can this browser ROUTE sound to a chosen output? (It needs an AudioContext.) */
+        canRoute: () => boolean;
+        /** The outputs already known, without asking permission — many come unnamed, which is the browser's design. */
+        list: () => Promise<readonly MediaDeviceInfo[]>;
+        /** Asks permission so the outputs have NAMES, and returns them. */
+        detect: () => Promise<readonly MediaDeviceInfo[]>;
+    };
+    /** Category catalog (platform/audio-mixer.ts's AUDIO_CATS) — pure data, injected. */
     audioCats: readonly AudioCatDef[];
-    /** Shared helper (game.js): toggles a button's .is-on/aria-pressed. Used by many other panels too — not ours. */
+    /** Shared helper (the host's): toggles a button's .is-on/aria-pressed. Used by many other panels too — not ours. */
     toggleBtn: (b: HTMLElement, on: boolean) => void;
-    /** Shared: current player count (core/state.ts's numPlayers, read live via game.js). */
+    /** Shared: current player count, read live from the host. */
     getNumPlayers: () => number;
-    /** Shared: the live players array (core/state.ts) — only `.audioSink`/`._ac`/`._acOut` are touched here. */
+    /** Shared: the live players array — only `.audioSink`/`._ac`/`._acOut` are touched here. */
     getPlayers: () => SinkPlayer[];
-    /** Master mute (platform/audio.ts's soundOn), read/write live via game.js's re-export. */
+    /** Master mute (platform/audio.ts's soundOn), read/write live. */
     getSoundOn: () => boolean;
     setSoundOn: (on: boolean) => void;
     /** Master volume 0..1 (platform/audio.ts's volume). */
@@ -71,100 +91,58 @@ export interface SettingsAudioCtx {
     setCatGain: (cat: string) => void;
     /** Narration engine/voice panel API (platform/tts.ts's createTts() instance). */
     tts: TtsPanel;
-    /** Core collision state (NOT owned by this panel — core/collision.ts reads it via isModoCego). The toggle's
-     *  widget lives inside #audio; the state and its gameplay side effects (setupExtras) stay in game.js. */
-    getModoCego: () => boolean;
-    setModoCego?: (on: boolean) => void;
-    /** Core collision state (cane hit spacing). Same reasoning as modo cego. */
+    /** Blind-mode state (NOT owned by this panel). The toggle's widget lives inside #audio; the state and its gameplay
+     *  side effects belong to the host. */
+    getBlindMode: () => boolean;
+    setBlindMode?: (on: boolean) => void;
+    /** Cane hit spacing. Same reasoning as blind mode. */
     getCaneBlockDiv: () => number;
     setCaneBlockDiv: (div: number) => void;
     /**
-     * Move a prosa das linhas para o rodapé (`ui/settings-panel` → `fillExplain`). Chamado a CADA render.
+     * Moves the rows' prose to the footer (`ui/settings-panel` → `fillExplain`). Called on EVERY render.
      *
-     * ⚠️ NÃO É OPCIONAL POR ELEGÂNCIA: `fillExplain` roda uma vez quando o overlay é frontalizado e move o
-     * `.opt-hint` de dentro de cada linha para o rodapé. Este painel RECONSTRÓI as linhas, e as linhas novas
-     * voltam com a prosa lá dentro — então a explicação aparece duas vezes, no rodapé e sob o rótulo, a
-     * partir do primeiro clique. O `CLAUDE.md` §4 regista exatamente isto, e a issue #109 já o consertou
-     * uma vez noutros painéis.
+     * ⚠️ Relabelling a row puts its `.opt-hint` back inside it — so without this call the explanation appears twice, in
+     * the footer and under the label, from the first click. `CLAUDE.md` §4 records exactly this (issue #109).
      *
-     * Opcional na assinatura porque um consumidor pode montar o painel sem a casca (um teste, o segundo
-     * consumidor): sem casca não há rodapé para duplicar.
+     * Optional in the signature because a consumer can mount the panel without the shell (a test): without the shell
+     * there is no footer to duplicate.
      */
     fillExplain?: (card: HTMLElement | null) => void;
 }
 export interface SettingsAudioApi {
-    /** Re-renders the whole #audio overlay content (master, categories, nav-sound, TTS panel, sinks, modo-cego and
-     *  cane-div sync) and re-wires whatever it (re)creates. Idempotent; game.js's openAudio() calls it every open. */
+    /** Re-renders the whole #audio overlay content (master, categories, nav-sound, TTS panel, sinks, blind-mode and
+     *  cane-div sync) and re-wires whatever it (re)creates. Idempotent; the host calls it on every open. */
     renderAudio: () => void;
-    /** Refreshes the #opt-modocego button. Exported because game.js's setModoCego() calls it directly. */
-    reflectModoCego: () => void;
-    /** Refreshes the #opt-tts button + #tts-engine selection. Exported because the pause-menu icon bar's
-     *  iconAct('tts', …) toggles audioCat.tts.on itself and then calls this. */
+    /** Refreshes the #opt-modocego button. Exported because the host's blind-mode setter calls it directly. */
+    reflectBlindMode: () => void;
+    /** Refreshes the #opt-tts button + #tts-engine selection. Exported because the pause-menu icon bar toggles
+     *  audioCat.tts.on itself and then calls this. */
     reflectTts: () => void;
 }
-/** Categorias de NAVEGAÇÃO SONORA (bengala/sonar/guarda/guia) — volume geral separado do som do jogo. */
-export declare const NAV_CATS: readonly ["sonar", "guard", "guide"];
-/** Categorias GERAIS do jogo (TTS fica na seção Voz, fora desta lista). */
-export declare const GEN_CATS: readonly ["music", "ambient", "interact", "earcons", "other"];
-/** 0..1 -> 0..100 rounded (slider display value). */
-export declare function volPercent(v: number): number;
-/** One category row's markup (volume slider + on/off switch). Pure — resolves label/state from the given data,
- *  never from a global. Returns '' for an unknown/missing category (defensive; never hit with real catalogs). */
-export declare function catRowHTML(k: string, cats: readonly AudioCatDef[], state: Readonly<Record<string, AudioCatState>>): string;
-/** Full innerHTML for a category list (#audio-list or #navsound-list). Pure string building — no DOM. */
-export declare function catsListHTML(keys: readonly string[], cats: readonly AudioCatDef[], state: Readonly<Record<string, AudioCatState>>): string;
-/** #navsound-master's value: the loudest of the nav categories, as a 0..100 slider value. */
-export declare function navMasterVolume(state: Readonly<Record<string, AudioCatState>>, navCats?: readonly string[]): number;
-/** Cane-hit spacing select -> validated int (garbage/empty -> 1, "a batida por bloco"). */
-export declare function parseCaneDiv(raw: string): number;
-/** srSay text for a cane-hit spacing choice. The two halves are ONE sentence per case, not a shared prefix
- *  plus a tail: a language that renders this as "One tap per block (cane)" needs to move the word "cane". */
-export declare function caneDivMessage(div: number): string;
-/** #tts-engine's option catalog: (value, i18n KEY of the label). The engine NAMES are proper nouns and stay
- *  put; what translates is the parenthetical that explains each one. Keys, not text — see input/devices. */
-export declare const TTS_ENGINE_OPTIONS: readonly (readonly [string, string])[];
 /**
- * Os motores que ESTA MONTAGEM pode de facto oferecer (ADR-0094).
+ * MOUNTS THIS PANEL'S INSIDE — the controls and containers it reaches.
+ *
+ * 🔴 IT IS THE LARGEST INVISIBLE CONTRACT OF THE PANELS: this file looks for `#opt-modocego`, `#cane-div`,
+ * `#opt-menuindex`, `#opt-tts`, `#tts-vol` and more, and nothing in the type says so — which is why it builds them.
  *
- * ⚠️ Desde que o motor neural passou a chegar por PORTA (`ctx.carregarVozNeural`), «o Piper existe» deixou
- * de ser verdade sobre a engine e passou a ser verdade sobre o JOGO. Oferecer uma opção que não pode
- * funcionar é pior que uma opção a menos: quem a escolhe fica à espera de um download que nunca começa, e
- * quem navega por escuta não tem como ver que não começou.
+ * ⚠️ AND EACH ONE'S TAG MATTERS, which makes this the worst place to guess: `#cane-div` and the voice selects have to be
+ * `<select>` — the panel writes `.value` into them —, and the volumes have to be `<input type=range>`. On a `<button>`,
+ * writing `.value` gives no error at all: it creates a property nobody reads, and the child's choice vanishes silently.
  *
- * Só o `piper` é filtrado. `kokoro`/`kitten`/`espeak` também não funcionam hoje — «ainda não entraram» —,
- * mas isso é anterior a este registro e escondê-los aqui mudaria comportamento que ninguém pediu para mudar.
+ * 📌 THE ORDER IS THE DECISION (ADR-0044 §2), from general to particular (see the composition below).
+ *
+ * ⚠️ `#opt-sound` IS NOT CREATED HERE, deliberately: it is this setting's mirror on the quick bar, outside the panel.
+ * `reflectMaster` reaches it with a guard (`if (sb)`), because a game may have no bar.
+ *
+ * Idempotent: calling it twice reuses what exists instead of duplicating it.
  */
-export declare function opcoesDeMotor(neuralDisponivel: boolean): readonly (readonly [string, string])[];
-export interface VoiceLike {
-    name: string;
-    lang: string;
-}
+export declare function mountAudioInside(t: Translate, ctx: PanelShellCtx, card: HTMLElement, list: HTMLElement): void;
 /**
- * As vozes do sistema no idioma pedido; sem nenhuma, a lista inteira.
+ * MOUNTS THE AUDIO PANEL'S INSIDE (ADR-0151 §2 item 4): the general sound — switch and volume — and then the shell's
+ * list with the four taste categories (music, ambience, interaction, earcons).
  *
- * Chamava-se `pickPtVoices` e filtrava `/^pt/i` fixo, de modo que o jogo em inglês oferecia à pessoa uma
- * lista de vozes PORTUGUESAS para ler texto em inglês. O nome dizia a verdade sobre o que fazia e mentia
- * sobre o que devia fazer.
- *
- * A comparação é pelo PREFIXO de idioma, não pela etiqueta inteira: quem joga em pt-BR também deve poder
- * escolher uma voz pt-PT se for a única instalada, e o navegador de uma escola raramente tem a variante
- * exata. O recuo para a lista inteira fica: uma lista vazia seria pior que uma lista no idioma errado, que
- * ao menos a pessoa pode ouvir e rejeitar.
+ * ⚠️ THE IDS ARE THE ONES `initSettingsAudio` ALREADY LISTENS TO (`#audio-master`, `#audio-master-vol`, `#audio-list`). And
+ * the same order rule: mount BEFORE `init`. Idempotent and relabellable, like its hearing sibling.
  */
-export declare function pickVoicesFor<T extends VoiceLike>(voices: readonly T[], lang: string): readonly T[];
-/** "<name> (<lang>)" option label. */
-export declare function voiceLabel(v: VoiceLike): string;
-/** Whether the browser can list/switch audio outputs at all (gates the #audio-sinks hint copy). */
-export declare function sinksSupported(hasEnumerateDevices: boolean, hasAudioContextCtor: boolean): boolean;
-export interface SinkDeviceLike {
-    deviceId: string;
-    label?: string;
-}
-/** A device's option label, falling back to a 1-based "Saída N" when the browser withholds the real label
- *  (no getUserMedia permission granted yet). */
-export declare function sinkOptionLabel(d: SinkDeviceLike, index: number): string;
-/** A player's current sink select value ('' = default/shared). */
-export declare function sinkSelectValue(p: {
-    audioSink?: string | null;
-} | undefined): string;
+export declare function mountSoundInside(t: Translate, ctx: PanelShellCtx, card: HTMLElement, list: HTMLElement): void;
 export declare function initSettingsAudio(ctx: SettingsAudioCtx): SettingsAudioApi;