@mxtommy/kip 3.10.0-beta.4 → 3.10.0-beta.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxtommy/kip",
-  "version": "3.10.0-beta.4",
+  "version": "3.10.0-beta.40",
   "description": "An advanced and versatile marine instrumentation package to display Signal K data.",
   "license": "MIT",
   "author": {
@@ -25,6 +25,7 @@
   "keywords": [
     "signalk-webapp",
     "signalk-category-instruments",
+    "signalk-category-notifications",
     "signalk-node-server-plugin",
     "signal k",
     "signalk",
@@ -46,7 +47,7 @@
     "build:plugin": "tsc -p ./kip-plugin/tsconfig.plugin.json",
     "build:dev": "ng build --configuration=dev",
     "build:prod": "ng build --configuration=production",
-    "build:all": "npm run build:prod && npm run build:plugin",
+    "build:all": "npm run build:plugin && npm run build:prod",
     "e2e": "ng e2e"
   },
   "devDependencies": {

package/plugin/index.js

@@ -1,47 +1,255 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = (app) => {
+const server_api_1 = require("@signalk/server-api");
+const openapi = __importStar(require("./openApi.json"));
+exports.default = (server) => {
+    const API_PATHS = {
+        DISPLAYS: `/displays`,
+        INSTANCE: `/displays/:displayId`,
+        ACTIVE_SCREEN: `/displays/:displayId/activeScreen`
+    };
+    // Helpers
+    function getDisplaySelfPath(displayId, suffix) {
+        const tail = suffix ? `.${suffix}` : '';
+        const want = `displays.${displayId}${tail}`;
+        const full = server.getSelfPath(want);
+        server.debug(`getDisplaySelfPath: displayId: ${displayId}, suffix: ${suffix}, want=${want}, fullPath=${full}`);
+        return full;
+    }
+    function getAvailableDisplays() {
+        const fullPath = server.getSelfPath('displays');
+        server.debug(`getAvailableDisplays: fullPath=${JSON.stringify(fullPath)}`);
+        return server.getPath('vessels.self.displays');
+    }
+    function pathToDotNotation(path) {
+        const dottedPath = path.replace(/\//g, '.').replace(/^\./, '');
+        server.debug(`pathToDotNotation: input path=${path}, dottedPath=${dottedPath}`);
+        return dottedPath;
+    }
+    function sendOk(res, body) {
+        if (body === undefined)
+            return res.status(204).end();
+        return res.status(200).json(body);
+    }
+    function sendFail(res, statusCode, message) {
+        return res.status(statusCode).json({ state: 'FAILED', statusCode, message });
+    }
     const plugin = {
         id: 'kip',
         name: 'KIP',
         description: 'KIP server plugin',
         start: (settings) => {
-            app.debug(`${plugin.name}: Starting plugin with settings: ${JSON.stringify(settings)}`);
-            app.registerPutHandler('vessels.self', 'plugins.displays.*', displayPutHandler);
+            server.debug(`Starting plugin with settings: ${JSON.stringify(settings)}`);
+            server.setPluginStatus(`Starting...`);
         },
         stop: () => {
-            app.debug(`${plugin.name}: Stopping plugin`);
+            server.debug(`Stopping plugin`);
+            const msg = 'Stopped.';
+            server.setPluginStatus(msg);
         },
         schema: () => {
             return {
                 type: "object",
                 properties: {}
             };
-        }
-    };
-    function displayPutHandler(context, path, value) {
-        app.debug(`${plugin.name}: PUT handler called for context ${context}, path ${path}, value ${value}`);
-        try {
-            const delta = {
-                updates: [
-                    {
-                        values: [
+        },
+        registerWithRouter(router) {
+            server.debug(`Registering plugin routes: ${API_PATHS.DISPLAYS}, ${API_PATHS.INSTANCE}, ${API_PATHS.ACTIVE_SCREEN}`);
+            // Validate/normalize :displayId where present
+            router.param('displayId', (req, res, next, displayId) => {
+                if (displayId == null)
+                    return sendFail(res, 400, 'Missing displayId parameter');
+                try {
+                    let id = String(displayId);
+                    // Decode percent-encoding if present
+                    try {
+                        id = decodeURIComponent(id);
+                    }
+                    catch {
+                        // ignore decode errors, keep original id
+                    }
+                    // If someone sent JSON as the path segment, try to recover {"displayId":"..."}
+                    if (id.trim().startsWith('{')) {
+                        try {
+                            const parsed = JSON.parse(id);
+                            if (parsed && typeof parsed.displayId === 'string') {
+                                id = parsed.displayId;
+                            }
+                            else {
+                                return sendFail(res, 400, 'Invalid displayId format in JSON');
+                            }
+                        }
+                        catch {
+                            return sendFail(res, 400, 'Invalid displayId JSON');
+                        }
+                    }
+                    // Basic safety: allow UUID-like strings (alphanum + dash)
+                    if (!/^[A-Za-z0-9-]+$/.test(id)) {
+                        return sendFail(res, 400, 'Invalid displayId format');
+                    }
+                    req.displayId = id;
+                    next();
+                }
+                catch {
+                    return sendFail(res, 400, 'Missing or invalid displayId parameter');
+                }
+            });
+            router.put(`${API_PATHS.INSTANCE}`, async (req, res) => {
+                server.debug(`** PUT ${API_PATHS.INSTANCE}. Params: ${JSON.stringify(req.params)} Body: ${JSON.stringify(req.body)}`);
+                try {
+                    const dottedPath = pathToDotNotation(req.path);
+                    server.debug(`Updating SK path ${dottedPath}`);
+                    server.handleMessage(plugin.id, {
+                        updates: [
                             {
-                                path: path,
-                                value: value
+                                values: [
+                                    {
+                                        path: dottedPath,
+                                        value: req.body ?? null
+                                    }
+                                ]
                             }
                         ]
+                    }, server_api_1.SKVersion.v1);
+                    return res.status(200).json({ state: 'SUCCESS', statusCode: 200 });
+                }
+                catch (error) {
+                    const msg = `HandleMessage failed with errors!`;
+                    server.setPluginError(msg);
+                    server.error(`Error in HandleMessage: ${error}`);
+                    return sendFail(res, 400, error.message);
+                }
+            });
+            router.put(`${API_PATHS.ACTIVE_SCREEN}`, async (req, res) => {
+                server.debug(`** PUT ${API_PATHS.ACTIVE_SCREEN}. Params: ${JSON.stringify(req.params)} Body: ${JSON.stringify(req.body)}`);
+                try {
+                    const dottedPath = pathToDotNotation(req.path);
+                    server.debug(`Updating SK path ${dottedPath} with body.screenIdx`);
+                    server.handleMessage(plugin.id, {
+                        updates: [
+                            {
+                                values: [
+                                    {
+                                        path: dottedPath,
+                                        value: req.body.screenIdx !== undefined ? req.body.screenIdx : null
+                                    }
+                                ]
+                            }
+                        ]
+                    }, server_api_1.SKVersion.v1);
+                    return res.status(200).json({ state: 'SUCCESS', statusCode: 200 });
+                }
+                catch (error) {
+                    const msg = `HandleMessage failed with errors!`;
+                    server.setPluginError(msg);
+                    server.error(`Error in HandleMessage: ${error}`);
+                    return sendFail(res, 400, error.message);
+                }
+            });
+            router.get(API_PATHS.DISPLAYS, (req, res) => {
+                server.debug(`** GET ${API_PATHS.DISPLAYS}. Params: ${JSON.stringify(req.params)}`);
+                try {
+                    const displays = getAvailableDisplays();
+                    const items = displays && typeof displays === 'object'
+                        ? Object.entries(displays)
+                            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                            .filter(([_, v]) => v && typeof v === 'object')
+                            .map(([displayId, v]) => ({
+                            displayId,
+                            displayName: v.displayName ?? null
+                        }))
+                        : [];
+                    server.debug(`getAvailableDisplays returned: ${JSON.stringify(displays)}`);
+                    server.debug(`Found ${items.length} displays: ${JSON.stringify(items)}`);
+                    return res.status(200).json(items);
+                }
+                catch (error) {
+                    server.error(`Error reading displays: ${String(error.message || error)}`);
+                    return sendFail(res, 400, error.message);
+                }
+            });
+            router.get(`${API_PATHS.INSTANCE}`, (req, res) => {
+                server.debug(`** GET ${API_PATHS.INSTANCE}. Params: ${JSON.stringify(req.params)}`);
+                try {
+                    const displayId = req.displayId;
+                    if (!displayId) {
+                        return sendFail(res, 400, 'Missing displayId parameter');
                     }
-                ]
-            };
-            app.debug(`${plugin.name}: Sending message: `, JSON.stringify(delta));
-            app.handleMessage(plugin.id, delta);
-            return { state: "COMPLETED", statusCode: 200 };
-        }
-        catch (error) {
-            app.error(`${plugin.name}: Error in PUT handler: ${error}`);
-            return { state: "COMPLETED", statusCode: 500, message: error.message };
-        }
-    }
+                    const fullPath = getDisplaySelfPath(displayId);
+                    const value = server.getPath(fullPath);
+                    if (value === undefined) {
+                        return sendFail(res, 404, `Display ${displayId} not found`);
+                    }
+                    return sendOk(res, value);
+                }
+                catch (error) {
+                    server.error(`Error reading display ${req.params?.displayId}: ${String(error.message || error)}`);
+                    return sendFail(res, 400, error.message);
+                }
+            });
+            router.get(`${API_PATHS.ACTIVE_SCREEN}`, (req, res) => {
+                server.debug(`** GET ${API_PATHS.ACTIVE_SCREEN}. Params: ${JSON.stringify(req.params)}`);
+                try {
+                    const displayId = req.displayId;
+                    if (!displayId) {
+                        return sendFail(res, 400, 'Missing displayId parameter');
+                    }
+                    const fullPath = getDisplaySelfPath(displayId, 'activeScreen');
+                    const value = server.getPath(fullPath);
+                    if (value === undefined) {
+                        return sendFail(res, 404, `Active screen for display ${displayId} not found`);
+                    }
+                    return sendOk(res, value);
+                }
+                catch (error) {
+                    server.error(`Error reading activeScreen for ${req.params?.displayId}: ${String(error.message || error)}`);
+                    return sendFail(res, 400, error.message);
+                }
+            });
+            // List all registered routes for debugging
+            if (router.stack) {
+                router.stack.forEach((layer) => {
+                    if (layer.route && layer.route.path) {
+                        server.debug(`Registered route: ${layer.route.stack[0].method.toUpperCase()} ${layer.route.path}`);
+                    }
+                });
+            }
+            server.setPluginStatus(`Providing remote display screen control`);
+        },
+        getOpenApi: () => openapi
+    };
     return plugin;
 };

package/plugin/openApi.json

@@ -0,0 +1,141 @@
+{
+    "openapi": "3.0.0",
+    "info": {
+        "version": "1.0.0",
+        "title": "KIP Remote Displays API",
+        "description": "API endpoints to list KIP displays and control the active screen for a given KIP instance via Signal K self.displays tree.\n\nUsage:\n- List displays:\n  curl -s http://localhost:3000/plugins/kip/displays\n- Read a display entry:\n  curl -s http://localhost:3000/plugins/kip/displays/{displayId}\n- Set a display entry:\n  curl -s -X PUT -H 'Content-Type: application/json' -d '{\"displayName\":\"Mast\"}' http://localhost:3000/plugins/kip/displays/{displayId}\n- Get active screen:\n  curl -s http://localhost:3000/plugins/kip/displays/{displayId}/activeScreen\n- Set active screen:\n  curl -s -X PUT -H 'Content-Type: application/json' -d '{\"screenIdx\":1}' http://localhost:3000/plugins/kip/displays/{displayId}/activeScreen",
+        "termsOfService": "http://signalk.org/terms/",
+        "license": {
+            "name": "Apache 2.0",
+            "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+        }
+    },
+    "externalDocs": {
+        "url": "http://signalk.org/specification/",
+        "description": "Signal K specification."
+    },
+    "servers": [
+        { "url": "/" }
+    ],
+    "tags": [
+        { "name": "Displays", "description": "KIP display discovery and control." }
+    ],
+    "components": {
+        "schemas": {
+            "DisplayInfo": {
+                "type": "object",
+                "properties": {
+                    "displayId": { "type": "string", "description": "KIP instance UUID" },
+                    "displayName": { "type": "string", "nullable": true }
+                },
+                "required": ["displayId"]
+            },
+            "SuccessResponse": {
+                "type": "object",
+                "properties": {
+                    "state": { "type": "string", "enum": ["SUCCESS"] },
+                    "statusCode": { "type": "integer", "enum": [200] }
+                },
+                "required": ["state", "statusCode"]
+            },
+            "ErrorResponse": {
+                "type": "object",
+                "properties": {
+                    "state": { "type": "string", "enum": ["FAILED"] },
+                    "statusCode": { "type": "integer" },
+                    "message": { "type": "string" }
+                },
+                "required": ["state", "statusCode", "message"]
+            },
+            "ActiveScreenSetRequest": {
+                "type": "object",
+                "properties": {
+                    "screenIdx": { "type": "integer", "nullable": true, "description": "Index of active screen or null to clear" }
+                }
+            },
+            "AnyObjectOrNull": {
+                "oneOf": [
+                    { "type": "object", "additionalProperties": true },
+                    { "type": "null" }
+                ]
+            }
+        },
+        "parameters": {
+            "DisplayIdParam": {
+                "in": "path",
+                "required": true,
+                "name": "displayId",
+                "description": "KIP instance UUID",
+                "schema": { "type": "string" }
+            }
+        },
+        "securitySchemes": {
+            "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" },
+            "cookieAuth": { "type": "apiKey", "in": "cookie", "name": "JAUTHENTICATION" }
+        }
+    },
+    "security": [{ "cookieAuth": [] }, { "bearerAuth": [] }],
+    "paths": {
+        "/plugins/kip/displays": {
+            "get": {
+                "tags": ["Displays"],
+                "summary": "List available KIP displays",
+                "responses": {
+                    "200": {
+                        "description": "List of KIP instances discovered under self.displays",
+                        "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DisplayInfo" } } } }
+                    },
+                    "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
+                }
+            }
+        },
+        "/plugins/kip/displays/{displayId}": {
+            "parameters": [{ "$ref": "#/components/parameters/DisplayIdParam" }],
+            "get": {
+                "tags": ["Displays"],
+                "summary": "Get raw display entry under self.displays.{displayId}",
+                "responses": {
+                    "200": { "description": "Display object", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnyObjectOrNull" } } } },
+                    "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } },
+                    "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
+                }
+            },
+            "put": {
+                "tags": ["Displays"],
+                "summary": "Set display entry under self.displays.{displayId}",
+                "requestBody": {
+                    "required": false,
+                    "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnyObjectOrNull" } } }
+                },
+                "responses": {
+                    "200": { "description": "Updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } },
+                    "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
+                }
+            }
+        },
+        "/plugins/kip/displays/{displayId}/activeScreen": {
+            "parameters": [{ "$ref": "#/components/parameters/DisplayIdParam" }],
+            "get": {
+                "tags": ["Displays"],
+                "summary": "Get active screen index for display",
+                "responses": {
+                    "200": { "description": "Active screen index or null", "content": { "application/json": { "schema": { "type": "integer", "nullable": true } } } },
+                    "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } },
+                    "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
+                }
+            },
+            "put": {
+                "tags": ["Displays"],
+                "summary": "Set active screen index for display",
+                "requestBody": {
+                    "required": false,
+                    "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActiveScreenSetRequest" } } }
+                },
+                "responses": {
+                    "200": { "description": "Updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } },
+                    "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }
+                }
+            }
+        }
+    }
+}

package/public/3rdpartylicenses.txt

@@ -478,58 +478,6 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
---------------------------------------------------------------------------------
-Package: @angular/router
-License: "MIT"
-
-The MIT License
-
-Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-
---------------------------------------------------------------------------------
-Package: compare-versions
-License: "MIT"
-
-The MIT License (MIT)
-
-Copyright (c) 2015-2021 Ole Michelsen
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
 --------------------------------------------------------------------------------
 Package: rxjs
 License: "Apache-2.0"
@@ -789,6 +737,32 @@ maintained libraries used by this software which have their own
 licenses; we recommend you read them, as their terms may differ from the
 terms above.
 
+--------------------------------------------------------------------------------
+Package: compare-versions
+License: "MIT"
+
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Ole Michelsen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 --------------------------------------------------------------------------------
 Package: @angular/forms
 License: "MIT"
@@ -883,6 +857,32 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 
+--------------------------------------------------------------------------------
+Package: @angular/router
+License: "MIT"
+
+The MIT License
+
+Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
 --------------------------------------------------------------------------------
 Package: core-js
 License: "MIT"

package/public/assets/help-docs/welcome.md

@@ -3,8 +3,8 @@ KIP supports multiple input modes for seamless navigation across devices.
 
 | Actions                    | Touch         | Mouse                        | Keyboard Shortcuts                                 |
 |----------------------------|--------------|------------------------------|----------------------------------------------------|
-| Open Actions menu          | Swipe left    | Click, drag left, and release| <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>←</kbd> (Left Arrow) |
-| Open Notification menu     | Swipe right   | Click, drag right, and release| <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>→</kbd> (Right Arrow)  |
+| Open Actions sidenav          | Swipe left    | Click, drag left, and release| <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>←</kbd> (Left Arrow) |
+| Open Notification sidenav     | Swipe right   | Click, drag right, and release| <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>→</kbd> (Right Arrow)  |
 | Cycle through dashboards   | Swipe up/down | Click, drag up/down, and release| <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>↑</kbd>/<kbd>↓</kbd> (Up/Down Arrow) |
 | Toggle Fullscreen          | N/A           | N/A                          | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>F</kbd>  |
 | Toggle Night mode          | N/A           | N/A                          | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>N</kbd>  |

package/public/assets/svg/icons.svg

@@ -59,12 +59,16 @@
       <path fill="currentColor" d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2m0 16H5V5h14z" />
       <path fill="var(--mat-sys-primary)" d="M7 7h4v4H7zm6 0h4v4h-4z" />
     </svg>
-    <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14" id="settings" height="14" width="14">
+    <svg id="settings" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14" height="14" width="14">
       <path fill="none" d="m4.093 3.976 0.36 -0.93a0.838 0.838 0 0 1 0.78 -0.536h0.687a0.838 0.838 0 0 1 0.779 0.536l0.36 0.93 1.223 0.704 0.99 -0.151a0.838 0.838 0 0 1 0.837 0.41l0.335 0.587a0.837 0.837 0 0 1 -0.067 0.947l-0.612 0.779v1.407l0.629 0.78a0.838 0.838 0 0 1 0.067 0.946l-0.335 0.587a0.837 0.837 0 0 1 -0.838 0.41l-0.989 -0.15 -1.223 0.703 -0.36 0.93a0.838 0.838 0 0 1 -0.78 0.536h-0.703a0.838 0.838 0 0 1 -0.78 -0.536l-0.36 -0.93 -1.223 -0.704 -0.988 0.151a0.838 0.838 0 0 1 -0.838 -0.41l-0.335 -0.587a0.838 0.838 0 0 1 0.067 -0.946l0.611 -0.78V7.252l-0.628 -0.78a0.838 0.838 0 0 1 -0.067 -0.946l0.335 -0.586a0.838 0.838 0 0 1 0.838 -0.411l0.988 0.15 1.24 -0.703Zm-0.192 3.98a1.676 1.676 0 1 0 3.351 0 1.676 1.676 0 0 0 -3.351 0Z" stroke-width="1"></path>
       <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M5.92 2.51h-0.687a0.838 0.838 0 0 0 -0.78 0.536l-0.36 0.93 -1.24 0.704 -0.988 -0.151a0.838 0.838 0 0 0 -0.838 0.41l-0.335 0.587a0.838 0.838 0 0 0 0.067 0.947l0.628 0.779v1.407l-0.611 0.78a0.838 0.838 0 0 0 -0.067 0.946l0.335 0.587a0.837 0.837 0 0 0 0.838 0.41l0.988 -0.15 1.223 0.703 0.36 0.93a0.838 0.838 0 0 0 0.78 0.536h0.704a0.838 0.838 0 0 0 0.779 -0.536l0.36 -0.93 1.223 -0.704 0.989 0.151a0.838 0.838 0 0 0 0.838 -0.41l0.335 -0.587a0.838 0.838 0 0 0 -0.067 -0.946l-0.629 -0.78v-0.907m-5.864 0.204a1.676 1.676 0 1 0 3.351 0 1.676 1.676 0 0 0 -3.351 0Z" stroke-width="1"></path>
       <path fill="var(--mat-sys-primary)" d="M8.1 3.603c-0.306 -0.053 -0.306 -0.494 0 -0.548A2.779 2.779 0 0 0 10.34 0.912l0.018 -0.085c0.067 -0.303 0.499 -0.305 0.568 -0.002l0.023 0.098a2.793 2.793 0 0 0 2.244 2.13c0.309 0.055 0.309 0.498 0 0.551a2.793 2.793 0 0 0 -2.244 2.131l-0.023 0.099c-0.069 0.302 -0.501 0.3 -0.568 -0.003l-0.018 -0.084a2.779 2.779 0 0 0 -2.238 -2.144Z" stroke-width="1"></path>
       <path stroke="var(--mat-sys-primary)" stroke-linecap="round" stroke-linejoin="round" d="M8.1 3.603c-0.306 -0.053 -0.306 -0.494 0 -0.548A2.779 2.779 0 0 0 10.34 0.912l0.018 -0.085c0.067 -0.303 0.499 -0.305 0.568 -0.002l0.023 0.098a2.793 2.793 0 0 0 2.244 2.13c0.309 0.055 0.309 0.498 0 0.551a2.793 2.793 0 0 0 -2.244 2.131l-0.023 0.099c-0.069 0.302 -0.501 0.3 -0.568 -0.003l-0.018 -0.084a2.779 2.779 0 0 0 -2.238 -2.144Z" stroke-width="1"></path>
     </svg>
+    <svg id="remote-control" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16" height="16" width="16">
+      <path fill="var(--mat-sys-primary)" fill-opacity="0.5" d="M14 3.5v9c0 0.132625 -0.0526875 0.2598125 -0.1464375 0.3535625S13.632625 13 13.5 13H3c0 -0.2651875 -0.10535625 -0.5195625 -0.29289375 -0.707125C2.51956875 12.105375 2.26521875 12 2 12V3.5c0 -0.13260625 0.05268125 -0.2597875 0.14644375 -0.35355625C2.2402125 3.05268125 2.36739375 3 2.5 3h11c0.132625 0 0.2598125 0.05268125 0.3535625 0.14644375C13.9473125 3.2402125 14 3.36739375 14 3.5Z" stroke-width="1"></path>
+      <path fill="currentColor" d="M14.5 3.5v9c0 0.2651875 -0.105375 0.5195625 -0.292875 0.707125 -0.1875625 0.1875 -0.4419375 0.292875 -0.707125 0.292875h-4.5c-0.132625 0 -0.2598125 -0.0526875 -0.3535625 -0.1464375S8.5 13.132625 8.5 13s0.0526875 -0.2598125 0.1464375 -0.3535625S8.867375 12.5 9 12.5h4.5V3.5H2.5v2.5c0 0.13260625 -0.05268125 0.2598125 -0.14644375 0.3535625C2.2597875 6.4473125 2.13260625 6.5 2 6.5s-0.2597875 -0.0526875 -0.35355625 -0.1464375C1.55268125 6.2598125 1.5 6.13260625 1.5 6V3.5c0 -0.26521875 0.10535625 -0.51956875 0.29289375 -0.70710625C1.98043125 2.60535625 2.23478125 2.5 2.5 2.5h11c0.2651875 0 0.5195625 0.10535625 0.707125 0.29289375C14.394625 2.98043125 14.5 3.23478125 14.5 3.5ZM2 11.5c-0.13260625 0 -0.2597875 0.0526875 -0.35355625 0.1464375C1.55268125 11.7401875 1.5 11.867375 1.5 12s0.05268125 0.2598125 0.14644375 0.3535625C1.7402125 12.4473125 1.86739375 12.5 2 12.5s0.2597875 0.0526875 0.35355625 0.1464375C2.44731875 12.7401875 2.5 12.867375 2.5 13s0.05268125 0.2598125 0.14644375 0.3535625C2.7402125 13.4473125 2.86739375 13.5 3 13.5s0.2597875 -0.0526875 0.35355625 -0.1464375C3.44731875 13.2598125 3.5 13.132625 3.5 13c0 -0.3978125 -0.1580375 -0.779375 -0.4393375 -1.0606875C2.77935625 11.6580625 2.397825 11.5 2 11.5Zm0 -2c-0.13260625 0 -0.2597875 0.0526875 -0.35355625 0.1464375C1.55268125 9.7401875 1.5 9.867375 1.5 10s0.05268125 0.2598125 0.14644375 0.3535625C1.7402125 10.4473125 1.86739375 10.5 2 10.5c0.66304375 0 1.298925 0.263375 1.76776875 0.73225C4.23660625 11.7010625 4.5 12.3369375 4.5 13c0 0.132625 0.05268125 0.2598125 0.14644375 0.3535625C4.7402125 13.4473125 4.86739375 13.5 5 13.5s0.2597875 -0.0526875 0.35355625 -0.1464375C5.44731875 13.2598125 5.5 13.132625 5.5 13c-0.00099375 -0.9279375 -0.3700625 -1.817625 -1.026225 -2.47375C3.8176125 9.8700625 2.92795 9.501 2 9.5Zm0 -2c-0.13260625 0 -0.2597875 0.0526875 -0.35355625 0.1464375C1.55268125 7.7401875 1.5 7.867375 1.5 8s0.05268125 0.2598125 0.14644375 0.3535625C1.7402125 8.4473125 1.86739375 8.5 2 8.5c1.19306875 0.0013125 2.33689375 0.475875 3.18051875 1.3195C6.02414375 10.663125 6.4986875 11.8069375 6.5 13c0 0.132625 0.0526875 0.2598125 0.1464375 0.3535625S6.867375 13.5 7 13.5s0.2598125 -0.0526875 0.3535625 -0.1464375S7.5 13.132625 7.5 13c-0.001625 -1.4581875 -0.581625 -2.8561875 -1.6127375 -3.88725C4.85616875 8.081625 3.45818125 7.501625 2 7.5Z" stroke-width="1"></path>
+    </svg>
     <svg id="help-center" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
       <circle fill="currentColor" fill-opacity="0" stroke="currentColor" stroke-width="2" cx="12" cy="13" r="9" />
       <text fill="var(--mat-sys-primary)" x="12" y="19" font-size="16" font-family="Roboto" font-style="bolder" text-anchor="middle" >?</text>