From 4071b681a9b704c1970e4f2c65d7465012a18e62 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Sat, 7 Nov 2026 11:50:07 +0100 Subject: sonix: pure helpers for the player, with their test Co-Authored-By: Claude Haiku 5.5 --- desktop/modules/sonix/Sonix.js | 115 ++++++++++++++++++++++++++++++++++++ desktop/modules/sonix/test_sonix.js | 99 +++++++++++++++++++++++++++++++ 2 files changed, 214 insertions(+) create mode 100644 desktop/modules/sonix/Sonix.js create mode 100644 desktop/modules/sonix/test_sonix.js (limited to 'desktop/modules') diff --git a/desktop/modules/sonix/Sonix.js b/desktop/modules/sonix/Sonix.js new file mode 100644 index 0000000..76ac1f5 --- /dev/null +++ b/desktop/modules/sonix/Sonix.js @@ -0,0 +1,115 @@ +.pragma library + +// Copyright (C) 2026 Danilo M. +// +// This program is free software; you can redistribute it and/or modify +// it under the terms of the GNU General Public License version 2 as +// published by the Free Software Foundation. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. + +// Pure helpers for the Sonix player: no QML, so node tests them +// (test_sonix.js). + +// "SONIXLINK1 ", broadcast by the player every 2s. +function parseBeacon(line) { + const f = String(line).trim().split(" "); + if (f.length < 4 || f[0] !== "SONIXLINK1") return null; + const port = parseInt(f[2], 10); + if (!/^\d{1,3}(\.\d{1,3}){3}$/.test(f[1]) || !(port > 0 && port < 65536)) return null; + return { host: f[1], port: port, name: f.slice(3).join(" ") }; +} + +function rateText(hz) { + const k = hz / 1000; + return Number.isInteger(k) ? String(k) : k.toFixed(1); +} + +// "FLAC · 24/96 · 2304 kbps" from /api/state. +function qualityLine(s) { + const parts = []; + const m = /\.([A-Za-z0-9]+)$/.exec(s.path || ""); + if (m) parts.push(m[1].toUpperCase()); + if (s.sample_rate > 0) + parts.push(s.bits > 0 ? `${s.bits}/${rateText(s.sample_rate)}` : `${rateText(s.sample_rate)} kHz`); + if (s.bitrate > 0) parts.push(`${s.bitrate} kbps`); + return parts.join(" · "); +} + +const MODES = ["normal", "repeat_all", "repeat_one", "shuffle", "shuffle_repeat"]; +// md-repeat_off, md-repeat, md-repeat_once, md-shuffle, md-shuffle (with repeat) +const MODE_GLYPHS = [0xF0457, 0xF0456, 0xF0458, 0xF049D, 0xF049D]; + +function nextMode(m) { return MODES[(MODES.indexOf(m) + 1) % MODES.length]; } +function modeGlyph(m) { return MODE_GLYPHS[Math.max(0, MODES.indexOf(m))]; } + +function clock(sec) { + sec = Math.max(0, Math.floor(sec)); + return Math.floor(sec / 60) + ":" + String(sec % 60).padStart(2, "0"); +} + +// The picture scaled to cover W x H times zoom (1..4), its top-left offset +// clamped so no edge of the frame is left uncovered. +function cover(imgW, imgH, zoom, x, y, W, H) { + const z = Math.max(1, Math.min(4, zoom)); + const s = Math.max(W / imgW, H / imgH) * z; + const w = imgW * s, h = imgH * s; + return { scale: s, zoom: z, w: w, h: h, + x: Math.min(0, Math.max(W - w, x)), + y: Math.min(0, Math.max(H - h, y)) }; +} + +// Centred at minimum zoom: the crop the player makes on its own. +function centred(imgW, imgH, W, H) { + const c = cover(imgW, imgH, 1, 0, 0, W, H); + return cover(imgW, imgH, 1, (W - c.w) / 2, (H - c.h) / 2, W, H); +} + +// A new zoom that keeps the picture point under (cx, cy) where it is. +function zoomAt(imgW, imgH, p, zoom, cx, cy, W, H) { + const k = cover(imgW, imgH, zoom, 0, 0, W, H).scale / p.scale; + return cover(imgW, imgH, zoom, cx - (cx - p.x) * k, cy - (cy - p.y) * k, W, H); +} + +function stamp(d) { + const p = n => String(n).padStart(2, "0"); + return `bootlogo-${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}` + + `-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`; +} + +function query(o) { + const out = []; + for (const k in o) out.push(encodeURIComponent(k) + "=" + encodeURIComponent(o[k])); + return out.join("&"); +} + +// Breadcrumbs from the card root to path; a path outside the card is the root. +function crumbs(path, root) { + const out = [{ name: "Card", path: root }]; + if (!path || path.indexOf(root + "/") !== 0) return out; + let at = root; + const parts = path.slice(root.length + 1).split("/"); + for (let i = 0; i < parts.length; i++) { + if (!parts[i]) continue; + at += "/" + parts[i]; + out.push({ name: parts[i], path: at }); + } + return out; +} + +function parentOf(path, root) { + if (!path || path === root || path.indexOf(root + "/") !== 0) return root; + return path.slice(0, path.lastIndexOf("/")); +} + +// A colour choice is a hex value or "udt", the live udt accent. +function colour(token, udt) { return token === "udt" ? udt : token; } + +const DIRS = { ne: [1, -1], se: [1, 1], sw: [-1, 1], nw: [-1, -1] }; +function offsetXY(dir, n) { + const d = DIRS[dir] || DIRS.se; + return { x: d[0] * n, y: d[1] * n }; +} diff --git a/desktop/modules/sonix/test_sonix.js b/desktop/modules/sonix/test_sonix.js new file mode 100644 index 0000000..c19a123 --- /dev/null +++ b/desktop/modules/sonix/test_sonix.js @@ -0,0 +1,99 @@ +// Copyright (C) 2026 Danilo M. +// +// This program is free software; you can redistribute it and/or modify +// it under the terms of the GNU General Public License version 2 as +// published by the Free Software Foundation. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. + +// Run: node desktop/modules/sonix/test_sonix.js +// Sonix.js is a QML library, so its .pragma line is stripped before node +// evaluates it. + +const fs = require("fs"); +const assert = require("assert"); + +const src = fs.readFileSync(__dirname + "/Sonix.js", "utf8") + .replace(/^\.pragma library$/m, ""); +const S = new Function(src + + "\nreturn { parseBeacon, qualityLine, nextMode, modeGlyph, clock, cover, centred, zoomAt," + + " stamp, query, crumbs, parentOf, colour, offsetXY };")(); + +// Beacon: "SONIXLINK1 ". +assert.deepStrictEqual(S.parseBeacon("SONIXLINK1 10.0.0.5 7800 HiBy R1\n"), + { host: "10.0.0.5", port: 7800, name: "HiBy R1" }); +assert.strictEqual(S.parseBeacon("SONIXLINK2 10.0.0.5 7800 x"), null); +assert.strictEqual(S.parseBeacon("SONIXLINK1 nope 7800 x"), null); +assert.strictEqual(S.parseBeacon("SONIXLINK1 10.0.0.5 0 x"), null); +assert.strictEqual(S.parseBeacon("SONIXLINK1 10.0.0.5 7800"), null); + +// Quality line from /api/state fields. +assert.strictEqual(S.qualityLine({ path: "/mnt/sd_0/a/b.flac", sample_rate: 96000, bits: 24, bitrate: 2304 }), + "FLAC · 24/96 · 2304 kbps"); +assert.strictEqual(S.qualityLine({ path: "x.mp3", sample_rate: 44100, bits: 0, bitrate: 320 }), + "MP3 · 44.1 kHz · 320 kbps"); +assert.strictEqual(S.qualityLine({ path: "", sample_rate: 0, bits: 0, bitrate: 0 }), ""); + +// Mode cycle, unknown restarts at normal. +assert.strictEqual(S.nextMode("normal"), "repeat_all"); +assert.strictEqual(S.nextMode("shuffle_repeat"), "normal"); +assert.strictEqual(S.nextMode("???"), "normal"); +assert.strictEqual(S.modeGlyph("repeat_one"), 0xF0458); +assert.strictEqual(S.modeGlyph("???"), 0xF0457); + +assert.strictEqual(S.clock(0), "0:00"); +assert.strictEqual(S.clock(61.9), "1:01"); +assert.strictEqual(S.clock(-3), "0:00"); + +// Cover: a 2000x1000 picture in 480x800 scales to height (0.8), 1600 wide. +let c = S.cover(2000, 1000, 1, 0, 0, 480, 800); +assert.strictEqual(c.scale, 0.8); +assert.strictEqual(c.w, 1600); +assert.strictEqual(c.h, 800); +// Panning is clamped so the frame stays covered. +c = S.cover(2000, 1000, 1, 100, -50, 480, 800); +assert.strictEqual(c.x, 0); +assert.strictEqual(c.y, 0); +c = S.cover(2000, 1000, 1, -5000, 0, 480, 800); +assert.strictEqual(c.x, 480 - 1600); +// Zoom is kept in 1..4. +assert.strictEqual(S.cover(2000, 1000, 0.2, 0, 0, 480, 800).zoom, 1); +assert.strictEqual(S.cover(2000, 1000, 9, 0, 0, 480, 800).zoom, 4); +// Centred: the crop the player itself makes. +c = S.centred(2000, 1000, 480, 800); +assert.strictEqual(c.x, (480 - 1600) / 2); +assert.strictEqual(c.y, 0); +// Zooming at a point keeps that point under the cursor. +c = S.centred(2000, 1000, 480, 800); +const z = S.zoomAt(2000, 1000, c, 2, 240, 400, 480, 800); +assert.strictEqual(z.zoom, 2); +assert.ok(Math.abs((240 - z.x) / z.scale - (240 - c.x) / c.scale) < 1e-9); + +assert.strictEqual(S.stamp(new Date(2026, 10, 7, 9, 5, 3)), "bootlogo-20261107-090503"); + +assert.strictEqual(S.query({ do: "play_path", path: "/mnt/sd_0/a b&c.flac" }), + "do=play_path&path=%2Fmnt%2Fsd_0%2Fa%20b%26c.flac"); + +assert.deepStrictEqual(S.crumbs("/mnt/sd_0", "/mnt/sd_0"), [{ name: "Card", path: "/mnt/sd_0" }]); +assert.deepStrictEqual(S.crumbs("/mnt/sd_0/A/B", "/mnt/sd_0"), [ + { name: "Card", path: "/mnt/sd_0" }, + { name: "A", path: "/mnt/sd_0/A" }, + { name: "B", path: "/mnt/sd_0/A/B" }, +]); +assert.deepStrictEqual(S.crumbs("/elsewhere", "/mnt/sd_0"), [{ name: "Card", path: "/mnt/sd_0" }]); + +assert.strictEqual(S.parentOf("/mnt/sd_0/A/B", "/mnt/sd_0"), "/mnt/sd_0/A"); +assert.strictEqual(S.parentOf("/mnt/sd_0/A", "/mnt/sd_0"), "/mnt/sd_0"); +assert.strictEqual(S.parentOf("/mnt/sd_0", "/mnt/sd_0"), "/mnt/sd_0"); + +assert.strictEqual(S.colour("udt", "#123456"), "#123456"); +assert.strictEqual(S.colour("#e5a50a", "#123456"), "#e5a50a"); + +assert.deepStrictEqual(S.offsetXY("se", 8), { x: 8, y: 8 }); +assert.deepStrictEqual(S.offsetXY("nw", 3), { x: -3, y: -3 }); +assert.deepStrictEqual(S.offsetXY("bogus", 5), { x: 5, y: 5 }); + +console.log("ok"); -- cgit v1.2.3