kitowall 7.7.0 → 8.0.0

package/dist/cli.js

@@ -199,6 +199,8 @@ Host Setup:
                                           Show local/latest versions for kitowall, kitsune, and rendercore
   host-setup install <id> [--namespace <ns>]
                                           Install, reinstall, or repair one host item
+  host-setup purge [--namespace <ns>] --yes
+                                          Remove kitowall, kitsune, rendercore, configs, services, state, and profiles
 Examples:
   kitowall init --namespace kitowall --apply
   kitowall install-systemd --every 5m
@@ -398,7 +400,17 @@ async function main() {
             process.exitCode = result.ok ? 0 : (result.code || 1);
             return;
         }
-        throw new Error('Usage: host-setup <check dependency <id>|check service <id>|list|versions|install <id>> [--namespace <ns>] [--json]');
+        if (action === 'purge') {
+            if (!args.includes('--yes')) {
+                throw new Error('Usage: host-setup purge [--namespace <ns>] --yes');
+            }
+            const result = await (0, setup_1.purgeSetup)(namespace);
+            if (result.logs.trim())
+                process.stdout.write(result.logs);
+            process.exitCode = result.ok ? 0 : (result.code || 1);
+            return;
+        }
+        throw new Error('Usage: host-setup <check dependency <id>|check service <id>|list|versions|install <id>|purge --yes> [--namespace <ns>] [--json]');
     }
     if (cmd === 'we') {
         const action = cleanOpt(args[1] ?? null);

package/dist/core/config.js

@@ -79,6 +79,7 @@ function defaultConfig() {
     return {
         schemaVersion: exports.CONFIG_SCHEMA_VERSION,
         mode: 'manual',
+        wallpaper_backend: 'auto',
         rotation_interval_seconds: 1800,
         transition: { type: 'center', fps: 60, duration: 0.7 },
         selection: {
@@ -124,6 +125,11 @@ function loadConfig() {
     }
     if (!config.transition)
         config.transition = fallback.transition;
+    if (config.wallpaper_backend !== 'auto' &&
+        config.wallpaper_backend !== 'swww' &&
+        config.wallpaper_backend !== 'awww') {
+        config.wallpaper_backend = fallback.wallpaper_backend;
+    }
     if (!config.packs)
         config.packs = {};
     if (!config.selection)

package/dist/core/configValidator.js

@@ -107,6 +107,12 @@ function validateConfig(config) {
     if (config.mode !== 'manual' && config.mode !== 'rotate') {
         errors.push('mode must be manual|rotate');
     }
+    if (config.wallpaper_backend !== undefined &&
+        config.wallpaper_backend !== 'auto' &&
+        config.wallpaper_backend !== 'swww' &&
+        config.wallpaper_backend !== 'awww') {
+        errors.push('wallpaper_backend must be auto|swww|awww');
+    }
     if (!positiveNumber(config.rotation_interval_seconds)) {
         errors.push('rotation_interval_seconds must be > 0');
     }

package/dist/core/controller.js

@@ -10,7 +10,6 @@ const state_1 = require("./state");
 const history_1 = require("./history");
 const outputs_1 = require("./outputs");
 const localFolder_1 = require("../adapters/localFolder");
-const swww_1 = require("../managers/swww");
 const selector_1 = require("../adapters/selector");
 const cache_1 = require("./cache");
 const fs_1 = __importDefault(require("fs"));
@@ -21,6 +20,7 @@ const reddit_1 = require("../adapters/reddit");
 const wallhaven_1 = require("../adapters/wallhaven");
 const unsplash_1 = require("../adapters/unsplash");
 const staticUrl_1 = require("../adapters/staticUrl");
+const wallpaperBackend_1 = require("./wallpaperBackend");
 class Controller {
     constructor(config, state) {
         this.config = config;
@@ -356,7 +356,7 @@ class Controller {
                 await hydrate(item.path);
             }
         }
-        await (0, swww_1.applySwww)(outputImages, this.config.transition, namespace);
+        await (0, wallpaperBackend_1.applyWallpaperBackend)(this.config, outputImages, namespace);
         const now = Date.now();
         // Commit State B (recents + last_set + anti-growth)
         for (const item of outputImages) {

package/dist/core/doctor.js

@@ -4,6 +4,8 @@ exports.getHealth = getHealth;
 exports.printDoctor = printDoctor;
 // src/core/doctor.ts
 const exec_1 = require("../utils/exec");
+const config_1 = require("./config");
+const wallpaperBackend_1 = require("./wallpaperBackend");
 const ENABLED_STATES = new Set(['enabled', 'enabled-runtime', 'static', 'generated']);
 const ACTIVE_STATES = new Set(['active', 'activating']);
 function toText(out) {
@@ -27,7 +29,7 @@ async function which(cmd) {
 }
 async function systemctlExists(unit) {
     try {
-        await (0, exec_1.run)('systemctl', ['--user', 'cat', unit]);
+        await (0, exec_1.run)('systemctl', ['--user', 'cat', unit], { timeoutMs: 1500 });
         return true;
     }
     catch {
@@ -36,7 +38,7 @@ async function systemctlExists(unit) {
 }
 async function systemctlIsEnabled(unit) {
     try {
-        const out = await (0, exec_1.run)('systemctl', ['--user', 'is-enabled', unit]);
+        const out = await (0, exec_1.run)('systemctl', ['--user', 'is-enabled', unit], { timeoutMs: 1500 });
         const raw = toText(out).trim();
         return { enabled: ENABLED_STATES.has(raw), raw };
     }
@@ -48,7 +50,7 @@ async function systemctlIsEnabled(unit) {
 }
 async function systemctlIsActive(unit) {
     try {
-        const out = await (0, exec_1.run)('systemctl', ['--user', 'is-active', unit]);
+        const out = await (0, exec_1.run)('systemctl', ['--user', 'is-active', unit], { timeoutMs: 1500 });
         const raw = toText(out).trim();
         return { active: ACTIVE_STATES.has(raw), raw };
     }
@@ -100,8 +102,10 @@ async function unitStatus(unit) {
     return st;
 }
 async function swwwNamespaceQuery(namespace) {
+    const backend = await (0, wallpaperBackend_1.resolveWallpaperBackend)((0, config_1.loadConfig)());
+    const info = (0, wallpaperBackend_1.wallpaperBackendInfo)(backend);
     try {
-        await (0, exec_1.run)('swww', ['query', '--namespace', namespace]);
+        await (0, exec_1.run)(info.bin, [...info.queryArgs, '--namespace', namespace]);
         return { ok: true };
     }
     catch (e) {
@@ -110,22 +114,24 @@ async function swwwNamespaceQuery(namespace) {
 }
 async function getHealth(namespace) {
     const hints = [];
+    const backend = await (0, wallpaperBackend_1.resolveWallpaperBackend)((0, config_1.loadConfig)());
+    const backendInfo = (0, wallpaperBackend_1.wallpaperBackendInfo)(backend);
     const deps = {
-        swww: await which('swww'),
-        swwwDaemon: await which('swww-daemon'),
+        swww: await which(backendInfo.bin),
+        swwwDaemon: await which(backendInfo.daemonBin),
         hyprctl: await which('hyprctl'),
         systemctlUser: await which('systemctl'),
     };
     if (!deps.swww)
-        hints.push('Missing dependency: swww');
+        hints.push(`Missing dependency: ${backendInfo.bin}`);
     if (!deps.swwwDaemon)
-        hints.push('Missing dependency: swww-daemon');
+        hints.push(`Missing dependency: ${backendInfo.daemonBin}`);
     if (!deps.hyprctl)
         hints.push('Missing dependency: hyprctl');
     if (!deps.systemctlUser)
         hints.push('Missing dependency: systemctl');
     const units = {
-        swwwDaemonNs: await unitStatus(`swww-daemon@${namespace}.service`),
+        swwwDaemonNs: await unitStatus(`${backendInfo.daemonUnitBase}@${namespace}.service`),
         watch: await unitStatus('kitowall-watch.service'),
         nextService: await unitStatus('kitowall-next.service'),
         nextTimer: await unitStatus('kitowall-next.timer'),
@@ -151,7 +157,7 @@ async function getHealth(namespace) {
     //   solo nos importa que exista
     const swww = await swwwNamespaceQuery(namespace);
     if (!swww.ok)
-        hints.push(`swww query failed for namespace "${namespace}"`);
+        hints.push(`${backendInfo.bin} query failed for namespace "${namespace}"`);
     const depsOk = deps.swww && deps.swwwDaemon && deps.hyprctl && deps.systemctlUser;
     let code;
     if (!deps.swww || !deps.swwwDaemon || !deps.hyprctl || !deps.systemctlUser) {
@@ -179,17 +185,18 @@ async function getHealth(namespace) {
         units.nextTimer.enabled === true &&
         units.nextTimer.active === true &&
         swww.ok;
-    return { ok, code, namespace, deps, units, swww: { namespaceQueryOk: swww.ok, error: swww.error }, hints };
+    return { ok, code, namespace, backend, deps, units, swww: { namespaceQueryOk: swww.ok, error: swww.error }, hints };
 }
 async function printDoctor(namespace) {
     const r = await getHealth(namespace);
     const line = (s) => console.log(s);
     const badge = (b) => (b ? '✅' : '❌');
     line(`kitowall doctor (namespace="${namespace}")`);
+    line(`wallpaper backend: ${r.backend}`);
     line('');
     line('Dependencies:');
-    line(`  ${badge(r.deps.swww)} swww`);
-    line(`  ${badge(r.deps.swwwDaemon)} swww-daemon`);
+    line(`  ${badge(r.deps.swww)} ${r.backend}`);
+    line(`  ${badge(r.deps.swwwDaemon)} ${r.backend}-daemon`);
     line(`  ${badge(r.deps.hyprctl)} hyprctl`);
     line(`  ${badge(r.deps.systemctlUser)} systemctl (--user)`);
     line('');
@@ -206,8 +213,8 @@ async function printDoctor(namespace) {
         line(`  ${badge(isOk)} ${u.name}  (${ex}, ${act}/${sub}, ${en}, ${ac})`);
     }
     line('');
-    line('swww namespace:');
-    line(`  ${badge(r.swww.namespaceQueryOk)} swww query --namespace ${namespace}`);
+    line(`${r.backend} namespace:`);
+    line(`  ${badge(r.swww.namespaceQueryOk)} ${r.backend} query --namespace ${namespace}`);
     if (!r.swww.namespaceQueryOk && r.swww.error)
         line(`  error: ${r.swww.error}`);
     line('');

package/dist/core/init.js

@@ -9,6 +9,7 @@ const exec_1 = require("../utils/exec");
 const config_1 = require("./config");
 const state_1 = require("./state");
 const controller_1 = require("./controller");
+const wallpaperBackend_1 = require("./wallpaperBackend");
 function ensureDir(p) {
     (0, node_fs_1.mkdirSync)(p, { recursive: true });
 }
@@ -16,20 +17,17 @@ function esc(a) {
     // ExecStart=... necesita escapado simple. JSON.stringify funciona bien para espacios/comillas.
     return JSON.stringify(a);
 }
-async function runHostShell(cmd) {
-    return (0, exec_1.run)('sh', ['-lc', cmd]);
-}
 async function hostCmdExists(cmd) {
     try {
-        await runHostShell(`command -v ${cmd} >/dev/null 2>&1`);
+        await (0, exec_1.run)('which', [cmd], { timeoutMs: 1500 });
         return true;
     }
     catch {
         return false;
     }
 }
-async function ensureHostDeps() {
-    const required = ['swww', 'swww-daemon', 'hyprctl'];
+async function ensureHostDeps(wallpaperBackend) {
+    const required = [wallpaperBackend.bin, wallpaperBackend.daemonBin, 'hyprctl'];
     const missing = [];
     for (const dep of required) {
         if (!(await hostCmdExists(dep)))
@@ -38,17 +36,22 @@ async function ensureHostDeps() {
     if (missing.length === 0)
         return;
     const pkgSet = new Set();
-    if (missing.includes('swww') || missing.includes('swww-daemon'))
-        pkgSet.add('swww');
+    if (missing.includes(wallpaperBackend.bin) || missing.includes(wallpaperBackend.daemonBin)) {
+        pkgSet.add(wallpaperBackend.packageName);
+    }
     if (missing.includes('hyprctl'))
         pkgSet.add('hyprland');
     const packages = Array.from(pkgSet);
     // Best effort auto-install on Arch host; if it fails, we keep a clear actionable error.
     if (packages.length > 0 && await hostCmdExists('pacman')) {
-        const pkgArgs = packages.join(' ');
-        await runHostShell(`if command -v sudo >/dev/null 2>&1; then ` +
-            `(sudo -n pacman -S --needed --noconfirm ${pkgArgs} || sudo pacman -S --needed ${pkgArgs}); ` +
-            `else pacman -S --needed ${pkgArgs}; fi`).catch(() => { });
+        if (await hostCmdExists('sudo')) {
+            await (0, exec_1.run)('sudo', ['-n', 'pacman', '-S', '--needed', '--noconfirm', ...packages]).catch(async () => {
+                await (0, exec_1.run)('sudo', ['pacman', '-S', '--needed', ...packages]).catch(() => { });
+            });
+        }
+        else {
+            await (0, exec_1.run)('pacman', ['-S', '--needed', ...packages]).catch(() => { });
+        }
     }
     const stillMissing = [];
     for (const dep of required) {
@@ -57,7 +60,7 @@ async function ensureHostDeps() {
     }
     if (stillMissing.length > 0) {
         throw new Error(`Missing host dependencies: ${stillMissing.join(', ')}. ` +
-            `Install on host (Arch): sudo pacman -S --needed swww hyprland`);
+            `Install on host (Arch): sudo pacman -S --needed ${wallpaperBackend.packageName} hyprland`);
     }
 }
 async function disableIfExists(unit) {
@@ -68,6 +71,8 @@ async function detectAndHandleConflicts(force) {
     // Conflictos directos con swww (estos sí o sí)
     await disableIfExists('swww.service');
     await disableIfExists('swww-daemon.service');
+    await disableIfExists('awww.service');
+    await disableIfExists('awww-daemon.service');
     // Otros gestores de wallpaper (solo si force)
     if (!force)
         return;
@@ -85,10 +90,11 @@ async function detectAndHandleConflicts(force) {
 async function initKitowall(opts) {
     const config = (0, config_1.loadConfig)(); // crea/migra config si hace falta
     const state = (0, state_1.loadState)(); // crea/migra state si hace falta
+    const wallpaperBackend = (0, wallpaperBackend_1.wallpaperBackendInfo)(await (0, wallpaperBackend_1.resolveWallpaperBackend)(config));
     const ns = (opts.namespace && opts.namespace.trim()) ? opts.namespace.trim() : 'kitowall';
     const force = !!opts.force;
     // Validaciones mínimas
-    await ensureHostDeps();
+    await ensureHostDeps(wallpaperBackend);
     // Apagar servicios que pisan el wallpaper
     await detectAndHandleConflicts(force);
     const userDir = (0, node_path_1.join)((0, node_os_1.homedir)(), '.config', 'systemd', 'user');
@@ -110,10 +116,10 @@ async function initKitowall(opts) {
     const waylandBootstrap = 'WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-$(ls \\"$XDG_RUNTIME_DIR\\"/wayland-* 2>/dev/null | xargs -r -n1 basename | sort | tail -n1)}"; ' +
         'if [ -z "$WAYLAND_DISPLAY" ]; then WAYLAND_DISPLAY=wayland-1; fi; ' +
         'export WAYLAND_DISPLAY;';
-    // 1) swww-daemon template
+    // 1) wallpaper daemon template
     const swwwDaemonTemplate = `
 [Unit]
-Description=swww wallpaper daemon (namespace %i)
+Description=${wallpaperBackend.daemonBin} wallpaper daemon (namespace %i)
 After=graphical-session.target
 Wants=graphical-session.target
 
@@ -121,22 +127,22 @@ Wants=graphical-session.target
 Type=simple
 Environment=PATH=${pathEnv}
 Environment=XDG_RUNTIME_DIR=${xdgRuntimeDir}
-ExecStart=/bin/sh -lc ${esc(`${waylandBootstrap} exec swww-daemon --no-cache --namespace %i`)}
+ExecStart=/bin/sh -lc ${esc(`${waylandBootstrap} exec ${wallpaperBackend.daemonBin} --no-cache --namespace %i${wallpaperBackend.name === 'awww' ? ' --layer background' : ''}`)}
 Restart=on-failure
 RestartSec=1
 
 [Install]
 WantedBy=default.target
 `.trimStart();
-    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(userDir, 'swww-daemon@.service'), swwwDaemonTemplate, 'utf8');
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(userDir, `${wallpaperBackend.daemonUnitBase}@.service`), swwwDaemonTemplate, 'utf8');
     // 2) kitowall-next.service (oneshot)
     // OJO: aunque CLI ignore --namespace en algunos comandos, aquí lo dejamos por compatibilidad.
     const nextExec = `/bin/sh -lc ${esc(`${waylandBootstrap} exec ${cliInvoke} next --namespace ${JSON.stringify(ns)}`)}`;
     const kitowallNextService = `
 [Unit]
 Description=Kitowall apply next wallpapers
-After=swww-daemon@${ns}.service
-Requires=swww-daemon@${ns}.service
+After=${wallpaperBackend.daemonUnitBase}@${ns}.service
+Requires=${wallpaperBackend.daemonUnitBase}@${ns}.service
 
 [Service]
 Type=oneshot
@@ -150,8 +156,8 @@ ExecStart=${nextExec}
     const kitowallWatchService = `
 [Unit]
 Description=Kitowall watcher (monitor hotplug)
-After=graphical-session.target swww-daemon@${ns}.service
-Requires=swww-daemon@${ns}.service
+After=graphical-session.target ${wallpaperBackend.daemonUnitBase}@${ns}.service
+Requires=${wallpaperBackend.daemonUnitBase}@${ns}.service
 Wants=graphical-session.target
 
 [Service]
@@ -171,8 +177,8 @@ WantedBy=default.target
     const kitowallLoginApplyService = `
 [Unit]
 Description=Kitowall apply wallpapers on session start
-After=graphical-session.target swww-daemon@${ns}.service
-Requires=swww-daemon@${ns}.service
+After=graphical-session.target ${wallpaperBackend.daemonUnitBase}@${ns}.service
+Requires=${wallpaperBackend.daemonUnitBase}@${ns}.service
 Wants=graphical-session.target
 
 [Service]
@@ -187,7 +193,7 @@ WantedBy=default.target
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(userDir, 'kitowall-login-apply.service'), kitowallLoginApplyService, 'utf8');
     // Activación
     await (0, exec_1.run)('systemctl', ['--user', 'daemon-reload']);
-    await (0, exec_1.run)('systemctl', ['--user', 'enable', '--now', `swww-daemon@${ns}.service`]);
+    await (0, exec_1.run)('systemctl', ['--user', 'enable', '--now', `${wallpaperBackend.daemonUnitBase}@${ns}.service`]);
     await (0, exec_1.run)('systemctl', ['--user', 'enable', '--now', 'kitowall-watch.service']);
     // login-apply is oneshot and can fail on first run if library is still empty.
     // Enable it for next graphical session, but do not make init fail here.

package/dist/core/outputs.js

@@ -46,6 +46,36 @@ async function outputsFromSwwwQuery() {
     }
     return outputs;
 }
+function outputNamesFromUnknown(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap(item => {
+            if (typeof item === 'string' && item.trim())
+                return [{ name: item.trim() }];
+            if (item && typeof item === 'object') {
+                const candidate = item;
+                const name = [candidate.name, candidate.output, candidate.output_name]
+                    .find(entry => typeof entry === 'string' && String(entry).trim().length > 0);
+                if (typeof name === 'string')
+                    return [{ name: name.trim() }];
+            }
+            return [];
+        });
+    }
+    if (value && typeof value === 'object') {
+        const obj = value;
+        if (Array.isArray(obj.outputs))
+            return outputNamesFromUnknown(obj.outputs);
+        return Object.keys(obj)
+            .filter(key => key.trim().length > 0)
+            .map(name => ({ name }));
+    }
+    return [];
+}
+async function outputsFromAwwwQuery() {
+    const result = await (0, exec_1.run)('awww', ['query', '--json']);
+    const parsed = JSON.parse(result.stdout);
+    return outputNamesFromUnknown(parsed);
+}
 async function detectOutputs() {
     try {
         const outputs = await outputsFromHyprctl();
@@ -63,6 +93,14 @@ async function detectOutputs() {
     catch {
         // ignore and fallback
     }
+    try {
+        const outputs = await outputsFromAwwwQuery();
+        if (outputs.length > 0)
+            return outputs;
+    }
+    catch {
+        // ignore
+    }
     try {
         const outputs = await outputsFromSwwwQuery();
         if (outputs.length > 0)

package/dist/core/setup.js

@@ -7,6 +7,7 @@ exports.checkSetupService = checkSetupService;
 exports.listSetupStatus = listSetupStatus;
 exports.listSetupVersions = listSetupVersions;
 exports.installSetupItem = installSetupItem;
+exports.purgeSetup = purgeSetup;
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
@@ -19,8 +20,8 @@ exports.HOST_DEPENDENCY_DEFS = [
     { id: 'kitowall', bin: 'kitowall', label: 'Kitowall CLI', installer: 'kitowall-only' },
     { id: 'kitsune', bin: 'kitsune', label: 'Kitsune', installer: 'kitsune-only' },
     { id: 'kitsune-rendercore', bin: 'kitsune-rendercore', label: 'Kitsune RenderCore', installer: 'kitsune-only' },
-    { id: 'swww', bin: 'swww', label: 'swww', installer: 'swww', system: true },
-    { id: 'swww-daemon', bin: 'swww-daemon', label: 'swww-daemon', installer: 'swww-daemon', system: true },
+    { id: 'awww', bin: 'awww', label: 'awww', installer: 'awww', system: true },
+    { id: 'awww-daemon', bin: 'awww-daemon', label: 'awww-daemon', installer: 'awww-daemon', system: true },
     { id: 'hyprctl', bin: 'hyprctl', label: 'hyprctl', installer: 'hyprctl', system: true },
     { id: 'cava', bin: 'cava', label: 'cava', installer: 'cava', system: true }
 ];
@@ -32,6 +33,13 @@ exports.HOST_SERVICE_DEFS = [
 function homeDir() {
     return process.env.HOME || (0, node_os_1.homedir)();
 }
+function normalizeSetupDependencyId(id) {
+    if (id === 'swww')
+        return 'awww';
+    if (id === 'swww-daemon')
+        return 'awww-daemon';
+    return id;
+}
 async function fileExists(targetPath) {
     try {
         await node_fs_1.promises.access(targetPath);
@@ -140,6 +148,11 @@ function bootstrapHostPath() {
 function bootstrapSystemPath() {
     return (0, node_path_1.join)(ROOT_DIR, 'scripts', 'bootstrap-system.sh');
 }
+async function assertBootstrapScriptExists(targetPath, label) {
+    if (await fileExists(targetPath))
+        return;
+    throw new Error(`${label} not found at ${targetPath}. Reinstala el CLI con: npm i -g --prefix ~/.local kitowall@latest`);
+}
 async function bootstrapVersionsPath() {
     return (0, node_path_1.join)(homeDir(), '.local', 'share', 'kitowall', 'bootstrap-versions.json');
 }
@@ -252,7 +265,7 @@ async function maybeSystemctlShow(unit, props) {
     }
 }
 async function checkSetupDependency(id) {
-    const def = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === id);
+    const def = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === normalizeSetupDependencyId(id));
     if (!def)
         throw new Error(`Unknown dependency id: ${id}`);
     let binPath = '';
@@ -365,7 +378,9 @@ async function listSetupVersions() {
     return { ok: true, items };
 }
 async function runBootstrapHostMode(mode) {
-    const out = await (0, exec_1.run)('bash', [bootstrapHostPath()], {
+    const scriptPath = bootstrapHostPath();
+    await assertBootstrapScriptExists(scriptPath, 'bootstrap-host.sh');
+    const out = await (0, exec_1.run)('bash', [scriptPath], {
         env: {
             ...process.env,
             HOME: homeDir(),
@@ -377,7 +392,9 @@ async function runBootstrapHostMode(mode) {
     return { ok: true, code: out.code, logs: `${out.stdout}${out.stderr}` };
 }
 async function runBootstrapSystemItems(ids) {
-    const out = await (0, exec_1.run)('pkexec', ['bash', bootstrapSystemPath(), ...ids], {
+    const scriptPath = bootstrapSystemPath();
+    await assertBootstrapScriptExists(scriptPath, 'bootstrap-system.sh');
+    const out = await (0, exec_1.run)('pkexec', ['bash', scriptPath, ...ids], {
         env: {
             ...process.env,
             HOME: homeDir(),
@@ -387,21 +404,95 @@ async function runBootstrapSystemItems(ids) {
     return { ok: true, code: out.code, logs: `${out.stdout}${out.stderr}` };
 }
 async function installSetupItem(id, namespace = 'kitowall') {
-    const dep = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === id);
+    const normalizedId = normalizeSetupDependencyId(id);
+    const dep = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === normalizedId);
     if (dep?.system)
-        return await runBootstrapSystemItems([id]);
-    if (id === 'kitowall')
+        return await runBootstrapSystemItems([normalizedId]);
+    if (normalizedId === 'kitowall')
         return await runBootstrapHostMode('kitowall-only');
-    if (id === 'kitsune' || id === 'kitsune-rendercore' || id === 'kitsune-rendercore.service') {
+    if (normalizedId === 'kitsune' || normalizedId === 'kitsune-rendercore' || normalizedId === 'kitsune-rendercore.service') {
         return await runBootstrapHostMode('kitsune-only');
     }
-    if (id === 'kitowall-config') {
+    if (normalizedId === 'kitowall-config') {
         await (0, init_1.initKitowall)({ namespace, apply: true, force: true });
         return { ok: true, code: 0, logs: JSON.stringify({ ok: true, init: true, namespace }, null, 2) };
     }
-    if (id === 'kitowall-next.timer') {
+    if (normalizedId === 'kitowall-next.timer') {
         await (0, systemd_1.installSystemd)({ every: '600s' });
         return { ok: true, code: 0, logs: JSON.stringify({ ok: true, installed: true, every: '600s' }, null, 2) };
     }
     throw new Error(`Unsupported setup item: ${id}`);
 }
+async function rmIfExists(targetPath, logs) {
+    if (!(await fileExists(targetPath)))
+        return;
+    await node_fs_1.promises.rm(targetPath, { recursive: true, force: true });
+    logs.push(`[removed] ${targetPath}`);
+}
+async function runSystemctlUserBestEffort(args, logs) {
+    try {
+        await (0, exec_1.run)('systemctl', ['--user', ...args], {
+            env: {
+                ...process.env,
+                HOME: homeDir(),
+                PATH: hostPathEntries().join(':')
+            },
+            timeoutMs: 4000
+        });
+        logs.push(`[systemctl] ${args.join(' ')}`);
+    }
+    catch (err) {
+        logs.push(`[systemctl-warn] ${args.join(' ')} :: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function purgeSetup(namespace = 'kitowall') {
+    const home = homeDir();
+    const logs = [];
+    const removeTargets = [
+        (0, node_path_1.join)(home, '.config', 'kitowall'),
+        (0, node_path_1.join)(home, '.local', 'share', 'kitowall'),
+        (0, node_path_1.join)(home, '.local', 'state', 'kitowall'),
+        (0, node_path_1.join)(home, '.config', 'kitsune'),
+        (0, node_path_1.join)(home, '.local', 'share', 'kitsune'),
+        (0, node_path_1.join)(home, '.local', 'state', 'kitsune'),
+        (0, node_path_1.join)(home, '.config', 'kitsune-rendercore'),
+        (0, node_path_1.join)(home, '.local', 'lib', 'node_modules', 'kitowall'),
+        (0, node_path_1.join)(home, '.npm-global', 'lib', 'node_modules', 'kitowall')
+    ];
+    const removeFiles = [
+        (0, node_path_1.join)(home, '.local', 'bin', 'kitowall'),
+        (0, node_path_1.join)(home, '.local', 'bin', 'kitsune'),
+        (0, node_path_1.join)(home, '.local', 'bin', 'kitsune-overlay'),
+        (0, node_path_1.join)(home, '.local', 'bin', 'kitsune-color-resolve'),
+        (0, node_path_1.join)(home, '.local', 'bin', 'kitsune-rendercore'),
+        (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune'),
+        (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune-overlay'),
+        (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune-color-resolve'),
+        (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune-rendercore'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitowall-next.service'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitowall-next.timer'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitowall-watch.service'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitowall-login-apply.service'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitsune-rendercore.service'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'awww-daemon@.service'),
+        (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'swww-daemon@.service')
+    ];
+    logs.push(`[purge] namespace=${namespace}`);
+    await runSystemctlUserBestEffort(['disable', '--now', `awww-daemon@${namespace}.service`], logs);
+    await runSystemctlUserBestEffort(['disable', '--now', `swww-daemon@${namespace}.service`], logs);
+    await runSystemctlUserBestEffort(['disable', '--now', 'kitowall-next.timer'], logs);
+    await runSystemctlUserBestEffort(['stop', 'kitowall-next.service'], logs);
+    await runSystemctlUserBestEffort(['disable', '--now', 'kitowall-watch.service'], logs);
+    await runSystemctlUserBestEffort(['disable', '--now', 'kitowall-login-apply.service'], logs);
+    await runSystemctlUserBestEffort(['disable', '--now', 'kitsune-rendercore.service'], logs);
+    await runSystemctlUserBestEffort(['daemon-reload'], logs);
+    await runSystemctlUserBestEffort(['reset-failed', `awww-daemon@${namespace}.service`, `swww-daemon@${namespace}.service`, 'kitowall-next.service', 'kitowall-next.timer', 'kitowall-watch.service', 'kitowall-login-apply.service', 'kitsune-rendercore.service'], logs);
+    for (const targetPath of removeFiles) {
+        await rmIfExists(targetPath, logs);
+    }
+    for (const targetPath of removeTargets) {
+        await rmIfExists(targetPath, logs);
+    }
+    logs.push('[ok] purge complete');
+    return { ok: true, code: 0, logs: `${logs.join('\n')}\n` };
+}

package/dist/core/wallpaperBackend.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wallpaperBackendInfo = wallpaperBackendInfo;
+exports.hostCmdExists = hostCmdExists;
+exports.resolveWallpaperBackend = resolveWallpaperBackend;
+exports.applyWallpaperBackend = applyWallpaperBackend;
+const exec_1 = require("../utils/exec");
+const awww_1 = require("../managers/awww");
+const swww_1 = require("../managers/swww");
+function wallpaperBackendInfo(name) {
+    if (name === 'awww') {
+        return {
+            name,
+            bin: 'awww',
+            daemonBin: 'awww-daemon',
+            daemonUnitBase: 'awww-daemon',
+            packageName: 'awww',
+            queryArgs: ['query', '--json']
+        };
+    }
+    return {
+        name,
+        bin: 'swww',
+        daemonBin: 'swww-daemon',
+        daemonUnitBase: 'swww-daemon',
+        packageName: 'swww',
+        queryArgs: ['query']
+    };
+}
+async function hostCmdExists(cmd) {
+    try {
+        await (0, exec_1.run)('which', [cmd], { timeoutMs: 1500 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveWallpaperBackend(config) {
+    const preferred = config?.wallpaper_backend ?? 'auto';
+    if (preferred === 'awww' || preferred === 'swww')
+        return preferred;
+    if (await hostCmdExists('awww'))
+        return 'awww';
+    if (await hostCmdExists('swww'))
+        return 'swww';
+    return 'awww';
+}
+async function applyWallpaperBackend(config, images, namespace = 'kitowall') {
+    const backend = await resolveWallpaperBackend(config);
+    if (backend === 'awww') {
+        await (0, awww_1.applyAwww)(images, config.transition, namespace);
+    }
+    else {
+        await (0, swww_1.applySwww)(images, config.transition, namespace);
+    }
+    return backend;
+}