matterbridge 3.2.6 → 3.2.7-dev-20250908-3bb699e

package/dist/shelly.js

@@ -1,54 +1,13 @@
-/**
- * This file contains the shelly api functions.
- *
- * @file shelly.ts
- * @author Luca Liguori
- * @created 2025-02-19
- * @version 1.1.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
 import { debugStringify } from 'node-ansi-logger';
 import { WS_ID_SHELLY_MAIN_UPDATE, WS_ID_SHELLY_SYS_UPDATE } from './frontend.js';
 let verifyIntervalSecs = 15;
 let verifyTimeoutSecs = 600;
-/**
- * Sets the interval for verification in seconds.
- *
- * @param {number} seconds - The interval in seconds.
- * @returns {void}
- */
 export function setVerifyIntervalSecs(seconds) {
     verifyIntervalSecs = seconds;
 }
-/**
- * Sets the timeout for verification in seconds.
- *
- * @param {number} seconds - The timeout in seconds.
- * @returns {void}
- */
 export function setVerifyTimeoutSecs(seconds) {
     verifyTimeoutSecs = seconds;
 }
-/**
- * Fetches Shelly system updates. If available: logs the result, sends a snackbar message, and broadcasts the message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function getShellySysUpdate(matterbridge) {
     try {
         const updates = (await getShelly('/api/updates/sys/check'));
@@ -67,33 +26,19 @@ export async function getShellySysUpdate(matterbridge) {
         matterbridge.log.error(`Error getting Shelly system updates: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-/**
- * Triggers Shelly system updates.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellySysUpdate(matterbridge) {
     try {
-        // Trigger the update request
         await getShelly('/api/updates/sys/perform');
         matterbridge.log.notice('Installing Shelly system update...');
         matterbridge.matterbridgeInformation.shellySysUpdate = false;
         matterbridge.frontend.wssSendSnackbarMessage('Installing Shelly system update...', 15);
         matterbridge.frontend.wssBroadcastMessage(WS_ID_SHELLY_SYS_UPDATE, 'shelly-sys-update', { available: false });
-        // Begin polling update status
         await verifyShellyUpdate(matterbridge, '/api/updates/sys/status', 'Shelly system update');
     }
     catch (err) {
         matterbridge.log.error(`Error triggering Shelly system update: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-/**
- * Fetches Shelly main updates. If available: logs the result, sends a snackbar message, and broadcasts the message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function getShellyMainUpdate(matterbridge) {
     try {
         const updates = (await getShelly('/api/updates/main/check'));
@@ -112,35 +57,19 @@ export async function getShellyMainUpdate(matterbridge) {
         matterbridge.log.error(`Error getting Shelly main updates: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-/**
- * Triggers Shelly main updates.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellyMainUpdate(matterbridge) {
     try {
-        // Trigger the perform-update request
         await getShelly('/api/updates/main/perform');
         matterbridge.log.notice('Installing Shelly software update...');
         matterbridge.matterbridgeInformation.shellyMainUpdate = false;
         matterbridge.frontend.wssSendSnackbarMessage('Installing Shelly software update...', 15);
         matterbridge.frontend.wssBroadcastMessage(WS_ID_SHELLY_MAIN_UPDATE, 'shelly-main-update', { available: false });
-        // Begin polling the update status
         await verifyShellyUpdate(matterbridge, '/api/updates/main/status', 'Shelly software update');
     }
     catch (err) {
         matterbridge.log.error(`Error triggering Shelly main update: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-/**
- * Verifies Shelly update.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @param {string} api - The api to call: /api/updates/sys/status or /api/updates/main/status
- * @param {string} name - The name of the update.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function verifyShellyUpdate(matterbridge, api, name) {
     return new Promise((resolve) => {
         const timeout = setTimeout(() => {
@@ -148,9 +77,9 @@ export async function verifyShellyUpdate(matterbridge, api, name) {
             matterbridge.frontend.wssSendCloseSnackbarMessage(`${name} in progress...`);
             clearInterval(interval);
             resolve();
-        }, verifyTimeoutSecs * 1000); // 10 minutes
+        }, verifyTimeoutSecs * 1000);
         const interval = setInterval(() => {
-            getShelly(api, 10 * 1000) // 10 seconds
+            getShelly(api, 10 * 1000)
                 .then(async (data) => {
                 if (data.updatingInProgress) {
                     matterbridge.log.debug(`${name} in progress...`);
@@ -173,21 +102,9 @@ export async function verifyShellyUpdate(matterbridge, api, name) {
                 clearTimeout(timeout);
                 resolve();
             });
-        }, verifyIntervalSecs * 1000); // 15 seconds
+        }, verifyIntervalSecs * 1000);
     });
 }
-/**
- * Triggers Shelly change network configuration.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @param {object} config - The network configuration.
- * @param {string} config.type - The type of network configuration, either 'static' or 'dhcp'.
- * @param {string} config.ip - The IP address to set (required for static configuration).
- * @param {string} config.subnet - The subnet mask to set (required for static configuration).
- * @param {string} config.gateway - The gateway to set (required for static configuration).
- * @param {string} config.dns - The DNS server to set (required for static configuration).
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellyChangeIp(matterbridge, config) {
     const api = config.type === 'static' ? '/api/network/connection/static' : '/api/network/connection/dynamic';
     const data = { interface: 'end0' };
@@ -210,12 +127,6 @@ export async function triggerShellyChangeIp(matterbridge, config) {
         matterbridge.frontend.wssSendSnackbarMessage('Error changing Shelly network configuration', 10, 'error');
     }
 }
-/**
- * Triggers Shelly system reboot.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellyReboot(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly system reboot`);
     try {
@@ -233,13 +144,6 @@ export async function triggerShellyReboot(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error rebooting Shelly board', 10, 'error');
     }
 }
-/**
- * Triggers Shelly soft reset.
- * It will replaces network config with the default one (edn0 on dhcp).
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellySoftReset(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly soft reset`);
     try {
@@ -257,13 +161,6 @@ export async function triggerShellySoftReset(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error resetting the network parameters on Shelly board', 10, 'error');
     }
 }
-/**
- * Triggers Shelly hard reset.
- * It will do a hard reset and will remove both directories .matterbridge Matterbridge.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the operation is complete.
- */
 export async function triggerShellyHardReset(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly hard reset`);
     try {
@@ -281,12 +178,6 @@ export async function triggerShellyHardReset(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error while factory resetting the Shelly board', 10, 'error');
     }
 }
-/**
- * Fetches Shelly system log and write it to shelly.log.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<boolean>}  A promise that resolves to true if the log was successfully downloaded, false otherwise.
- */
 export async function createShellySystemLog(matterbridge) {
     const { promises: fs } = await import('node:fs');
     const path = await import('node:path');
@@ -303,28 +194,6 @@ export async function createShellySystemLog(matterbridge) {
         return false;
     }
 }
-/**
- * Perform a GET to Shelly board apis.
- *
- * @param {string} api - The api to call:
- *
- *      /api/updates/sys/check => [{name:string; ...}]
- *      /api/updates/sys/perform => {"updatingInProgress":true} or {"updatingInProgress":false}
- *      /api/updates/sys/status => {"updatingInProgress":true} or {"updatingInProgress":false}
- *      /api/updates/main/check => [{name:string; ...}]
- *      /api/updates/main/perform => {"updatingInProgress":true} or {"updatingInProgress":false}
- *      /api/updates/main/status  => {"updatingInProgress":true} or {"updatingInProgress":false}
- *
- *      /api/logs/system => text
- *
- *      /api/reset/soft => "ok"                 Replaces network config with default one (edn0 on dhcp)
- *      /api/reset/hard => reboot on success    Hard reset makes soft reset + removing both directories .matterbridge Matterbridge + reboot
- *
- *
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 60000ms).
- * @returns {Promise<any>} A promise that resolves to the response.
- * @throws {Error} If the request fails.
- */
 export async function getShelly(api, timeout = 60000) {
     const http = await import('node:http');
     return new Promise((resolve, reject) => {
@@ -338,13 +207,12 @@ export async function getShelly(api, timeout = 60000) {
             let data = '';
             if (res.statusCode !== 200) {
                 clearTimeout(timeoutId);
-                res.resume(); // Discard response data to close the socket properly
-                req.destroy(); // Forcefully close the request
+                res.resume();
+                req.destroy();
                 reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
                 return;
             }
             res.on('data', (chunk) => {
-                // console.log(chunk);
                 data += chunk;
             });
             res.on('end', () => {
@@ -359,7 +227,6 @@ export async function getShelly(api, timeout = 60000) {
                     }
                 }
                 else {
-                    // console.log(data);
                     resolve(data);
                 }
             });
@@ -370,31 +237,6 @@ export async function getShelly(api, timeout = 60000) {
         });
     });
 }
-/**
- * Perform a POST request to Shelly board apis.
- *
- * @param {string} api - The api to call:
- *
- *     Set static ip
- *     /api/network/connection/static -d '{"interface": "end0", "addr": "10.11.12.101", "mask": "255.255.255.0", "gw": "10.11.12.1", "dns": "1.1.1.1"}' => {}
- *
- *     Set dhcp
- *     /api/network/connection/dynamic -d '{"interface": "end0"}' => {}
- *
- *     Reboot
- *     /api/system/reboot => {"success":true}
- *
- *     curl -H "Content-Type: application/json" -X POST http://127.0.0.1:8101/api/network/connection/dynamic
- *        -d '{"interface": "end0"}'
- *
- *     curl -H "Content-Type: application/json" -X POST http://127.0.0.1:8101/api/network/connection/static
- *        -d '{"interface": "end0", "addr": "192.168.1.64", "mask": "255.255.255.0", "gw": "192.168.1.1", "dns": "192.168.1.1"}'
- *
- * @param {any} data - The data to send in the POST request, typically a JSON object.
- * @param {number} [timeout] - The timeout duration in milliseconds (default is 60000ms).
- * @returns {Promise<any>} A promise that resolves to the response.
- * @throws {Error} If the request fails.
- */
 export async function postShelly(api, data, timeout = 60000) {
     const http = await import('node:http');
     return new Promise((resolve, reject) => {
@@ -415,11 +257,10 @@ export async function postShelly(api, data, timeout = 60000) {
         };
         const req = http.request(url, options, (res) => {
             let responseData = '';
-            // Check for non-success status codes (e.g., 300+)
             if (res.statusCode && res.statusCode >= 300) {
                 clearTimeout(timeoutId);
-                res.resume(); // Discard response data to free up memory
-                req.destroy(); // Close the request
+                res.resume();
+                req.destroy();
                 return reject(new Error(`Failed to post data. Status code: ${res.statusCode}`));
             }
             res.on('data', (chunk) => {
@@ -440,9 +281,7 @@ export async function postShelly(api, data, timeout = 60000) {
             clearTimeout(timeoutId);
             reject(new Error(`Request failed: ${error instanceof Error ? error.message : error}`));
         });
-        // Send the JSON data
         req.write(jsonData);
         req.end();
     });
 }
-//# sourceMappingURL=shelly.js.map

package/dist/storage/export.js

@@ -1,2 +1 @@
 export * from 'node-persist-manager';
-//# sourceMappingURL=export.js.map

package/dist/update.js

@@ -1,37 +1,6 @@
-/**
- * This file contains the check updates functions.
- *
- * @file update.ts
- * @author Luca Liguori
- * @created 2025-02-24
- * @version 1.0.0
- * @license Apache-2.0
- *
- * Copyright 2025, 2026, 2027 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-// AnsiLogger module
 import { db, debugStringify, nt, wr } from 'node-ansi-logger';
 import { plg } from './matterbridgeTypes.js';
 import { isValidString } from './utils/isvalid.js';
-/**
- * Checks for updates for Matterbridge and its plugins.
- * If the 'shelly' parameter is present, also checks for Shelly updates.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<void>} A promise that resolves when the update checks are complete.
- */
 export async function checkUpdates(matterbridge) {
     const { hasParameter } = await import('./utils/commandLine.js');
     const update = checkUpdatesAndLog(matterbridge);
@@ -55,12 +24,6 @@ export async function checkUpdates(matterbridge) {
     }
     await Promise.all([update, latestVersion, devVersion, ...pluginsVersions, ...pluginsDevVersions, ...shellyUpdates]);
 }
-/**
- * Checks for updates and logs from GitHub.
- * If the update check fails, logs a warning message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- */
 export async function checkUpdatesAndLog(matterbridge) {
     const { getGitHubUpdate } = await import('./utils/network.js');
     const branch = matterbridge.matterbridgeVersion.includes('-dev-') ? 'dev' : 'main';
@@ -78,13 +41,6 @@ export async function checkUpdatesAndLog(matterbridge) {
         matterbridge.log.debug(`Error checking GitHub ${branch} updates: ${error instanceof Error ? error.message : error}`);
     }
 }
-/**
- * Retrieves the latest version of Matterbridge and updates the matterbridgeLatestVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
- */
 export async function getMatterbridgeLatestVersion(matterbridge) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -104,17 +60,9 @@ export async function getMatterbridgeLatestVersion(matterbridge) {
         return version;
     }
     catch (error) {
-        // logError(matterbridge.log, `Error getting Matterbridge latest version`, error);
         matterbridge.log.warn(`Error getting Matterbridge latest version: ${error instanceof Error ? error.message : error}`);
     }
 }
-/**
- * Retrieves the latest dev version of Matterbridge and updates the matterbridgeDevVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
- */
 export async function getMatterbridgeDevVersion(matterbridge) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -137,14 +85,6 @@ export async function getMatterbridgeDevVersion(matterbridge) {
         matterbridge.log.warn(`Error getting Matterbridge latest dev version: ${error instanceof Error ? error.message : error}`);
     }
 }
-/**
- * Retrieves the latest version of a plugin and updates the plugin's latestVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @param {RegisteredPlugin} plugin - The plugin for which to retrieve the latest version.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
- */
 export async function getPluginLatestVersion(matterbridge, plugin) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -163,14 +103,6 @@ export async function getPluginLatestVersion(matterbridge, plugin) {
         matterbridge.log.warn(`Error getting plugin ${plg}${plugin.name}${wr} latest version: ${error instanceof Error ? error.message : error}`);
     }
 }
-/**
- * Retrieves the latest dev version of a plugin and updates the plugin's devVersion property.
- * If there is an error retrieving the latest version, logs an error message.
- *
- * @param {Matterbridge} matterbridge - The Matterbridge instance.
- * @param {RegisteredPlugin} plugin - The plugin for which to retrieve the latest version.
- * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
- */
 export async function getPluginDevVersion(matterbridge, plugin) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -189,4 +121,3 @@ export async function getPluginDevVersion(matterbridge, plugin) {
         matterbridge.log.debug(`Error getting plugin ${plg}${plugin.name}${db} latest dev version: ${error instanceof Error ? error.message : error}`);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/utils/colorUtils.js

@@ -1,35 +1,4 @@
-/**
- * This file contains the color utilities.
- *
- * @file colorUtils.ts
- * @author Luca Liguori
- * @created 2023-10-05
- * @version 1.3.0
- * @license Apache-2.0
- *
- * Copyright 2023, 2024, 2025 Luca Liguori.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
 import { assert } from 'node:console';
-/**
- * Converts from HSL to RGB color space
- *
- * @param {number} hue - The hue value (0-360).
- * @param {number} saturation - The saturation value (0-100).
- * @param {number} luminance - The luminance value (0-100).
- * @returns {RGB} An object containing the RGB values.
- */
 export function hslColorToRgbColor(hue, saturation, luminance) {
     if (hue === 360) {
         hue = 0;
@@ -41,7 +10,7 @@ export function hslColorToRgbColor(hue, saturation, luminance) {
     luminance /= 100;
     let r, g, b;
     if (saturation === 0) {
-        r = g = b = luminance; // achromatic
+        r = g = b = luminance;
     }
     else {
         const hue2rgb = (p, q, t) => {
@@ -74,54 +43,33 @@ export function hslColorToRgbColor(hue, saturation, luminance) {
         b: Math.ceil(b * 255),
     };
 }
-/**
- * Converts RGB color space to CIE 1931 XY color space
- *
- * @param {RGB} rgb - The RGB color object.
- * @returns {XY} An object containing the x and y values in CIE 1931 XY color space.
- */
 export function rgbColorToXYColor(rgb) {
     let r = rgb.r / 255;
     let g = rgb.g / 255;
     let b = rgb.b / 255;
-    // Apply gamma correction
     r = r > 0.04045 ? Math.pow((r + 0.055) / 1.055, 2.4) : r / 12.92;
     g = g > 0.04045 ? Math.pow((g + 0.055) / 1.055, 2.4) : g / 12.92;
     b = b > 0.04045 ? Math.pow((b + 0.055) / 1.055, 2.4) : b / 12.92;
-    // Scale the values to the D65 illuminant
     r = r * 100;
     g = g * 100;
     b = b * 100;
-    // Convert RGB to XYZ
     const X = r * 0.664511 + g * 0.154324 + b * 0.162028;
     const Y = r * 0.283881 + g * 0.668433 + b * 0.047685;
     const Z = r * 0.000088 + g * 0.07231 + b * 0.986039;
-    // Normalization
     let x = X / (X + Y + Z);
     let y = Y / (X + Y + Z);
-    // Round to 4 digits
     x = Math.round(x * 10000) / 10000;
     y = Math.round(y * 10000) / 10000;
     return { x, y };
 }
-/**
- * Converts CIE 1931 XY color space to RGB color space
- *
- * @param {number} x - The x value in CIE 1931 XY color space.
- * @param {number} y - The y value in CIE 1931 XY color space.
- * @param {number} [brightness] - The brightness value (1-254). Defaults to 254.
- * @returns {RGB} An object containing the RGB values.
- */
 export function xyColorToRgbColor(x, y, brightness = 254) {
     const z = 1.0 - x - y;
     const Y = (brightness / 254).toFixed(2);
     const X = (Number(Y) / y) * x;
     const Z = (Number(Y) / y) * z;
-    // Convert to RGB using Wide RGB D65 conversion
     let red = X * 1.656492 - Number(Y) * 0.354851 - Z * 0.255038;
     let green = -X * 0.707196 + Number(Y) * 1.655397 + Z * 0.036152;
     let blue = X * 0.051713 - Number(Y) * 0.121364 + Z * 1.01153;
-    // If red, green or blue is larger than 1.0 set it back to the maximum of 1.0
     if (red > blue && red > green && red > 1.0) {
         green = green / red;
         blue = blue / red;
@@ -137,40 +85,27 @@ export function xyColorToRgbColor(x, y, brightness = 254) {
         green = green / blue;
         blue = 1.0;
     }
-    // Reverse gamma correction
     red = red <= 0.0031308 ? 12.92 * red : (1.0 + 0.055) * Math.pow(red, 1.0 / 2.4) - 0.055;
     green = green <= 0.0031308 ? 12.92 * green : (1.0 + 0.055) * Math.pow(green, 1.0 / 2.4) - 0.055;
     blue = blue <= 0.0031308 ? 12.92 * blue : (1.0 + 0.055) * Math.pow(blue, 1.0 / 2.4) - 0.055;
-    // Convert normalized decimal to decimal
     red = Math.round(red * 255);
     green = Math.round(green * 255);
     blue = Math.round(blue * 255);
-    // Normalize even if this code should never be reached...
     if (isNaN(red) || red < 0) {
-        /* istanbul ignore next */
         red = 0;
     }
     if (isNaN(green) || green < 0) {
-        /* istanbul ignore next */
         green = 0;
     }
     if (isNaN(blue) || blue < 0) {
-        /* istanbul ignore next */
         blue = 0;
     }
-    // Fix negative zero issue by ensuring we return positive zero
     return {
         r: red === 0 ? 0 : red,
         g: green === 0 ? 0 : green,
         b: blue === 0 ? 0 : blue,
     };
 }
-/**
- *  Converts RGB color space to HSL color space
- *
- * @param {RGB} rgb - The RGB color object.
- * @returns {HSL} An object containing the HSL values.
- */
 export function rgbColorToHslColor(rgb) {
     const r = rgb.r / 255;
     const g = rgb.g / 255;
@@ -180,7 +115,7 @@ export function rgbColorToHslColor(rgb) {
     let h = 0, s = 0;
     const l = (max + min) / 2;
     if (max === min) {
-        h = s = 0; // achromatic
+        h = s = 0;
     }
     else {
         const d = max - min;
@@ -204,46 +139,19 @@ export function rgbColorToHslColor(rgb) {
         l: Math.round(l * 100),
     };
 }
-/**
- * Converts CIE 1931 XY color space to HSL color space
- *
- * @param {number} x - The x value in CIE 1931 XY color space.
- * @param {number} y - The y value in CIE 1931 XY color space.
- * @returns {HSL} An object containing the HSL values.
- */
 export function xyToHsl(x, y) {
     const rgb = xyColorToRgbColor(x, y);
     return rgbColorToHslColor(rgb);
 }
-/**
- * Converts mireds to kelvin.
- *
- * @param {number} mired - The mired value to convert.
- * @returns {number} The converted kelvin value.
- */
 export function miredToKelvin(mired) {
     return Math.round(1000000 / mired);
 }
-/**
- * Converts kelvin to mireds.
- *
- * @param {number} kelvin - The kelvin value to convert.
- * @returns {number} The converted mired value.
- */
 export function kelvinToMired(kelvin) {
     return Math.round(1000000 / kelvin);
 }
-/**
- * Converts kelvin to RGB color space.
- *
- * @param {number} kelvin - The kelvin value to convert (1000K to 40000K).
- * @returns {RGB} An object containing the RGB values.
- */
 export function kelvinToRGB(kelvin) {
-    // Clamp the temperature to the range 1000K to 40000K
     kelvin = Math.max(1000, Math.min(40000, kelvin)) / 100;
     let r, g, b;
-    // Calculate red
     if (kelvin <= 66) {
         r = 255;
     }
@@ -252,7 +160,6 @@ export function kelvinToRGB(kelvin) {
         r = 329.698727446 * Math.pow(r, -0.1332047592);
         r = Math.max(0, Math.min(255, r));
     }
-    // Calculate green
     if (kelvin <= 66) {
         g = kelvin;
         g = 99.4708025861 * Math.log(g) - 161.1195681661;
@@ -263,7 +170,6 @@ export function kelvinToRGB(kelvin) {
         g = 288.1221695283 * Math.pow(g, -0.0755148492);
         g = Math.max(0, Math.min(255, g));
     }
-    // Calculate blue
     if (kelvin >= 66) {
         b = 255;
     }
@@ -277,4 +183,3 @@ export function kelvinToRGB(kelvin) {
     }
     return { r: Math.round(r), g: Math.round(g), b: Math.round(b) };
 }
-//# sourceMappingURL=colorUtils.js.map