@mxtommy/kip 4.6.0-beta.2 → 4.7.0-beta.10

package/plugin/index.js

@@ -37,6 +37,14 @@ const server_api_1 = require("@signalk/server-api");
 const openapi = __importStar(require("./openApi.json"));
 const history_series_service_1 = require("./history-series.service");
 const sqlite_history_storage_service_1 = require("./sqlite-history-storage.service");
+async function defaultGetSqliteModule() {
+    try {
+        return await Promise.resolve().then(() => __importStar(require('node:sqlite')));
+    }
+    catch {
+        return null;
+    }
+}
 const start = (server) => {
     const mutableOpenApi = JSON.parse(JSON.stringify(openapi.default ?? openapi));
     const API_PATHS = {
@@ -79,15 +87,30 @@ const start = (server) => {
             }
         }
     };
-    const historySeries = new history_series_service_1.HistorySeriesService(() => Date.now());
-    const storageService = new sqlite_history_storage_service_1.SqliteHistoryStorageService();
+    const historySeries = new history_series_service_1.HistorySeriesService(() => Date.now(), typeof server.selfId === 'string' && server.selfId.trim().length > 0 ? `vessels.${server.selfId.trim()}` : null);
+    const resolveDataDirPath = () => {
+        const serverCompat = server;
+        const getter = typeof serverCompat.getDataDirPath === 'function'
+            ? serverCompat.getDataDirPath.bind(serverCompat)
+            : (typeof serverCompat.app?.getDataDirPath === 'function'
+                ? serverCompat.app.getDataDirPath.bind(serverCompat.app)
+                : null);
+        if (!getter) {
+            throw new Error('Signal K Server API does not expose getDataDirPath() on server or server.app');
+        }
+        const dataDirPath = getter();
+        if (typeof dataDirPath !== 'string' || dataDirPath.trim().length === 0) {
+            throw new Error('Signal K Server API returned an invalid data directory path');
+        }
+        return dataDirPath.trim();
+    };
+    const storageService = new sqlite_history_storage_service_1.SqliteHistoryStorageService(resolveDataDirPath());
     let retentionSweepTimer = null;
     let storageFlushTimer = null;
     let sqliteInitializationPromise = null;
     const SQLITE_INIT_WAIT_TIMEOUT_MS = 5000;
     const MIN_NODE_SQLITE_VERSION = '22.5.0';
     let streamUnsubscribes = [];
-    let historyApiRegistry = null;
     let historyApiProviderRegistered = false;
     let runtimeSqliteUnavailableMessage = null;
     function logRuntimeDependencyVersions() {
@@ -95,16 +118,12 @@ const start = (server) => {
         const sqliteAvailability = modeConfig && modeConfig.nodeSqliteAvailable ? 'available' : 'unavailable';
         server.debug(`[KIP][RUNTIME] ${nodeIdentity} node:sqlite=${sqliteAvailability}`);
     }
-    async function getSqliteModule() {
-        try {
-            return await Promise.resolve().then(() => __importStar(require('node:sqlite')));
-        }
-        catch {
-            return null;
-        }
-    }
     async function detectSqliteRuntime() {
-        const sqliteModule = await getSqliteModule();
+        const exportedStart = start;
+        const resolveSqliteModule = typeof exportedStart.getSqliteModule === 'function'
+            ? exportedStart.getSqliteModule
+            : defaultGetSqliteModule;
+        const sqliteModule = await resolveSqliteModule();
         if (!sqliteModule) {
             runtimeSqliteUnavailableMessage = `node:sqlite requires Node ${MIN_NODE_SQLITE_VERSION}+`;
             return false;
@@ -145,6 +164,95 @@ const start = (server) => {
             nodeSqliteAvailable: nodeSqliteAvailable !== false
         };
     }
+    function slugify(value) {
+        return value
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '');
+    }
+    function resolveBmsBatteryIdsFromSelfPath() {
+        const batteriesPath = server.getSelfPath('electrical.batteries');
+        const readCandidate = (node) => {
+            if (!node || typeof node !== 'object' || Array.isArray(node)) {
+                return null;
+            }
+            const root = node;
+            if (Object.prototype.hasOwnProperty.call(root, 'value')) {
+                const value = root.value;
+                if (value && typeof value === 'object' && !Array.isArray(value)) {
+                    return value;
+                }
+                return null;
+            }
+            return root;
+        };
+        const candidates = readCandidate(batteriesPath);
+        if (!candidates) {
+            return [];
+        }
+        return Object.keys(candidates)
+            .filter(id => /^[a-z0-9_-]+$/i.test(id))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    function getExistingConcreteBmsSeries(templateSeries, existingSeries) {
+        return existingSeries
+            .filter(series => series.ownerWidgetUuid === templateSeries.ownerWidgetUuid)
+            .filter(history_series_service_1.isKipConcreteSeriesDefinition)
+            .filter(series => series.seriesId !== templateSeries.seriesId)
+            .map(series => ({ ...series }));
+    }
+    function mergeSeriesDefinitions(series) {
+        const mergedById = new Map();
+        series.forEach(item => {
+            mergedById.set(item.seriesId, item);
+        });
+        return Array.from(mergedById.values());
+    }
+    function expandTemplateSeriesDefinitions(payload, existingSeries = []) {
+        const bmsMetrics = ['capacity.stateOfCharge', 'current'];
+        const expandedById = new Map();
+        const discoveredBatteryIds = resolveBmsBatteryIdsFromSelfPath();
+        payload.forEach(series => {
+            if (!(0, history_series_service_1.isKipTemplateSeriesDefinition)(series)) {
+                expandedById.set(series.seriesId, series);
+                return;
+            }
+            if (discoveredBatteryIds.length === 0) {
+                getExistingConcreteBmsSeries(series, existingSeries).forEach(existing => {
+                    expandedById.set(existing.seriesId, existing);
+                });
+                return;
+            }
+            const allowedBatteryIds = Array.isArray(series.allowedBatteryIds)
+                ? series.allowedBatteryIds
+                    .filter((id) => typeof id === 'string')
+                    .map(id => id.trim())
+                    .filter(id => id.length > 0)
+                : [];
+            const allowedSet = allowedBatteryIds.length > 0 ? new Set(allowedBatteryIds) : null;
+            const batteryIds = discoveredBatteryIds.filter(id => !allowedSet || allowedSet.has(id));
+            if (batteryIds.length === 0) {
+                return;
+            }
+            const source = series.source ?? 'default';
+            const sourceKey = slugify(source || 'default') || 'default';
+            batteryIds.forEach(batteryId => {
+                bmsMetrics.forEach(metric => {
+                    const path = `self.electrical.batteries.${batteryId}.${metric}`;
+                    const seriesId = `${series.ownerWidgetUuid}:bms:${batteryId}:${metric}:${sourceKey}`;
+                    expandedById.set(seriesId, {
+                        ...series,
+                        seriesId,
+                        datasetUuid: `${series.ownerWidgetUuid}:bms:${batteryId}:${metric}:${sourceKey}`,
+                        path,
+                        retentionDurationMs: Number.isFinite(series.retentionDurationMs) ? series.retentionDurationMs : 24 * 60 * 60 * 1000,
+                        expansionMode: null
+                    });
+                });
+            });
+        });
+        return Array.from(expandedById.values());
+    }
     function getDisplaySelfPath(displayId, suffix) {
         const tail = suffix ? `.${suffix}` : '';
         const want = `displays.${displayId}${tail}`;
@@ -470,7 +578,17 @@ const start = (server) => {
             server.debug('[KIP][HISTORY_PROVIDER] registration skipped reason=config-disabled');
             return;
         }
-        const host = server;
+        const serverWithHistoryApi = server;
+        const registerHistoryApiProvider = typeof serverWithHistoryApi.registerHistoryApiProvider === 'function'
+            ? serverWithHistoryApi.registerHistoryApiProvider.bind(serverWithHistoryApi)
+            : (typeof serverWithHistoryApi.history?.registerHistoryApiProvider === 'function'
+                ? serverWithHistoryApi.history.registerHistoryApiProvider.bind(serverWithHistoryApi.history)
+                : null);
+        // guard when running in SK variants that do not support History API registration
+        if (!registerHistoryApiProvider) {
+            server.debug('[KIP][HISTORY_PROVIDER] registration skipped reason=api-unavailable');
+            return;
+        }
         const apiProvider = {
             getValues: async (query) => {
                 const resolved = await resolveHistoryValues(buildHistoryQueryFromValuesRequest(query));
@@ -485,26 +603,9 @@ const start = (server) => {
             getPaths: (query) => resolveHistoryPaths(buildHistoryQueryFromRangeRequest(query)),
             getContexts: (query) => resolveHistoryContexts(buildHistoryQueryFromRangeRequest(query))
         };
-        const registry = host.history && typeof host.history.registerHistoryApiProvider === 'function'
-            ? host.history
-            : (typeof host.registerHistoryApiProvider === 'function'
-                ? {
-                    registerHistoryApiProvider: host.registerHistoryApiProvider.bind(host),
-                    unregisterHistoryApiProvider: typeof host.unregisterHistoryApiProvider === 'function'
-                        ? host.unregisterHistoryApiProvider.bind(host)
-                        : undefined
-                }
-                : null);
-        if (registry && typeof registry.registerHistoryApiProvider === 'function') {
-            registry.registerHistoryApiProvider(apiProvider);
-            historyApiProviderRegistered = true;
-            if (typeof registry.unregisterHistoryApiProvider === 'function') {
-                historyApiRegistry = { unregisterHistoryApiProvider: registry.unregisterHistoryApiProvider.bind(registry) };
-            }
-            server.debug('[KIP][HISTORY_PROVIDER] registration success provider=kip');
-            return;
-        }
-        server.debug('[KIP][HISTORY_PROVIDER] registration skipped reason=api-unavailable');
+        registerHistoryApiProvider(apiProvider);
+        historyApiProviderRegistered = true;
+        server.debug('[KIP][HISTORY_PROVIDER] registration success provider=kip');
     }
     function rebuildSeriesCaptureSubscriptions() {
         stopSeriesCapture();
@@ -530,7 +631,7 @@ const start = (server) => {
             // If any series for this path requires non-self context, force generic bus subscription.
             existing.allSelfContext = existing.allSelfContext && allSelfContext;
         };
-        historySeries.listSeries().filter(series => series.enabled !== false).forEach(series => {
+        historySeries.listSeries().filter(history_series_service_1.isKipSeriesEnabled).forEach(series => {
             const allSelfContext = (series.context ?? 'vessels.self') === 'vessels.self';
             addCandidate(series.path, allSelfContext);
             // Workaround: subscribe to immediate parent path so object deltas (e.g. navigation.attitude)
@@ -603,9 +704,6 @@ const start = (server) => {
             if (!modeConfig.nodeSqliteAvailable) {
                 server.error(`[KIP][RUNTIME] node:sqlite unavailable. ${runtimeSqliteUnavailableMessage}`);
             }
-            const serverWithApp = server;
-            const dataDirPath = serverWithApp.app?.getDataDirPath?.();
-            storageService.setDataDirPath(typeof dataDirPath === 'string' ? dataDirPath : null);
             storageService.setRuntimeAvailability(modeConfig.nodeSqliteAvailable, runtimeSqliteUnavailableMessage ?? undefined);
             logRuntimeDependencyVersions();
             logOperationalMode('start-configured');
@@ -633,13 +731,13 @@ const start = (server) => {
                                 }
                                 startStorageFlushTimer(storageConfig.flushIntervalMs);
                                 logOperationalMode('sqlite-ready');
-                                server.setPluginStatus(`KIP plugin started with node:sqlite history storage. Loaded ${storedSeries.length} persisted series. historySeriesServiceEnabled=${modeConfig.historySeriesServiceEnabled} historyApiProviderEnabled=${modeConfig.registerAsHistoryApiProvider} historyApiProviderRegistered=${historyApiProviderRegistered}`);
+                                server.setPluginStatus(`Providing: Remote Control${historyApiProviderRegistered ? ', History service' : ', No History service'}${storedSeries.length > 0 ? `, ${storedSeries.length} Time-Series` : ', No Time-Series'}.`);
                             })
                                 .catch((loadError) => {
                                 server.error(`[SERIES STORAGE] failed to load persisted series: ${String(loadError.message || loadError)}`);
                                 startStorageFlushTimer(storageConfig.flushIntervalMs);
                                 logOperationalMode('sqlite-ready-series-load-failed');
-                                server.setPluginStatus(`KIP plugin started with node:sqlite history storage. historySeriesServiceEnabled=${modeConfig.historySeriesServiceEnabled} historyApiProviderEnabled=${modeConfig.registerAsHistoryApiProvider} historyApiProviderRegistered=${historyApiProviderRegistered}`);
+                                server.setPluginStatus(`Providing: Remote Control${historyApiProviderRegistered ? ', History service' : ', No History service'}, No Time-Series.`);
                             });
                         }
                         else {
@@ -647,7 +745,7 @@ const start = (server) => {
                             stopSeriesCapture();
                             startStorageFlushTimer(storageConfig.flushIntervalMs);
                             logOperationalMode('sqlite-ready-series-disabled');
-                            server.setPluginStatus(`KIP plugin started with history-series service disabled. historyApiProviderEnabled=${modeConfig.registerAsHistoryApiProvider} historyApiProviderRegistered=${historyApiProviderRegistered}`);
+                            server.setPluginStatus(`Providing: Remote Control${historyApiProviderRegistered ? ', History service' : ', No History service'}, No Time-Series.`);
                         }
                         return;
                     }
@@ -659,7 +757,7 @@ const start = (server) => {
                     if (initError) {
                         server.setPluginError(`node:sqlite unavailable. ${initError}`);
                         logOperationalMode('sqlite-unavailable');
-                        server.setPluginStatus(`KIP plugin started with node:sqlite unavailable. historySeriesServiceEnabled=${modeConfig?.historySeriesServiceEnabled} historyApiProviderEnabled=${modeConfig?.registerAsHistoryApiProvider} historyApiProviderRegistered=${historyApiProviderRegistered}`);
+                        server.setPluginStatus(`Providing: Remote Control${historyApiProviderRegistered ? ', History service' : ', No History service'}, No Time-Series.`);
                     }
                 });
                 if (retentionSweepTimer) {
@@ -695,7 +793,7 @@ const start = (server) => {
             }
             else {
                 if (modeConfig && !modeConfig.nodeSqliteAvailable && (modeConfig.historySeriesServiceEnabled || modeConfig.registerAsHistoryApiProvider)) {
-                    server.setPluginError(getSqliteUnavailableMessage());
+                    server.setPluginStatus(getSqliteUnavailableMessage());
                 }
                 server.debug('[KIP][STORAGE] sqlite init skipped reason=config-disabled-or-runtime');
                 sqliteInitializationPromise = null;
@@ -742,16 +840,16 @@ const start = (server) => {
                 .catch(() => undefined)
                 .then(() => storageService.close(storageLifecycleToken))
                 .catch(() => undefined);
-            if (historyApiRegistry) {
-                try {
-                    historyApiRegistry.unregisterHistoryApiProvider();
-                    server.debug('[KIP][HISTORY_PROVIDER] unregister success provider=kip');
-                }
-                catch (error) {
-                    server.error(`[HISTORY PROVIDER] unregister failed: ${String(error.message || error)}`);
-                }
-                historyApiRegistry = null;
+            const serverWithHistoryApi = server;
+            const unregisterHistoryApiProvider = typeof serverWithHistoryApi.unregisterHistoryApiProvider === 'function'
+                ? serverWithHistoryApi.unregisterHistoryApiProvider.bind(serverWithHistoryApi)
+                : (typeof serverWithHistoryApi.history?.unregisterHistoryApiProvider === 'function'
+                    ? serverWithHistoryApi.history.unregisterHistoryApiProvider.bind(serverWithHistoryApi.history)
+                    : null);
+            if (unregisterHistoryApiProvider) {
+                unregisterHistoryApiProvider();
             }
+            historyApiProviderRegistered = false;
             sqliteInitializationPromise = null;
             const msg = 'Stopped.';
             server.setPluginStatus(msg);
@@ -1057,14 +1155,28 @@ const start = (server) => {
                     if (!Array.isArray(payload)) {
                         return sendFail(res, 400, 'Body must be an array of series definitions');
                     }
-                    const simulated = new history_series_service_1.HistorySeriesService(() => Date.now());
-                    historySeries.listSeries().forEach(series => {
+                    const simulated = new history_series_service_1.HistorySeriesService(() => Date.now(), typeof server.selfId === 'string' && server.selfId.trim().length > 0 ? `vessels.${server.selfId.trim()}` : null);
+                    const currentSeries = mergeSeriesDefinitions([
+                        ...(await storageService.getSeriesDefinitions()),
+                        ...historySeries.listSeries()
+                    ]);
+                    currentSeries.forEach(series => {
                         simulated.upsertSeries(series);
                     });
                     const scopedPayload = payload.map(series => ({
                         ...series
                     }));
-                    const result = simulated.reconcileSeries(scopedPayload);
+                    const isBatteryDiscoveryUnavailable = resolveBmsBatteryIdsFromSelfPath().length === 0;
+                    const preservedBmsSeries = isBatteryDiscoveryUnavailable
+                        ? scopedPayload
+                            .filter(history_series_service_1.isKipTemplateSeriesDefinition)
+                            .flatMap(series => currentSeries.filter(current => current.ownerWidgetUuid === series.ownerWidgetUuid && (0, history_series_service_1.isKipConcreteSeriesDefinition)(current) && current.seriesId !== series.seriesId))
+                        : [];
+                    const expandedPayload = mergeSeriesDefinitions([
+                        ...expandTemplateSeriesDefinitions(scopedPayload, currentSeries),
+                        ...preservedBmsSeries
+                    ]);
+                    const result = simulated.reconcileSeries(expandedPayload);
                     const nextSeries = simulated.listSeries();
                     await storageService.replaceSeriesDefinitions(nextSeries);
                     const seriesOutsideScope = historySeries.listSeries();
@@ -1093,4 +1205,6 @@ const start = (server) => {
     };
     return plugin;
 };
+const startWithHooks = start;
+startWithHooks.getSqliteModule = defaultGetSqliteModule;
 module.exports = start;

package/plugin/kip-series-contract.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKipTemplateSeriesDefinition = isKipTemplateSeriesDefinition;
+exports.isKipConcreteSeriesDefinition = isKipConcreteSeriesDefinition;
+exports.isKipSeriesEnabled = isKipSeriesEnabled;
+function isKipTemplateSeriesDefinition(series) {
+    return series.expansionMode === 'bms-battery-tree';
+}
+function isKipConcreteSeriesDefinition(series) {
+    return series.expansionMode == null;
+}
+function isKipSeriesEnabled(series) {
+    return series.enabled;
+}

package/plugin/openApi.json

@@ -131,7 +131,7 @@
                 "nullable": true,
                 "additionalProperties": true
             },
-            "SeriesDefinition": {
+            "SeriesDefinitionBase": {
                 "type": "object",
                 "properties": {
                     "seriesId": {
@@ -177,13 +177,101 @@
                     "enabled": {
                         "type": "boolean",
                         "default": true
+                    },
+                    "methods": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "enum": [
+                                "min",
+                                "max",
+                                "avg",
+                                "sma",
+                                "ema"
+                            ]
+                        }
+                    },
+                    "reconcileTs": {
+                        "type": "integer",
+                        "nullable": true
                     }
                 },
                 "required": [
                     "seriesId",
                     "datasetUuid",
                     "ownerWidgetUuid",
-                    "path"
+                    "ownerWidgetSelector",
+                    "path",
+                    "enabled"
+                ]
+            },
+            "ConcreteSeriesDefinition": {
+                "allOf": [
+                    {
+                        "$ref": "#/components/schemas/SeriesDefinitionBase"
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "expansionMode": {
+                                "nullable": true,
+                                "description": "Null for concrete series definitions."
+                            },
+                            "allowedBatteryIds": {
+                                "type": "array",
+                                "nullable": true,
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Concrete series do not use battery filters and should leave this null."
+                            }
+                        }
+                    }
+                ]
+            },
+            "TemplateSeriesDefinition": {
+                "allOf": [
+                    {
+                        "$ref": "#/components/schemas/SeriesDefinitionBase"
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "ownerWidgetSelector": {
+                                "type": "string",
+                                "enum": [
+                                    "widget-bms"
+                                ]
+                            },
+                            "expansionMode": {
+                                "type": "string",
+                                "enum": [
+                                    "bms-battery-tree"
+                                ]
+                            },
+                            "allowedBatteryIds": {
+                                "type": "array",
+                                "nullable": true,
+                                "items": {
+                                    "type": "string"
+                                }
+                            }
+                        },
+                        "required": [
+                            "ownerWidgetSelector",
+                            "expansionMode"
+                        ]
+                    }
+                ]
+            },
+            "SeriesDefinition": {
+                "oneOf": [
+                    {
+                        "$ref": "#/components/schemas/ConcreteSeriesDefinition"
+                    },
+                    {
+                        "$ref": "#/components/schemas/TemplateSeriesDefinition"
+                    }
                 ]
             },
             "SeriesReconcileResult": {

package/plugin/sqlite-history-storage.service.js

@@ -38,7 +38,7 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const DEFAULT_STORAGE_CONFIG = {
     engine: 'node:sqlite',
-    databaseFile: 'plugin-config-data/kip/historicalData/kip-history.sqlite',
+    databaseFile: '',
     flushIntervalMs: 30_000
 };
 /**
@@ -49,8 +49,7 @@ class SqliteHistoryStorageService {
     static FOUR_HOURS_INTERVAL = 4 * 60 * 60 * 1000;
     static STALE_SERIES_AGE_MS = 180 * 24 * 60 * 60 * 1000;
     static PRUNE_BATCH_SIZE = 10_000;
-    config = { ...DEFAULT_STORAGE_CONFIG };
-    dataDirPath = null;
+    config;
     logger = {
         debug: () => undefined,
         error: () => undefined
@@ -66,6 +65,16 @@ class SqliteHistoryStorageService {
     vacuumJob = null;
     pruneJob = null;
     staleSeriesCleanupJob = null;
+    constructor(dataDirPath) {
+        const normalizedDataDirPath = String(dataDirPath);
+        if (!normalizedDataDirPath) {
+            throw new Error('SqliteHistoryStorageService requires a valid dataDirPath from server.getDataDirPath()');
+        }
+        this.config = {
+            ...DEFAULT_STORAGE_CONFIG,
+            databaseFile: (0, path_1.join)(normalizedDataDirPath, 'historicalData', 'kip-history.sqlite')
+        };
+    }
     /**
      * Sets logger callbacks used by the storage service.
      *
@@ -89,27 +98,12 @@ class SqliteHistoryStorageService {
      */
     configure() {
         this.initialized = false;
-        const databaseFile = this.dataDirPath
-            ? (0, path_1.join)(this.dataDirPath, 'historicalData', 'kip-history.sqlite')
-            : DEFAULT_STORAGE_CONFIG.databaseFile;
         this.config = {
             ...DEFAULT_STORAGE_CONFIG,
-            databaseFile
+            databaseFile: this.config.databaseFile
         };
         return this.config;
     }
-    /**
-     * Sets the base directory for persisted history data.
-     *
-     * @param {string | null} baseDir Absolute directory path for plugin data.
-     * @returns {void}
-     *
-     * @example
-     * storage.setDataDirPath('/var/lib/signalk');
-     */
-    setDataDirPath(baseDir) {
-        this.dataDirPath = typeof baseDir === 'string' && baseDir.trim() ? baseDir.trim() : null;
-    }
     /**
      * Updates runtime availability of node:sqlite, clearing stored errors when enabled.
      *
@@ -316,7 +310,7 @@ class SqliteHistoryStorageService {
             seriesId: row.series_id,
             datasetUuid: row.dataset_uuid,
             ownerWidgetUuid: row.owner_widget_uuid,
-            ownerWidgetSelector: row.owner_widget_selector ?? undefined,
+            ownerWidgetSelector: row.owner_widget_selector ?? null,
             path: row.path,
             source: row.source ?? undefined,
             context: row.context ?? undefined,

package/public/3rdpartylicenses.txt

@@ -276,6 +276,42 @@ OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 THIS SOFTWARE.
 
+--------------------------------------------------------------------------------
+Package: d3-path
+License: "ISC"
+
+Copyright 2015-2022 Mike Bostock
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.
+
+--------------------------------------------------------------------------------
+Package: d3-shape
+License: "ISC"
+
+Copyright 2010-2022 Mike Bostock
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.
+
 --------------------------------------------------------------------------------
 Package: d3-zoom
 License: "ISC"

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

@@ -69,9 +69,9 @@ KIP widgets turn Signal K data into readable visuals and controls. Available wid
 - **Position** – Displays latitude and longitude for location tracking and navigation.
 - **Static Label** – Add customizable labels to organize and clarify your dashboard layout.
 - **Zones State Panel**: Monitor the health/state of path data. Each panel control displays path data severity and status messages (driven by Signal K metadata zones).
-- **Switch Panel** – Group of toggle switches, indicator lights, and press buttons for digital switching and operations. See [Digital Switching and PUT Path Setup](putcontrols.md).
-- **Slider** – Range slider for adjusting values (e.g. lighting intensity). See [Digital Switching and PUT Path Setup](putcontrols.md).
-- **Multi State Switch** - Lists all available device/path operating modes/states (e.g., On, Off, Charge Only, Invert Only), highlights the current state, and lets you select a new state to send to the device and see the result. See [Digital Switching and PUT Path Setup](putcontrols.md).
+- **Switch Panel** – Group of toggle switches, indicator lights, and press buttons for digital switching and operations. See [Digital Switching and PUT Path Setup](#/help/putcontrols.md).
+- **Slider** – Range slider for adjusting values (e.g. lighting intensity). See [Digital Switching and PUT Path Setup](#/help/putcontrols.md).
+- **Multi State Switch** - Lists all available device/path operating modes/states (e.g., On, Off, Charge Only, Invert Only), highlights the current state, and lets you select a new state to send to the device and see the result. See [Digital Switching and PUT Path Setup](#/help/putcontrols.md).
 - **Compact Linear** – Simple horizontal linear gauge with a large value label and modern look.
 - **Linear** – Horizontal or vertical linear gauge with zone highlighting.
 - **Radial** – Radial gauge with configurable dials and zone highlighting.

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

@@ -24,7 +24,7 @@ The Data Inspector is a good way to validate raw data and available paths withou
 
 2. **PUT Support**:
    - You can see if a path supports PUT operations, indicated by a green checkmark in the **PUT Support** column.
-   - For more details on PUT support and how to use it, refer to the [Updating Signal K Data](putcontrols.md) help documentation.
+   - For more details on PUT support and how to use it, refer to the [Updating Signal K Data](#/help/putcontrols.md) help documentation.
 
 3. **Multiple Data Sources**:
    - The Data Inspector displays how many sources are providing data for each path.
@@ -42,8 +42,8 @@ The Data Inspector is a good way to validate raw data and available paths withou
 
 - **Verify PUT Support**:
    - Check if a path supports PUT operations. It is required to configure widgets like Switch Panel, Slider, or Multi State Switch.
-   - For more details on PUT support and how to use it, refer to the [Updating Signal K Data](putcontrols.md) help documentation.
-   - If you are learning Node-RED flows and want your flow to work with KIP digital switching widgets, continue with [Node-RED Control Flows for KIP Widgets (Beginner Guide)](nodered-control-flows.md).
+   - For more details on PUT support and how to use it, refer to the [Updating Signal K Data](#/help/putcontrols.md) help documentation.
+   - If you are learning Node-RED flows and want your flow to work with KIP digital switching widgets, continue with [Node-RED Control Flows for KIP Widgets (Beginner Guide)](#/help/nodered-control-flows.md).
 
 - **Troubleshoot Data Issues**:
    - The Data Inspector is a good troubleshooting tool, but it should be used with the Signal K Data Browser when trying to understand raw data and behavior. The combination of these tools provides a more complete picture of the data, its processing, and its behavior.