@signalk/app-dock 1.2.1 → 1.3.1

package/.github/workflows/release_on_tag.yml

@@ -1,82 +0,0 @@
-# Publishes the tag it runs on to npm. Release tags come from release-please:
-# merging its release PR creates the tag and the GitHub Release, then
-# release-please.yml dispatches this workflow on the tag. Pre-release tags
-# (-beta.N, -rc.N, -alpha.N) are pushed by hand, and only a pushed tag gets
-# its GitHub Release created here.
-name: 'Release on tag'
-
-on:
-  push:
-    tags:
-      - 'v*'
-  # How release-please.yml starts this on a tag it created: that tag, pushed
-  # with GITHUB_TOKEN, raises no push event.
-  workflow_dispatch:
-
-concurrency:
-  group: release-${{ github.ref }}
-  cancel-in-progress: false
-
-jobs:
-  # A dispatched run is on a tag release-please made, and release-please made
-  # its Release too; creating one here would be a second for the same tag.
-  release:
-    if: ${{ github.event_name == 'push' }}
-    permissions:
-      contents: write
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-      - name: Create Release
-        uses: softprops/action-gh-release@v3
-        with:
-          tag_name: ${{ github.ref_name }}
-          name: ${{ github.ref_name }}
-          generate_release_notes: true
-          prerelease: ${{ contains(github.ref_name, 'beta') || contains(github.ref_name, 'alpha') || contains(github.ref_name, 'rc') }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  publish:
-    needs: release
-    # Runs after the Release on a pushed tag, and without it on a dispatched
-    # one, where that job is skipped. A dispatch can name any ref; only a
-    # release tag is published.
-    if: ${{ !cancelled() && needs.release.result != 'failure' && startsWith(github.ref, 'refs/tags/v') }}
-    permissions:
-      id-token: write
-      contents: read
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/setup-node@v6
-        with:
-          node-version: '24.x'
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: npm ci
-
-      - name: Verify the tag matches package.json
-        run: |
-          TAG="${GITHUB_REF_NAME#v}"
-          PKG="$(node -p "require('./package.json').version")"
-          if [ "$TAG" != "$PKG" ]; then
-            echo "::error::tag $GITHUB_REF_NAME does not match package.json version $PKG"
-            exit 1
-          fi
-          echo "tag and package.json agree on $PKG"
-
-      - name: Publish to npm
-        run: |
-          tag="${GITHUB_REF#refs/tags/}"
-          if [[ "$tag" == *alpha* ]]; then
-            npm publish --provenance --access public --tag alpha
-          elif [[ "$tag" == *beta* ]]; then
-            npm publish --provenance --access public --tag beta
-          elif [[ "$tag" == *rc* ]]; then
-            npm publish --provenance --access public --tag rc
-          else
-            npm publish --provenance --access public
-          fi

package/.github/workflows/stale.yml

@@ -1,42 +0,0 @@
-# Marks issues labeled "awaiting response" as stale after 30 days of inactivity
-# and closes them 30 days after that (60 days total). Issues labeled
-# "good first task" or "help wanted" are exempt. Pull requests are never
-# touched. The workflow runs daily and can also be triggered manually.
-name: Stale issues
-
-on:
-  schedule:
-    - cron: '17 1 * * *'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  issues: write
-
-concurrency:
-  group: stale
-  cancel-in-progress: false
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-      - uses: actions/stale@v10
-        with:
-          days-before-issue-stale: 30
-          days-before-issue-close: 30
-          stale-issue-label: 'stale'
-          any-of-issue-labels: 'awaiting response'
-          exempt-issue-labels: 'good first task,help wanted'
-          stale-issue-message: >
-            This issue is marked as awaiting a response from the reporter and
-            has had no activity for 30 days. It will be closed in another 30
-            days if there is no further update. If the issue is still
-            relevant, please reply with any missing information.
-          close-issue-message: >
-            Closing this issue because it has been stale for 60 days without
-            a response. Please reopen if this is still relevant.
-          days-before-pr-stale: -1
-          days-before-pr-close: -1
-          operations-per-run: 100

package/.prettierignore

@@ -1,6 +0,0 @@
-node_modules
-public/remoteEntry.js
-public/540.js
-public/805.js
-public/main.js
-public/540.js.LICENSE.txt

package/.prettierrc

@@ -1,6 +0,0 @@
-{
-  "semi": false,
-  "singleQuote": true,
-  "trailingComma": "none",
-  "printWidth": 120
-}

package/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.2.1"
-}

package/AGENTS.md

@@ -1,134 +0,0 @@
-# @signalk/app-dock
-
-A Signal K server plugin plus webapp: a macOS-style dock for switching between Signal K webapps on touch screens. The
-dock page holds each app in an iframe, and a double-tap anywhere brings up the dock. User-facing behaviour is documented
-in `README.md`; this file covers what a contributor needs to keep intact.
-
-## Architecture
-
-Three surfaces ship together from one package:
-
-- **`plugin/index.js`**: the server plugin (CommonJS). It holds the schema, seeds the default apps on first start, serves
-  the dock's HTTP routes, and registers the `environment.mode` PUT handler for the night-mode button.
-- **`public/dock.js`, `dock.css`, `index.html`**: the dock itself, served as-is at `/@signalk/app-dock/`. Plain browser
-  JavaScript with **no build step**: edit and reload.
-- **`src/configpanel/`**: the React 19 config panel that the admin UI loads through Webpack Module Federation (keyword
-  `signalk-plugin-configurator`). `npm run build:config` writes `public/remoteEntry.js` and its chunks.
-
-`public/config.html` is an older standalone configurator that the schema description links to; the admin UI shows the
-React panel.
-
-## Rules to keep in mind
-
-- **Seed once, never rewrite.** `start()` seeds `DEFAULT_APPS` only when the saved `apps` is not an array. An app list
-  that already exists, even an empty one, is the user's and is never changed.
-- **The default app list lives in three places.** `DEFAULT_APPS` in `plugin/index.js`, `NO_ADMIN_DEFAULTS` in
-  `public/dock.js` (served to visitors the plugin's `/settings` refuses), and the welcome-tour text in
-  `public/index.html`. Change them together.
-- **`savePluginOptions` replaces the whole saved configuration.** Build every save from a complete configuration
-  (`running ? pluginSettings : savedSettings()`), never from a partial object.
-- **Routes must work while the plugin is stopped.** signalk-server registers the router of every loaded plugin, enabled
-  or not. A handler that needs the configuration reads `app.readPluginOptions()` when `running` is false.
-- **Access is opt-in per route.** Routes on `router` are admin-only. `router.access('readonly' | 'readwrite')`
-  (signalk-server 2.31 and later) opens a route to more users; feature-detect it (`typeof router.access === 'function'`)
-  so older servers keep working admin-only. `/config` stays admin-only on every server. When access changes, update the
-  access detection at the top of `dock.js` and the **Access** table in `README.md` with it.
-- **`/settings` is readable by every visitor with read access.** Never put credentials or anything secret in it; that
-  includes app URLs.
-- **Taps pass through.** The double-tap listener is passive, never calls `preventDefault()`, and there is no overlay
-  element. It attaches to the dock document and, recursively, to every same-origin iframe document, so apps that embed
-  other apps still open the dock.
-- **One iframe sandbox string.** `switchToApp()` and the tour's Plugin Config link in `dock.js` create iframes with the
-  same `sandbox` value; keep them identical. `allow-top-navigation-by-user-activation` is what lets a dock opened inside
-  a dock break out to the top window (the guard at the top of `dock.js`).
-- **Live config reload.** The dock polls the plugin every 5 s. A setting that changes how the dock is built belongs in
-  `STRUCTURAL_KEYS` in `dock.js` (the page reloads); app-list changes rebuild the dock in place.
-- **New settings touch four places:** the schema in `plugin/index.js`, `DEFAULTS` in `dock.js`, the config panel in
-  `src/configpanel/`, and the **Settings** table in `README.md`.
-- **Browser globals are declared.** ESLint lints `dock.js` as a classic script with an explicit globals list in
-  `eslint.config.js`; add a browser API there when `dock.js` starts using it.
-
-## Build output is committed
-
-`public/remoteEntry.js`, `public/main.js`, `public/540.js`, `public/805.js` and `public/540.js.LICENSE.txt` are Webpack
-output and are tracked in git. After changing `src/configpanel/`, run `npm run build:config` and commit the regenerated
-files with the source change. `prepublishOnly` rebuilds them at publish time. Prettier and ESLint skip them, and ESLint
-also skips `src/`.
-
-## Icons
-
-`public/app-icon.svg` is the source icon: the `signalk.appIcon` shown by the admin UI and the App Store, the favicon,
-and the dock's own logo. `public/app-icon-180.png` (apple-touch-icon) is generated from it and
-`public/app-icon-maskable.svg` is maintained by hand; see **Icon assets** in `README.md`.
-
-## Tests
-
-`npm test` runs `test/plugin.test.js` with `node:test` against a mock `app` (`createMockApp()`). Cover new routes,
-settings and seeding behaviour there. `dock.js` has no automated tests; check dock changes in a browser against a
-running server (see **Development** in `README.md`).
-
-## Workflow conventions
-
-This repo is maintained by Dirk Wahrheit.
-
-- Branch names use **hyphens**, never slashes.
-- Angular conventional commits: `<type>(<scope>): <subject>`. PR titles use the same format; the generated release
-  notes are built from them.
-- The PR title's type also picks its section in the release notes. `.github/workflows/label-by-title.yml` labels each
-  PR when it is opened or its title edited: `feat`/`perf` → `enhancement` (🚀 Features), `fix` → `bug` (🐛 Fixes),
-  `docs` → `documentation` (📖 Documentation), `build`/`ci`/`test`/`chore`/`refactor`/`style` → `skip-changelog`
-  (left out). Any other type lands under Other. A label set by hand stays until the title is next edited. Keep the
-  workflow and `.github/release.yml` naming the same labels.
-- One logical change per commit.
-- No `Co-Authored-By` lines. No "Generated with Claude Code" attribution.
-- Never commit directly to `main`. Every change goes through a PR.
-- PR descriptions: no checkboxes. "Tested" lists what actually ran, not what was planned.
-- No hand-written CHANGELOG; GitHub Releases carry generated notes.
-
-### Before opening a PR
-
-```bash
-npm run format          # prettier --write + eslint --fix
-npm run lint
-npm test
-npm run build:config    # only when src/configpanel/ changed; commit the output
-```
-
-CI (`.github/workflows/ci.yml`) calls signalk-server's shared `plugin-ci.yml`: install, `npm test`, plugin lifecycle
-and schema checks, npm-pack contents, and an App Store style `--ignore-scripts` install. It does **not** run Prettier or
-ESLint, so run them locally.
-
-### Releases
-
-Releases are cut by release-please. Every releasable push to `main` updates a standing release PR titled
-`chore(release): X.Y.Z` that bumps `version` in `package.json` and `package-lock.json`. Merging it creates the tag and
-the GitHub Release, and `.github/workflows/release-please.yml` then dispatches `release_on_tag.yml` on the tag, which
-publishes to npm with provenance (OIDC trusted publishing, no token).
-
-- **The version follows the commits:** `feat` → minor, `fix`, `perf` and `revert` → patch, `!` or a
-  `BREAKING CHANGE:` footer → major. A `Release-As: X.Y.Z` footer overrides it. Do not bump the version in an ordinary
-  PR.
-- **A push with nothing releasable leaves the release PR alone.** The `gate` job in `release-please.yml` decides what
-  counts; its comment lists the cases. Revert with a conventional `revert:` subject, since release-please ignores
-  GitHub's `Revert "…"`. Change the gate's last alternative together with `pull-request-title-pattern` in
-  `release-please-config.json`, or the release PR's merge never creates a tag.
-- **Merge the release PR once it lists your change.** release-please refreshes it a moment after each merge; a
-  release PR merged before that still ships the change (the tag is on top of it) but its notes leave it out.
-- **Pre-releases are cut by hand:** a `chore(release): X.Y.Z-beta.N` PR, then an annotated tag `vX.Y.Z-beta.N` pushed
-  on its merge commit. `release_on_tag.yml` creates their Release itself and publishes under the npm dist-tag `alpha`,
-  `beta` or `rc` that the tag contains.
-
-## File layout
-
-| Path                          | Purpose                                                                               |
-| ----------------------------- | ------------------------------------------------------------------------------------- |
-| `plugin/index.js`             | Plugin entry: schema, default-app seeding, routes, night-mode PUT handler.            |
-| `public/index.html`           | Dock page: idle screen, dock, backdrop, loading overlay, welcome tour.                |
-| `public/dock.js`              | Dock logic: access detection, config loading and polling, iframes, double-tap, dock.  |
-| `public/dock.css`             | Dock styling, magnification, positions.                                               |
-| `public/manifest.webmanifest` | PWA manifest for Add to Home Screen.                                                  |
-| `public/config.html`          | Older standalone configurator.                                                        |
-| `src/configpanel/`            | React config panel for the admin UI (Module Federation remote).                       |
-| `webpack.config.js`           | Builds `src/configpanel/` into `public/`; shares React as a singleton with the admin. |
-| `test/plugin.test.js`         | Plugin tests (`node:test`).                                                           |
-| `docs/screenshots/`           | App Store screenshots, listed in `package.json` under `signalk.screenshots`.          |

package/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/eslint.config.js

@@ -1,59 +0,0 @@
-const prettier = require('eslint-config-prettier')
-
-module.exports = [
-  { ignores: ['src/**', 'public/remoteEntry.js', 'public/540.js', 'public/805.js', 'public/main.js'] },
-  {
-    files: ['plugin/**/*.js', 'test/**/*.js'],
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'commonjs',
-      globals: {
-        require: 'readonly',
-        module: 'readonly',
-        exports: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        process: 'readonly',
-        console: 'readonly',
-        setTimeout: 'readonly',
-        clearTimeout: 'readonly',
-        setInterval: 'readonly',
-        clearInterval: 'readonly',
-        globalThis: 'readonly'
-      }
-    },
-    rules: {
-      'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
-      'no-undef': 'error'
-    }
-  },
-  {
-    files: ['public/dock.js'],
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'script',
-      globals: {
-        window: 'readonly',
-        document: 'readonly',
-        navigator: 'readonly',
-        fetch: 'readonly',
-        console: 'readonly',
-        setTimeout: 'readonly',
-        clearTimeout: 'readonly',
-        setInterval: 'readonly',
-        requestAnimationFrame: 'readonly',
-        Promise: 'readonly',
-        Set: 'readonly',
-        Infinity: 'readonly',
-        MutationObserver: 'readonly',
-        URLSearchParams: 'readonly',
-        location: 'readonly'
-      }
-    },
-    rules: {
-      'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
-      'no-undef': 'error'
-    }
-  },
-  prettier
-]

package/release-please-config.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
-  "release-type": "node",
-  "include-component-in-tag": false,
-  "changelog-type": "github",
-  "skip-changelog": true,
-  "pull-request-title-pattern": "chore(release): ${version}",
-  "packages": {
-    ".": {}
-  }
-}