@mxtommy/kip 4.2.0 → 4.4.0-beta.1

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,84 @@
+name: Bug Report
+description: Report a bug or issue
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please provide the following information to help us investigate.
+  
+  - type: dropdown
+    id: operating-system
+    attributes:
+      label: Operating System
+      description: Which operating system(s) are you using?
+      multiple: true
+      options:
+        - Raspberry Pi OS
+        - macOS
+        - iOS
+        - Windows
+        - Linux
+        - Android     
+        - Other
+    validations:
+      required: true
+  
+  - type: dropdown
+    id: browser
+    attributes:
+      label: Browser
+      description: Which browser(s) are you using?
+      multiple: true
+      options:
+        - Chromium
+        - Chrome
+        - Safari
+        - Edge
+        - Firefox
+        - Brave
+        - Opera
+        - Other
+    validations:
+      required: true
+  
+  - type: input
+    id: kip-version
+    attributes:
+      label: KIP Version
+      description: What version of Kip are you using (Found in Settings -> Options -> Connectivity)?
+      placeholder: e.g., v2.5.1
+    validations:
+      required: true
+  
+  - type: input
+    id: signalk-version
+    attributes:
+      label: Signal K Server Version
+      description: What version of Signal K server are you using?
+      placeholder: e.g., v2.5.1
+    validations:
+      required: false
+  
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is - What did you expect, what actually happened and any other context about the problem here, including screenshots, logs, or error messages.
+      placeholder: What happened?
+    validations:
+      required: true
+  
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Community Support (Discord)
+    url: https://discord.gg/AMDYT2DQga
+    about: Please ask questions and discuss ideas in near real time here

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,35 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please provide details below.
+  
+  - type: textarea
+    id: feature-request
+    attributes:
+      label: Feature Request
+      description: |
+        Please describe the feature you'd like to see:
+        - What problem does this solve? What are you trying to accomplish?
+        - Provide a clear description of what you'd like to see added or changed.
+      placeholder: |
+        **Problem/Use Case:**
+        Describe what you're trying to accomplish...
+        
+        **Proposed Solution:**
+        Describe how you envision this feature working...
+    validations:
+      required: true
+  
+  - type: textarea
+    id: concepts-ideas-research
+    attributes:
+      label: Concepts, Ideas & Research
+      description: Add any other information, screenshots, mockups, links similar apps or existing documentation about the feature request here.
+      placeholder: Paste links, mockups, screenshots or related documentation to help us come up with a good and informed design...
+    validations:
+      required: false

package/.github/copilot-instructions.md

@@ -129,7 +129,7 @@ Template:
 
 ## Project specifics & gotchas
 - Always respect serve path /@mxtommy/kip/ (dev/prod). Assets and routing assume this base.
-- CommonJS deps are explicitly allowed (howler, js-quantities). Avoid introducing new CJS without adding to allowedCommonJsDependencies.
+- CommonJS deps are explicitly allowed (js-quantities). Avoid introducing new CJS without adding to allowedCommonJsDependencies.
 - Use standalone components, signals, @if/@for; follow .github/instructions/angular.instructions.md for style.
 - Widget config UIs live under src/app/widget-config; path controls use custom validators (no Validators.required). Respect isPathConfigurable and pathRequired.
 

package/.github/instructions/project.instructions.md

@@ -113,7 +113,13 @@ All major services in `src/app/core/services/` are summarized below for Copilot
 
 - **NotificationsService (`notifications.service.ts`)**
   - Key methods: Notification state management, audio/visual alerts, muting.
-  - Dependencies: AppSettingsService, DataService, SignalkRequestsService, Howler.
+  - Dependencies: AppSettingsService, DataService, SignalkRequestsService.
+
+- **ToastService (`toast.service.ts`)**
+  - Purpose: In-app snackbars using Angular Material.
+  - Key methods: `show(message, duration = 1500, silent = true, action = 'Dismiss', severity = 'message')`.
+  - Dependencies: MatSnackBar, AppSettingsService.
+  - Usage: Use for short, user-visible feedback (login errors, PUT failures, success confirmations). Sound is suppressed when `silent=true` or user sound settings disable audio.
 
 - **CanvasService (`canvas.service.ts`)**
   - Purpose: Provides drawing and rendering utilities for widgets and dashboard components.

package/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master, develop ]
+  pull_request:
+    branches: [ main, master, develop ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm i
+
+    - name: Lint
+      run: npm run lint
+
+    - name: Run tests
+      run: npm run test:headless
+
+    - name: Build All (Webapp & Plugin)
+      run: npm run build:all

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+# v4.3.0
+## New Features
+* New signalk-anchoralarm-plugin (by Scott Bender) embedded widget to surface its features and make anchor setting and monitoring fast and easy.
+## Improvements
+* Added a Simple Wind mode in Windsteer (a popular request) to mimic classic instruments. Toggle “Enable Advanced Compass Mode” off to lock the dial to +/- 180° and keep indicators stable. Fixes #828
+* New high‑impact snackbar templates with inform/warn/alert layouts, bold colors, and icons that make different app message types instantly recognizable.
+## Fixes
+* Racesteer (beta): corrected tack/gybe angle, indicator reference, and layline calculations for better precision. Fixes #858
+* Fixed occasional double‑fire on long‑press gestures (reduced extra processing).
+* Prevented duplicate app events from async PUT responses (reduced extra processing).
 # v4.2.0
 ## New Features
 * Multi State Switch widget: Take control of multi‑mode devices (chargers, inverters, and more) with a clear state list that highlights the active mode and lets you switch states with a tap. Fixes #404

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxtommy/kip",
-  "version": "4.2.0",
+  "version": "4.4.0-beta.1",
   "description": "An advanced and versatile marine instrumentation package to display Signal K data.",
   "license": "MIT",
   "author": {
@@ -55,47 +55,24 @@
   },
   "schematics": "tools/schematics/collection.json",
   "devDependencies": {
-    "@angular-devkit/build-angular": "^21.1.0",
+    "@angular-devkit/build-angular": "^21.1.4",
     "@angular-devkit/schematics-cli": "^20.1.6",
-    "@angular/animations": "21.1.0",
-    "@angular/build": "^21.1.0",
-    "@angular/cdk": "21.1.0",
-    "@angular/cli": "^21.1.0",
-    "@angular/common": "21.1.0",
-    "@angular/compiler": "21.1.0",
-    "@angular/compiler-cli": "21.1.0",
-    "@angular/core": "21.1.0",
-    "@angular/forms": "21.1.0",
-    "@angular/language-service": "21.1.0",
-    "@angular/material": "21.1.0",
-    "@angular/platform-browser": "21.1.0",
-    "@angular/platform-browser-dynamic": "21.1.0",
-    "@angular/router": "21.1.0",
-    "@godind/ng-canvas-gauges": "^6.2.1",
+    "@angular/build": "^21.1.4",
+    "@angular/cli": "^21.1.4",
+    "@angular/compiler-cli": "21.1.4",
+    "@angular/language-service": "21.1.4",
     "@types/canvas-gauges": "^2.1.8",
-    "@types/howler": "^2.2.10",
     "@types/jasmine": "~3.6.0",
     "@types/jasminewd2": "^2.0.9",
     "@types/js-quantities": "^1.6.6",
     "@types/lodash-es": "^4.17.9",
     "@types/node": "^24.1.0",
-    "@zakj/no-sleep": "^0.13.5",
-    "angular-eslint": "21.1.0",
-    "chart.js": "^4.5.1",
-    "@aziham/chartjs-plugin-streaming": "^3.5.1",
-    "chartjs-adapter-date-fns": "^3.0.0",
-    "chartjs-plugin-annotation": "^3.0.1",
-    "clipboard": "^2.0.11",
+    "@types/d3": "^7.4.3",
+    "angular-eslint": "21.2.0",
     "codelyzer": "^6.0.0",
-    "compare-versions": "^6.1.1",
-    "core-js": "^3.13.1",
-    "date-fns": "^2.30.0",
     "eslint": "^9.29.0",
-    "gridstack": "^12.3.3",
-    "howler": "^2.2.4",
     "jasmine-core": "~4.0.1",
     "jasmine-spec-reporter": "~5.0.0",
-    "js-quantities": "^1.8.0",
     "karma": "^6.4.4",
     "karma-chrome-launcher": "~3.1.0",
     "karma-cli": "~2.0.0",
@@ -103,22 +80,46 @@
     "karma-jasmine": "~4.0.0",
     "karma-jasmine-html-reporter": "^1.6.0",
     "karma-spec-reporter": "^0.0.36",
-    "lodash-es": "^4.17.21",
     "ng-packagr": "^21.0.1",
-    "ngx-markdown": "^21.0.1",
-    "prismjs": "^1.30.0",
     "protractor": "~7.0.0",
     "pwa-asset-generator": "^8.1.1",
-    "rxjs": "^7.8.2",
     "sass": "^1.49.9",
-    "screenfull": "^6.0.2",
-    "steelseries": "^2.0.9",
     "ts-node": "^10.9.2",
-    "tslib": "^2.6.2",
-    "typescript": "^5.9.3",
-    "zone.js": "^0.15.1"
+    "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@signalk/server-api": "^2.7.2"
+    "@angular/animations": "21.1.4",
+    "@angular/cdk": "21.1.4",
+    "@angular/common": "21.1.4",
+    "@angular/compiler": "21.1.4",
+    "@angular/core": "21.1.4",
+    "@angular/forms": "21.1.4",
+    "@angular/material": "21.1.4",
+    "@angular/platform-browser": "21.1.4",
+    "@angular/platform-browser-dynamic": "21.1.4",
+    "@angular/router": "21.1.4",
+    "@aziham/chartjs-plugin-streaming": "^3.5.1",
+    "@godind/ng-canvas-gauges": "^6.2.1",
+    "@zakj/no-sleep": "^0.13.5",
+    "chart.js": "^4.5.1",
+    "chartjs-adapter-date-fns": "^3.0.0",
+    "chartjs-plugin-annotation": "^3.0.1",
+    "clipboard": "^2.0.11",
+    "compare-versions": "^6.1.1",
+    "core-js": "^3.13.1",
+    "d3": "^7.9.0",
+    "date-fns": "^2.30.0",
+    "gridstack": "^12.3.3",
+    "js-quantities": "^1.8.0",
+    "lodash-es": "^4.17.23",
+    "ngx-markdown": "^21.0.1",
+    "prismjs": "^1.30.0",
+    "rxjs": "^7.8.2",
+    "screenfull": "^6.0.2",
+    "steelseries": "^2.0.9",
+    "tslib": "^2.6.2",
+    "zone.js": "^0.15.1",
+    "@signalk/server-api": "^2.7.2",
+    "@spanaaj/sk-ais-status-plugin": "^1.0.0"
   }
 }

package/plugin/index.js

@@ -57,12 +57,12 @@ const start = (server) => {
         const want = `displays.${displayId}${tail}`;
         const full = server.getSelfPath(want);
         server.debug(`getDisplaySelfPath: displayId: ${displayId}, suffix: ${suffix}, want=${want}, fullPath=${JSON.stringify(full)}`);
-        return full ? full : undefined;
+        return typeof full === 'object' && full !== null ? full : undefined;
     }
     function getAvailableDisplays() {
         const fullPath = server.getSelfPath('displays');
         server.debug(`getAvailableDisplays: fullPath=${JSON.stringify(fullPath)}`);
-        return fullPath ? fullPath : undefined;
+        return typeof fullPath === 'object' && fullPath !== null ? fullPath : undefined;
     }
     function pathToDotNotation(path) {
         const dottedPath = path.replace(/\//g, '.').replace(/^\./, '');