repositories / dotfiles
dotfiles
bugabingas dorkfiles
owned by admin
quickshell/nuguland/features/audio/audio.js
Raw// audio.js — pure audio mixer logic: clamp/format volume, role coloring, row shaping.
// NO I/O, NO native PipeWire access, NO Quickshell imports. Receives plain field dicts
// (lifted off native nodes by Audio.qml), returns dicts/numbers/strings. Dual-mode:
// node `require` (tests) + QML import. Same pattern as clip.js/launch.js/sysinfo.js.
// --- Nerd Font glyphs (FA4 PUA, verified present in SymbolsNerdFont-Regular). \uXXXX escapes.
var GLYPH_OUT = ""; // speaker / volume-up (output)
var GLYPH_OUT_MUTE = ""; // volume-off / mute (output muted)
var GLYPH_IN = ""; // microphone (input)
var GLYPH_IN_MUTE = ""; // microphone-slash (input muted)
// --- clamp a Number into 0..1.5; null/NaN/non-finite -> 0 ---
function clampVolume(v) {
var n = Number(v);
return isFinite(n) ? Math.max(0, Math.min(1.5, n)) : 0;
}
// --- integer percent of a clamped volume: 1.0->100, 1.5->150, 0->0 ---
function volumePercent(v) {
return Math.round(clampVolume(v) * 100);
}
// --- the kind a nameless node reads as ---
var KIND_NAMES = { "sink": "output device", "source": "input device", "stream": "app sound" };
function firstNamed(candidates, fallback) {
for (var i = 0; i < candidates.length; i++) {
if (candidates[i]) return String(candidates[i]);
}
return fallback;
}
// --- display name precedence: description > nickname > node.description >
// application.name > media.name > node.name, else the kind. Native props arrive
// as flat keys. `pick` is human.js pick (Audio.qml passes it): it skips machine
// identifiers such as alsa_output.pci-0000_00_1f.3.analog-stereo. ---
function nodeName(n, pick, kind) {
n = n || {};
var choose = pick || firstNamed;
return String(choose([n.description, n.nickname, n.nodeDescription, n.applicationName, n.mediaName, n.name], KIND_NAMES[kind] || "audio device"));
}
// --- normalize a list of channel labels to lowercase strings (enums resolved natively) ---
function channelNames(channels) {
var out = [];
var list = channels || [];
for (var i = 0; i < list.length; i++) {
out.push(String(list[i]).toLowerCase());
}
return out;
}
// --- muted flag lifted off node.audio.muted by the bridge ---
function nodeMuted(n) {
return !!(n && n.muted);
}
// --- role color key by mute/volume (spec §3.2 contract):
// muted -> "warning", volume 0 -> "ui.minor", else "ui.accent" ---
function roleForSink(n) {
if (nodeMuted(n)) return "warning";
if (clampVolume(n && n.volume) <= 0) return "ui.minor";
return "ui.accent";
}
// --- privacy chip label from {mic,cam}; no flags -> "audio" (Bar chip needs non-empty) ---
function privacyLabel(flags) {
var f = flags || {};
if (f.mic && f.cam) return "mic cam";
if (f.mic) return "mic";
if (f.cam) return "cam";
return "audio";
}
// --- glyph for a row by kind + muted state ---
function glyphForRow(kind, muted) {
if (kind === "source") return muted ? GLYPH_IN_MUTE : GLYPH_IN;
return muted ? GLYPH_OUT_MUTE : GLYPH_OUT;
}
// --- shape a raw bridge dict into the view/IPC row. ALL resolution happens here. ---
function shapeRow(n, kind, pick) {
n = n || {};
var vol = clampVolume(n.volume);
return {
id: String(n.id == null ? "" : n.id),
name: nodeName(n, pick, kind),
kind: String(kind || ""),
volume: Math.round(vol * 100) / 100,
percent: volumePercent(vol),
muted: nodeMuted(n),
role: roleForSink(n),
isDefault: !!n.isDefault,
active: !!n.active,
channels: channelNames(n.channels),
glyph: glyphForRow(kind, nodeMuted(n))
};
}
// --- index rows by id ---
function rowsById(rows) {
var out = {};
var list = rows || [];
for (var i = 0; i < list.length; i++) {
out[list[i].id] = list[i];
}
return out;
}
if (typeof module !== 'undefined' && module.exports) {
module.exports = {
clampVolume: clampVolume,
volumePercent: volumePercent,
nodeName: nodeName,
channelNames: channelNames,
nodeMuted: nodeMuted,
roleForSink: roleForSink,
privacyLabel: privacyLabel,
glyphForRow: glyphForRow,
shapeRow: shapeRow,
rowsById: rowsById
};
}