repositories / dotfiles
dotfiles
bugabingas dorkfiles
owned by admin
quickshell/nuguland/features/osd/osd.js
Raw// osd.js — pure OSD logic: event normalization, role, meter value, icon name,
// labels. NO timers, NO Quickshell imports. Dual-mode: node `require` (tests)
// + QML import. Osd.qml owns the visible/expiry state and delegates here.
var supportedEvents = ["volume", "microphone", "brightness", "media", "workspace", "screenshot", "color", "error"];
// unknown events render as errors instead of silently inventing a new kind
function normalizeEvent(event) {
var name = String(event);
return supportedEvents.indexOf(name) >= 0 ? name : "error";
}
function roleFor(event, value) {
var name = String(event);
var text = String(value);
if (name === "error")
return "error";
if (name === "microphone" && (text === "muted" || text === "active"))
return "warning";
if (name === "volume" || name === "brightness")
return "ui.accent";
return "info";
}
function isNumeric(value) {
var text = String(value).replace("%", "").trim();
return text.length > 0 && isFinite(Number(text));
}
// 0..1 for the meter-style events (volume/brightness/microphone) when the
// value is a real number; -1 otherwise (mute toggles, media, color, error)
// so the bar is hidden rather than drawn empty.
function normalizedValue(event, value) {
var name = String(event);
if (name !== "volume" && name !== "brightness" && name !== "microphone")
return -1;
if (!isNumeric(value))
return -1;
return Math.max(0, Math.min(1, Number(String(value).replace("%", "")) / 100));
}
// Nerd Font (Material Design) glyph for the event, the same family as the bar
// chips, so every event draws an icon without depending on the icon theme.
// Code points verified with the nerdfont-icons helper.
var glyphs = {
"volume-off": "\u{F0581}", // nf-md-volume_off
"volume-low": "\u{F057F}", // nf-md-volume_low
"volume-medium": "\u{F0580}", // nf-md-volume_medium
"volume-high": "\u{F057E}", // nf-md-volume_high
"microphone": "\u{F036C}", // nf-md-microphone
"microphone-off": "\u{F036D}", // nf-md-microphone_off
"brightness": "\u{F00DF}", // nf-md-brightness_6
"play": "\u{F040A}", // nf-md-play
"pause": "\u{F03E4}", // nf-md-pause
"screenshot": "\u{F0E51}", // nf-md-monitor_screenshot
"color": "\u{F020A}", // nf-md-eyedropper
"error": "\u{F0028}", // nf-md-alert_circle
"info": "\u{F02FC}" // nf-md-information
};
function glyph(event, value) {
var name = String(event);
var text = String(value);
var level = Number(text.replace("%", ""));
var muted = text === "muted" || (isNumeric(text) && level <= 0);
if (name === "volume")
return glyphs[muted ? "volume-off" : (level < 34 ? "volume-low" : (level < 67 ? "volume-medium" : "volume-high"))];
if (name === "microphone")
return glyphs[muted ? "microphone-off" : "microphone"];
if (name === "brightness" || name === "screenshot" || name === "color" || name === "error")
return glyphs[name];
if (name === "media")
return glyphs[text.indexOf("pause") >= 0 ? "pause" : "play"];
return glyphs.info;
}
// An error is titled by its subject and keeps the failure as its body: the
// message splits at its first " · " or ": ", e.g. "screenshot not taken · no
// save path given". Only a message without a subject keeps the generic heading.
function errorParts(value) {
var text = String(value);
var match = /^(.+?)(?: · |: )(.+)$/.exec(text);
return match ? { "title": match[1], "body": match[2] } : { "title": "error", "body": text };
}
// An unsupported event renders as an error whose subject is the event's name.
function normalizeValue(event, value) {
var name = String(event);
return normalizeEvent(name) === "error" && name !== "error" && name.length > 0 ? name + " · " + String(value) : String(value);
}
// the label is the lowercase event name itself, an error's its subject
function displayLabel(event, value) {
var name = String(event);
return name === "error" ? errorParts(value).title : name;
}
// right-aligned glance value: "72%" for meters, a word for toggles, the
// raw payload (media event / colour hex) otherwise. Errors render their
// message in the body line instead, so the corner stays empty.
function displayValue(event, value) {
var name = String(event);
var text = String(value);
var normalized = normalizedValue(name, text);
if (normalized >= 0)
return Math.round(normalized * 100) + "%";
if (text === "muted")
return "muted";
if (text === "unmuted")
return "on";
if (name === "error")
return "";
return text;
}
function iconRole(event, value) {
var name = String(event);
var text = String(value);
if (name === "volume")
return Number(text) <= 0 ? "audio-muted" : "audio-volume";
if (name === "microphone")
return text === "muted" ? "microphone-muted" : "microphone-active";
if (name === "brightness")
return "brightness";
if (name === "screenshot")
return "screenshot";
if (name === "color")
return "color-picker";
if (name === "error")
return "danger";
return name.length > 0 ? name : "info";
}
function numericText(event, value) {
var normalized = normalizedValue(event, value);
return normalized >= 0 ? String(Math.round(normalized * 100)) : "";
}
function valueIndicator(event, value, role) {
var name = String(event);
var text = String(value);
var normalized = normalizedValue(name, text);
var hasProgress = normalized >= 0;
return {
"source": "Nuguland OsdValueIndicator.qml plus Nuguland OSD sliders",
"layout": "icon-left-value-right",
"iconRole": iconRole(name, text),
"glyph": glyph(name, text),
"displayLabel": displayLabel(name, text),
"displayValue": displayValue(name, text),
"value": text,
"normalizedValue": hasProgress ? normalized : null,
"progressBar": {
"visible": hasProgress,
"from": 0,
"to": 1,
"value": hasProgress ? normalized : 0,
"role": role
},
"numericText": {
"text": numericText(name, text),
"odometerMotion": hasProgress,
"hardSeparator": hasProgress ? "%" : ""
},
"slideFromEdge": {
"edge": "right",
"hiddenOffset": "width+sidebar-gap",
"visibleOffset": 0
},
"wheelActions": name === "volume" ? ["volume-up", "volume-down"] : name === "brightness" ? ["brightness-up", "brightness-down"] : [],
"protectionMessage": {
"visible": name === "error",
"role": "error",
"text": name === "error" ? errorParts(text).body : ""
},
"hardSeparator": hasProgress ? "%" : ""
};
}
if (typeof module !== 'undefined' && module.exports) {
module.exports = {
supportedEvents: supportedEvents,
normalizeEvent: normalizeEvent,
normalizeValue: normalizeValue,
errorParts: errorParts,
roleFor: roleFor,
isNumeric: isNumeric,
normalizedValue: normalizedValue,
glyph: glyph,
displayLabel: displayLabel,
displayValue: displayValue,
iconRole: iconRole,
numericText: numericText,
valueIndicator: valueIndicator
};
}