1.5.2

fixes #119

.envrc

@@ -0,0 +1 @@
+use flake

.github/workflows/build.yml

@@ -2,65 +2,53 @@ name: Build
 
 on:
   push:
-    branches: [ "master" ]
+    tags:
-    tags: ["v*"]
+      - "v*"
-  pull_request:
+  workflow_dispatch:
-    branches: [ "master" ]
 
 jobs:
-  build:
+  CI:
-    name: 🔨 Build
+    name: 🔨🚀 Build and deploy
     runs-on: ubuntu-latest
     steps:
-    - name: 🚚 Checkout
+      - name: 🚚 Checkout
-      uses: actions/checkout@v3
+        uses: actions/checkout@v3
-    - name: 🐍 Use Python 3.x
+      - name: 🐍 Use Python 3.x
-      uses: actions/setup-python@v3.1.4
+        uses: actions/setup-python@v3.1.4
-      with:
+        with:
-        python-version: 3.x
+          python-version: 3.x
-        cache: pip
+          cache: pip
-    - name: ⏬ Install Python dependencies
+      - name: ⏬ Install Python dependencies
-      run: python -m venv venv
+        run: pip install -r requirements.txt
-    - run: ./venv/bin/pip install -r requirements.txt
-    
-    - name: 🐉 Use Node.js 18.16.x
-      uses: actions/setup-node@v3
-      with:
-        node-version: 18.16.x
-        cache: 'npm'
-    - name: ⏬ Install Node dependencies
-      run: npm ci
 
-    - name: 🔥 Optimize icon font
+      - name: Install pnpm
-      run: npm run minify-icons
+        uses: pnpm/action-setup@v4
-    - name: 🔨 Build site
+        with:
-      run: npm run build
+          version: 8
-    
+      - name: 🐉 Use Node.js 18.16.x
-    - name: 📦 Upload build artifacts
+        uses: actions/setup-node@v3
-      uses: actions/upload-artifact@v3.1.2
+        with:
-      with:
+          node-version: 18.16.x
-        name: build
+          cache: "pnpm"
-        path: build
+      - name: ⏬ Install Node dependencies
-  deploy:
+        run: pnpm install
-    name: 🚀 Deploy
+
-    if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
+      - name: 🔥 Optimize icon font
-    runs-on: ubuntu-latest
+        run: pnpm minify-icons
-    needs: build
+      - name: 🔨 Build site
-    environment:
+        run: pnpm build
-      name: Website
+
-      url: https://dotio.theaninova.de
+      - name: 📦 Upload build artifacts
-    steps:
+        uses: actions/upload-artifact@v3.1.2
-      - name: 📦 Download build artifacts
-        uses: actions/download-artifact@v2.1.1
         with:
           name: build
           path: build
-      - name: 🚀 Deploy
+      - name: Disable jekyll
-        uses: SamKirkland/web-deploy@v1
+        run: touch build/.nojekyll
-        with:
+      - name: Custom domain
-          target-server: ${{ secrets.SSH_SERVER }}
+        run: echo 'manager.charachorder.com' > build/CNAME
-          destination-path: ~/public_html/
+      - run: git config user.name github-actions
-          source-path: ./build/
+      - run: git config user.email github-actions@github.com
-          remote-user: ${{ secrets.SSH_USER }}
+      - run: git --work-tree build add --all
-          private-ssh-key: ${{ secrets.SSH_PRIVATE_KEY }}
+      - run: git commit -m "Automatic Deploy action run by github-actions"
-          ssh-port: ${{ secrets.SSH_PORT }}
+      - run: git push origin HEAD:gh-pages --force

.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+name: "publish desktop apps"
+on:
+  push:
+    tags:
+      - "desktop-app-v*"
+  workflow_dispatch:
+
+jobs:
+  publish-tauri:
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        platform: [macos-latest, ubuntu-20.04, windows-latest]
+
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - name: 🚚 Checkout
+        uses: actions/checkout@v3
+      - name: 🐍 Use Python 3.x
+        uses: actions/setup-python@v3.1.4
+        with:
+          python-version: 3.x
+          cache: pip
+      - name: ⏬ Install Python dependencies
+        run: pip install -r requirements.txt
+      - name: 🐉 Use Node.js 18.16.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18.16.x
+          cache: "npm"
+      - name: 🦀 Use Rust Stable
+        uses: dtolnay/rust-toolchain@stable
+      - name: 🐧 Install Linux Dependencies
+        if: matrix.platform == 'ubuntu-20.04'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libudev-dev libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
+      - name: ⏬ Install Node dependencies
+        run: npm ci
+      - name: 🔥 Optimize icon font
+        run: npm run minify-icons
+      - name: 📦 Build, Package & Release
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAURI_PRIVATE_KEY: ${{ secrets.TAURI_PRIVATE_KEY }}
+        with:
+          tagName: v__VERSION__ # the action automatically replaces \_\_VERSION\_\_ with the app version
+          releaseName: "App v__VERSION__"
+          releaseBody: "See the assets to download this version and install."
+          releaseDraft: true
+          prerelease: false

.gitignore

@@ -6,6 +6,7 @@ node_modules
 /package
 .env
 .env.*
+.direnv
 !.env.example
 venv
 vite.config.js.timestamp-*

.prettierignore

@@ -6,8 +6,11 @@ node_modules
 .env
 .env.*
 !.env.example
+/src-tauri/target
 
 # Ignore files for PNPM, NPM and YARN
 pnpm-lock.yaml
 package-lock.json
 yarn.lock
+
+static/languages/*.json

.prettierrc

@@ -1,9 +1,4 @@
 {
-  "useTabs": true,
-  "singleQuote": true,
-  "trailingComma": "none",
-  "printWidth": 100,
   "plugins": ["prettier-plugin-svelte"],
-  "pluginSearchDirs": ["."],
+  "overrides": [{ "files": "*.svelte", "options": { "parser": "svelte" } }]
-  "overrides": [{"files": "*.svelte", "options": {"parser": "svelte"}}]
 }

.typesafe-i18n.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/typesafe-i18n@5.26.2/schema/typesafe-i18n.json",
+  "baseLocale": "en",
+  "adapter": "svelte"
+}

CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing
+
+## UX Principles
+
+- **Opinionated.** There should never be two ways to do the same thing.
+- **Intuitive.** If a feature needs a description to explain it,
+  the feature has failed.
+- **Simple.** No useless buttons that always need to be pressed.
+
+## UI Design
+
+The UI design is based on Material 3.
+
+## Development Setup
+
+### Nix
+
+[Enable flakes](https://nixos.wiki/wiki/Flakes#Enable_flakes), then start the development shell using
+
+```shell
+nix develop
+```
+
+You may need to run through some additional setup to get Rust running inside IntelliJ.
+
+### Other platforms
+
+- NodeJS >=18.16
+- Python >=3.10
+- Rust Stable (For Tauri Development)
+
+I know, python in JS projects is extremely annoying, unfortunately,
+it seems to be the only platform that offers a functional
+way to subset variable woff2 fonts with ligatures.
+
+In other words, either have python as a development dependency or
+serve a 3.5MB icons font of which 99.5% is completely unused.

README.md

@@ -1,25 +1,12 @@
-# dot i/o V2
+# CharaChorder Device Manager
 
-![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/Theaninova/dotio/build.yml)
+The official device manager and configuration tool for CharaChorder devices.
-![GitHub](https://img.shields.io/github/license/Theaninova/dotio)
-[![GitHub deployments](https://img.shields.io/github/deployments/Theaninova/dotio/Website?label=delployment)](https://dotio.theaninova.de/)
 
-_This project is not affiliated or endorsed with neither the original [dot i/o](https://www.iq-eq.io/) site, nor [CharaChorder](https://www.charachorder.com/)_
+![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/CharaChorder/DeviceManager/build.yml)
+![GitHub](https://img.shields.io/github/license/CharaChorder/DeviceManager)
+[![GitHub deployments](https://img.shields.io/github/deployments/CharaChorder/DeviceManager/Website?label=delployment)](https://manager.charachorder.com/)
 
-I aim to create a new site that offers an easier, visually pleasing
+Get the latest desktop release [here](https://github.com/CharaChorder/DeviceManager/releases).
-and more complete way to configure and learn CharaChorder devices.
-
-## Development
-
-- NodeJS >=18.16
-- Python >=3.10 virtual environment
-
-I know, python in JS projects is extremely annoying, unfortunately,
-it seems to be the only platform that offers a functional
-way to subset variable woff2 fonts with ligatures.
-
-In other words, either have python as a development dependency or
-serve a 3.5MB icons font of which 99.5% is completely unused.
 
 ## Deployment
 
@@ -42,3 +29,11 @@ To double-check, make sure your private key starts with
 
 After that, add the `SSH_SERVER`, `SSH_PORT`, `SSH_PRIVATE_KEY` and `SSH_USER`
 environment secrets to your environment in GitHub.
+
+## Releases
+
+Change the version in
+
+- [package.json](package.json)
+- [tauri.conf.json](src-tauri/tauri.conf.json)
+- [Cargo.toml](src-tauri/Cargo.toml)

docs/BACKUP.md

@@ -0,0 +1,64 @@
+# Chara Backup Format, Version 1
+
+JSON Schema files: TBD
+
+Chara backups are serialized using JSON, in this general format:
+
+```json
+{
+  "charaVersion": 1,
+  "type": "..."
+}
+```
+
+The presence of the key `charaVersion` uniquely identifies the JSON file as a chara backup file and serves
+as a discriminator against other generic JSON files. This key is mandatory for that reason.
+
+## Type `layout`
+
+```json
+{
+  "charaVersion": 1,
+  "type": "layout",
+  "device": "one",
+  "layers": [[], [], []]
+}
+```
+
+Devices at the current point in time may be identified as either `lite` or `one`, more to come in the future.
+
+Layers are serialized as an array of `[layer1, layer2, layer3]` in the internal order of the key, each specifying
+an action code. Action codes of `0` are considered unassigned.
+
+## Type `chords`
+
+```json
+{
+  "charaVersion": 1,
+  "type": "chords",
+  "chords": [
+    [
+      [1, 2, 3],
+      [3, 4, 5]
+    ],
+    [
+      [6, 7, 8],
+      [9, 10, 11]
+    ]
+  ]
+}
+```
+
+Chords are serialized using a key-value mapping of chord action codes to actions.
+
+## Type `settings`
+
+```json
+{
+  "charaVersion": 1,
+  "type": "settings",
+  "settings": [0, 1, 3, 6]
+}
+```
+
+Settings are serialized as an array of the values in the way they appear on the device.

flake.lock

@@ -0,0 +1,130 @@
+{
+  "nodes": {
+    "flake-utils": {
+      "inputs": {
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1689068808,
+        "narHash": "sha256-6ixXo3wt24N/melDWjq70UuHQLxGV8jZvooRanIHXw0=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "919d646de7be200f3bf08cb76ae1f09402b6f9b4",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "flake-utils_2": {
+      "inputs": {
+        "systems": "systems_2"
+      },
+      "locked": {
+        "lastModified": 1681202837,
+        "narHash": "sha256-H+Rh19JDwRtpVPAWp64F+rlEtxUWBAQW28eAi3SRSzg=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "cfacdce06f30d2b68473a46042957675eebb3401",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1689752456,
+        "narHash": "sha256-VOChdECcEI8ixz8QY+YC4JaNEFwQd1V8bA0G4B28Ki0=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "7f256d7da238cb627ef189d56ed590739f42f13b",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_2": {
+      "locked": {
+        "lastModified": 1681358109,
+        "narHash": "sha256-eKyxW4OohHQx9Urxi7TQlFBTDWII+F+x2hklDOQPB50=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "96ba1c52e54e74c3197f4d43026b3f3d92e83ff9",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs",
+        "rust-overlay": "rust-overlay"
+      }
+    },
+    "rust-overlay": {
+      "inputs": {
+        "flake-utils": "flake-utils_2",
+        "nixpkgs": "nixpkgs_2"
+      },
+      "locked": {
+        "lastModified": 1690942540,
+        "narHash": "sha256-eafSSO3Y+/TFuy+CHKyolYfGvC33IAWNx4W2NA7LfZM=",
+        "owner": "oxalica",
+        "repo": "rust-overlay",
+        "rev": "aa3994f054038262df55122dfa552b9eab71a994",
+        "type": "github"
+      },
+      "original": {
+        "owner": "oxalica",
+        "repo": "rust-overlay",
+        "type": "github"
+      }
+    },
+    "systems": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    },
+    "systems_2": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,78 @@
+{
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+    rust-overlay.url = "github:oxalica/rust-overlay";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+  outputs =
+    {
+      self,
+      nixpkgs,
+      flake-utils,
+      rust-overlay,
+    }:
+    flake-utils.lib.eachDefaultSystem (
+      system:
+      let
+        overlays = [ (import rust-overlay) ];
+        pkgs = import nixpkgs { inherit system overlays; };
+        rust-bin = pkgs.rust-bin.stable.latest.default.override {
+          extensions = [
+            "rust-src"
+            "rust-std"
+            "clippy"
+            "rust-analyzer"
+          ];
+        };
+        fontMin = pkgs.python311.withPackages (
+          ps:
+          with ps;
+          [
+            brotli
+            fonttools
+          ]
+          ++ (with fonttools.optional-dependencies; [ woff ])
+        );
+        tauriPkgs = nixpkgs.legacyPackages.${system};
+        libraries = with tauriPkgs; [
+          webkitgtk
+          gtk3
+          cairo
+          gdk-pixbuf
+          glib
+          dbus
+          openssl_3
+          librsvg
+        ];
+        packages =
+          (with pkgs; [
+            nodejs_18
+            nodePackages.pnpm
+            rust-bin
+            fontMin
+          ])
+          ++ (with tauriPkgs; [
+            curl
+            wget
+            pkg-config
+            dbus
+            openssl_3
+            glib
+            gtk3
+            libsoup
+            webkitgtk
+            librsvg
+            # serial plugin
+            udev
+          ]);
+      in
+      {
+        devShell = pkgs.mkShell {
+          buildInputs = packages;
+          shellHook = ''
+            export LD_LIBRARY_PATH=${pkgs.lib.makeLibraryPath libraries}:$LD_LIBRARY_PATH
+          '';
+        };
+      }
+    );
+}

icons.config.js

@@ -0,0 +1,119 @@
+/** @type {import('./src/tools/icons-config').IconsConfig} */
+const config = {
+  inputPath:
+    "node_modules/@fontsource-variable/material-symbols-rounded/files/material-symbols-rounded-latin-full-normal.woff2",
+  outputPath: "src/lib/assets/icons.min.woff2",
+  icons: [
+    "adjust",
+    "add",
+    "piano",
+    "keyboard",
+    "settings",
+    "edit",
+    "music_note",
+    "avg_pace",
+    "lyrics",
+    "speed",
+    "cognition",
+    "update",
+    "offline_pin",
+    "warning",
+    "cable",
+    "person",
+    "sync",
+    "school",
+    "restart_alt",
+    "usb",
+    "usb_off",
+    "rule_settings",
+    "123",
+    "abc",
+    "function",
+    "cloud_done",
+    "backup",
+    "cloud_download",
+    "cloud_off",
+    "share",
+    "ios_share",
+    "close",
+    "arrow_back",
+    "arrow_back_ios_new",
+    "save",
+    "settings_backup_restore",
+    "sort",
+    "shopping_bag",
+    "filter_list",
+    "settings_power",
+    "link",
+    "link_off",
+    "chevron_right",
+    "check_circle",
+    "error",
+    "auto_delete",
+    "format_paint",
+    "dark_mode",
+    "light_mode",
+    "palette",
+    "translate",
+    "play_arrow",
+    "extension",
+    "upload_file",
+    "commit",
+    "bug_report",
+    "delete",
+    "remove_selection",
+    "bolt",
+    "undo",
+    "redo",
+    "navigate_before",
+    "navigate_next",
+    "print",
+    "restore_from_trash",
+    "history",
+    "history_toggle_off",
+    "sentiment_satisfied",
+    "sentiment_dissatisfied",
+    "sentiment_very_satisfied",
+    "sentiment_neutral",
+    "sentiment_very_dissatisfied",
+    "sentiment_excited",
+    "sentiment_frustrated",
+    "sentiment_calm",
+    "sentiment_stressed",
+    "sentiment_extremely_dissatisfied",
+    "sentiment_sad",
+    "sentiment_content",
+    "sentiment_worried",
+    "timer",
+    "target",
+    "download",
+    "download_2",
+    "upload_2",
+    "stat_minus_2",
+    "stat_2",
+    "description",
+    "add_circle",
+    "refresh",
+  ],
+  codePoints: {
+    speed: "e9e4",
+    arrow_split: "e985",
+    arrow_circle_down: "f181",
+    arrow_circle_up: "f182",
+    counter_1: "f784",
+    counter_2: "f783",
+    counter_3: "f782",
+    ios_share: "e6b8",
+    light_mode: "e518",
+    upload_file: "e9fc",
+    no_sound: "e710",
+    sentiment_extremely_dissatisfied: "f194",
+    download_2: "f523",
+    upload_2: "ff52",
+    stat_minus_2: "e69c",
+    stat_2: "e699",
+    routine: "e20c",
+  },
+};
+
+export default config;

icons.config.ts

@@ -1,56 +0,0 @@
-export interface IconsConfig {
-  codePoints: Record<string, string>
-  inputPath: string
-  outputPath: string
-  icons: string[]
-}
-
-const config: IconsConfig = {
-  inputPath:
-    "node_modules/@fontsource-variable/material-symbols-rounded/files/material-symbols-rounded-latin-full-normal.woff2",
-  outputPath: "src/lib/assets/icons.min.woff2",
-  icons: [
-    "piano",
-    "keyboard",
-    "settings",
-    "music_note",
-    "avg_pace",
-    "lyrics",
-    "speed",
-    "cognition",
-    "update",
-    "offline_pin",
-    "warning",
-    "cable",
-    "person",
-    "sync",
-    "restart_alt",
-    "usb",
-    "rule_settings",
-    "123",
-    "abc",
-    "function",
-    "cloud_done",
-    "backup",
-    "cloud_download",
-    "share",
-    "ios_share",
-    "close",
-    "arrow_back",
-    "arrow_back_ios_new",
-    "save",
-    "settings_backup_restore",
-  ],
-  codePoints: {
-    speed: "e9e4",
-    arrow_split: "e985",
-    arrow_circle_down: "f181",
-    arrow_circle_up: "f182",
-    counter_1: "f784",
-    counter_2: "f783",
-    counter_3: "f782",
-    ios_share: "e6b8",
-  },
-}
-
-export default config

package.json

@@ -1,53 +1,88 @@
 {
-  "name": "cccs",
+  "name": "charachorder-device-manager",
-  "version": "0.1.0",
+  "version": "1.5.2",
   "license": "AGPL-3.0-or-later",
   "private": true,
+  "engines": {
+    "node": ">=18.16",
+    "pnpm": ">=8.6"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CharaChorder/DeviceManager.git"
+  },
+  "homepage": "https://docs.charachorder.com",
+  "bugs": {
+    "url": "https://github.com/CharaChorder/DeviceManager/issues"
+  },
   "scripts": {
-    "dev": "vite dev",
+    "dev": "npm-run-all --parallel vite typesafe-i18n",
-    "build": "vite build",
+    "dev:external": "npm-run-all --parallel vite:external typesafe-i18n",
+    "dev:tauri": "tauri dev",
+    "vite": "vite dev",
+    "vite:external": "vite --host",
+    "build": "typesafe-i18n --no-watch && vite build",
+    "build:tauri": "tauri build",
+    "tauri": "tauri",
     "test": "vitest run --coverage",
     "preview": "vite preview",
-    "check": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json --watch",
+    "minify-icons": "node src/tools/minify-icon-font.js",
-    "minify-icons": "ts-node-esm src/tools/minify-icon-font.ts",
+    "version": "node src/tools/version.js && git add src-tauri/Cargo.toml && git add src-tauri/tauri.conf.json",
-    "lint": "prettier --plugin-search-dir . --check .",
+    "lint": "prettier --check .",
-    "format": "prettier --plugin-search-dir . --write ."
+    "format": "prettier --write .",
+    "typesafe-i18n": "typesafe-i18n"
   },
   "devDependencies": {
-    "@theaninova/prettier-config": "^1.0.0",
+    "@codemirror/autocomplete": "^6.17.0",
-    "@types/w3c-web-serial": "^1.0.3",
+    "@codemirror/commands": "^6.6.0",
-    "@vite-pwa/sveltekit": "^0.2.5",
+    "@codemirror/lang-javascript": "^6.2.2",
-    "@fontsource-variable/noto-sans-mono": "^5.0.4",
+    "@codemirror/language": "^6.10.2",
-    "@fontsource-variable/material-symbols-rounded": "^5.0.4",
+    "@codemirror/state": "^6.4.1",
-    "stylelint": "^15.9.0",
+    "@codemirror/view": "^6.28.4",
-    "stylelint-config-standard-scss": "^10.0.0",
+    "@fontsource-variable/material-symbols-rounded": "^5.0.34",
-    "stylelint-config-prettier-scss": "^1.0.0",
+    "@fontsource-variable/noto-sans-mono": "^5.0.20",
-    "stylelint-config-html": "^1.1.0",
+    "@lezer/highlight": "^1.2.0",
-    "stylelint-config-recommended-scss": "^12.0.0",
+    "@material/material-color-utilities": "^0.3.0",
-    "stylelint-config-clean-order": "^5.0.1",
+    "@modyfi/vite-plugin-yaml": "^1.1.0",
-    "glob": "^10.3.1",
+    "@sveltejs/adapter-static": "^3.0.2",
-    "flexsearch": "^0.7.31",
+    "@sveltejs/kit": "^2.5.18",
-    "@sveltejs/adapter-static": "^2.0.2",
+    "@sveltejs/vite-plugin-svelte": "^3.1.1",
-    "@sveltejs/kit": "^1.20.4",
+    "@tauri-apps/api": "^1.6.0",
-    "@sveltejs/vite-plugin-svelte": "^2.4.2",
+    "@tauri-apps/cli": "^1.6.0",
-    "jsdom": "^22.1.0",
+    "@types/dom-view-transitions": "^1.0.4",
-    "@material/material-color-utilities": "^0.2.7",
+    "@types/flexsearch": "^0.7.6",
+    "@types/w3c-web-serial": "^1.0.6",
+    "@types/w3c-web-usb": "^1.0.10",
+    "@vite-pwa/sveltekit": "^0.6.0",
+    "autoprefixer": "^10.4.19",
+    "codemirror": "^6.0.1",
+    "cypress": "^13.13.0",
+    "flexsearch": "^0.7.43",
     "fontkit": "^2.0.2",
-    "prettier": "^2.8.0",
+    "glob": "^10.4.3",
-    "prettier-plugin-svelte": "^2.10.1",
+    "jsdom": "^24.1.0",
-    "svelte": "^4.0.0",
+    "npm-run-all": "^4.1.5",
-    "svelte-check": "^3.4.3",
+    "prettier": "^3.3.2",
-    "ts-node": "^10.9.1",
+    "prettier-plugin-svelte": "^3.2.5",
-    "typescript": "^5.0.0",
+    "sass": "^1.77.6",
-    "vitest": "^0.33.0",
+    "stylelint": "^16.6.1",
-    "vite": "^4.3.6",
+    "stylelint-config-clean-order": "^6.1.0",
-    "vite-plugin-pwa": "^0.16.4",
+    "stylelint-config-html": "^1.1.0",
-    "@modyfi/vite-plugin-yaml": "^1.0.4",
+    "stylelint-config-prettier-scss": "^1.0.0",
-    "svelte-preprocess": "^5.0.4",
+    "stylelint-config-recommended-scss": "^14.0.0",
-    "autoprefixer": "^10.4.14",
+    "stylelint-config-standard-scss": "^13.1.0",
-    "sass": "^1.63.6"
+    "svelte": "^4.2.18",
+    "svelte-check": "^3.8.4",
+    "svelte-preprocess": "^6.0.1",
+    "tippy.js": "^6.3.7",
+    "typesafe-i18n": "^5.26.2",
+    "typescript": "^5.5.3",
+    "vite": "^5.3.3",
+    "vite-plugin-mkcert": "^1.17.5",
+    "vite-plugin-pwa": "^0.20.0",
+    "vitest": "^1.6.0",
+    "workbox-window": "^7.1.0"
   },
-  "type": "module",
+  "type": "module"
-  "prettier": "@theaninova/prettier-config"
 }

src-tauri/.gitignore

@@ -0,0 +1,3 @@
+# Generated by Cargo
+# will have compiled files and executables
+/target/

src-tauri/Cargo.toml

@@ -0,0 +1,27 @@
+[package]
+name = "app"
+version = "1.5.2"
+description = "A Tauri App"
+authors = ["Thea Schöbl <dev@theaninova.de>"]
+license = "AGPL-3"
+repository = "https://github.com/Theaninova/dotio"
+default-run = "app"
+edition = "2021"
+rust-version = "1.60"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[build-dependencies]
+tauri-build = { version = "1.4.0", features = [] }
+
+[dependencies]
+serde_json = "1.0"
+serialport = "4.2.1"
+serde = { version = "1.0", features = ["derive"] }
+tauri = { version = "1.4.0", features = ["updater", "devtools"] }
+
+[features]
+# this feature is used for production builds or when `devPath` points to the filesystem and the built-in dev server is disabled.
+# If you use cargo directly instead of tauri's cli you can use this feature flag to switch between tauri's `dev` and `build` modes.
+# DO NOT REMOVE!!
+custom-protocol = [ "tauri/custom-protocol" ]

src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

src-tauri/src/main.rs

@@ -0,0 +1,11 @@
+// Prevents additional console window on Windows in release, DO NOT REMOVE!!
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+mod serial;
+
+fn main() {
+    tauri::Builder::default()
+        .plugin(serial::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}

src-tauri/src/serial.rs

@@ -0,0 +1,99 @@
+use serde::Serialize;
+use serialport::{available_ports, SerialPort, SerialPortType};
+use std::collections::HashMap;
+use std::io::{Read, Write};
+use std::sync::{Arc, Mutex};
+use tauri::plugin::{Builder, TauriPlugin};
+use tauri::{command, generate_handler, Manager, Runtime, State};
+
+pub fn init<R: Runtime>() -> TauriPlugin<R> {
+    Builder::new("serial")
+        .invoke_handler(generate_handler![
+            get_serial_ports,
+            open,
+            close,
+            read,
+            write
+        ])
+        .setup(move |app_handle| {
+            app_handle.manage(SerialState::default());
+            Ok(())
+        })
+        .build()
+}
+
+#[derive(Default)]
+pub struct SerialState {
+    handles: Arc<Mutex<HashMap<String, Box<dyn SerialPort>>>>,
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct WebSerialPortInfo {
+    pub name: String,
+    pub usb_product_id: u16,
+    pub usb_vendor_id: u16,
+    pub serial_number: Option<String>,
+    pub manufacturer: Option<String>,
+    pub product: Option<String>,
+}
+
+#[command]
+fn get_serial_ports() -> Result<Vec<WebSerialPortInfo>, String> {
+    Ok(available_ports()
+        .map_err(|err| err.to_string())?
+        .iter()
+        .filter_map(|port| match &port.port_type {
+            SerialPortType::UsbPort(usb) => Some(WebSerialPortInfo {
+                name: port.port_name.clone(),
+                usb_vendor_id: usb.vid,
+                usb_product_id: usb.pid,
+                serial_number: usb.serial_number.clone(),
+                manufacturer: usb.manufacturer.clone(),
+                product: usb.product.clone(),
+            }),
+            _ => None,
+        })
+        .collect())
+}
+
+#[command]
+fn open(state: State<'_, SerialState>, path: String, baud_rate: u32) -> Result<(), String> {
+    let mut handles = state.handles.lock().map_err(|err| err.to_string())?;
+    if handles.contains_key(&path) {
+        return Ok(());
+    }
+    let port = serialport::new(path.clone(), baud_rate)
+        .open()
+        .map_err(|err| err.to_string())?;
+    handles.insert(path, port);
+
+    Ok(())
+}
+
+#[command]
+fn close(state: State<'_, SerialState>, path: String) -> Result<(), String> {
+    let mut handles = state.handles.lock().map_err(|err| err.to_string())?;
+    handles.remove(&path).ok_or("Port is already closed")?;
+
+    Ok(())
+}
+
+#[command]
+fn read(state: State<'_, SerialState>, path: String) -> Result<Vec<u8>, String> {
+    let mut handles = state.handles.lock().map_err(|err| err.to_string())?;
+    let port = handles.get_mut(&path).ok_or("Read: Port is not open")?;
+
+    let size = port.bytes_to_read().map_err(|err| err.to_string())?;
+    let mut buffer: Vec<u8> = vec![0; size as usize];
+    port.read_exact(buffer.as_mut_slice())
+        .map_err(|err| err.to_string())?;
+    Ok(buffer)
+}
+
+#[command]
+fn write(state: State<'_, SerialState>, path: String, chunk: Vec<u8>) -> Result<(), String> {
+    let mut handles = state.handles.lock().map_err(|err| err.to_string())?;
+    let port = handles.get_mut(&path).ok_or("Write: Port is not open")?;
+    port.write_all(&chunk).map_err(|err| err.to_string())
+}

src-tauri/tauri.conf.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "../node_modules/@tauri-apps/cli/schema.json",
+  "build": {
+    "beforeBuildCommand": "npm run build",
+    "beforeDevCommand": "npm run dev",
+    "devPath": "http://localhost:5173",
+    "distDir": "../build"
+  },
+  "package": { "productName": "amacc1ng", "version": "1.5.2" },
+  "tauri": {
+    "allowlist": { "all": false },
+    "bundle": {
+      "active": true,
+      "category": "DeveloperTool",
+      "copyright": "AGPL-3.0-or-later",
+      "deb": { "depends": [] },
+      "externalBin": [],
+      "icon": [
+        "icons/32x32.png",
+        "icons/128x128.png",
+        "icons/128x128@2x.png",
+        "icons/icon.icns",
+        "icons/icon.ico"
+      ],
+      "identifier": "de.theaninova.chara-app",
+      "longDescription": "",
+      "macOS": {
+        "entitlements": null,
+        "exceptionDomain": "",
+        "frameworks": [],
+        "providerShortName": null,
+        "signingIdentity": null
+      },
+      "resources": [],
+      "shortDescription": "",
+      "targets": "all",
+      "windows": {
+        "certificateThumbprint": null,
+        "digestAlgorithm": "sha256",
+        "timestampUrl": ""
+      }
+    },
+    "security": { "csp": null },
+    "updater": {
+      "active": true,
+      "endpoints": [
+        "https://amacc1ng.theaninova.de/update?current_version={{current_version}}&target={{target}}&arch={{arch}}",
+        "https://dotio.theaninova.de/update?current_version={{current_version}}&target={{target}}&arch={{arch}}"
+      ],
+      "dialog": true,
+      "pubkey": "dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IDU5QjEwMEY5RjNBRjM4MEIKUldRTE9LL3orUUN4V2FMWDZkc2l2VUdOL3FSdUMwTk1ualNac095RVZXVEpqUEtORkFsWGZaTmsK"
+    },
+    "windows": [
+      {
+        "fullscreen": false,
+        "height": 720,
+        "resizable": true,
+        "title": "amacc1ng",
+        "width": 1280
+      }
+    ]
+  }
+}

src/app.d.ts

@@ -11,4 +11,4 @@ declare global {
   }
 }
 
-export {}
+export {};

src/app.html

@@ -1,8 +1,8 @@
-<!DOCTYPE html>
+<!doctype html>
-<html lang="en">
+<html>
   <head>
     <meta charset="utf-8" />
-    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <link rel="icon" href="%sveltekit.assets%/icon.svg" />
     <meta name="viewport" content="width=device-width" />
     %sveltekit.head%
   </head>

src/env.d.ts

@@ -0,0 +1,21 @@
+/// <references types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly TAURI_FAMILY?: string;
+  readonly TAURI_PLATFORM_VERSION?: string;
+  readonly TAURI_TARGET_TRIPLE?: string;
+  readonly TAURI_ARCH?: string;
+  readonly TAURI_DEBUG?: boolean;
+  readonly TAURI_PLATFORM_TYPE?: string;
+
+  readonly VITE_HOMEPAGE_URL: string;
+  readonly VITE_BUGS_URL: string;
+  readonly VITE_DOCS_URL: string;
+  readonly VITE_LEARN_URL: string;
+  readonly VITE_LATEST_FIRMWARE: string;
+  readonly VITE_STORE_URL: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

src/i18n/.gitignore

@@ -0,0 +1 @@
+i18n-*.ts

src/i18n/de/index.ts

@@ -0,0 +1,144 @@
+import type { Translation } from "../i18n-types";
+
+const de = {
+  TITLE: "CharaChorder Gerätemanager",
+  DESCRIPTION: "Gerätemanager und Konfigurationstool für CharaChorder Geräte.",
+  saveActions: {
+    UNDO: "Rückgängig (<kbd class='icon'>shift</kbd> halten um alle Änderungen rückgängig zu machen)",
+    REDO: "Wiederholen",
+    SAVE: "Speichern",
+  },
+  update: {
+    TITLE: "Gerät aktualisieren",
+  },
+  sync: {
+    TITLE_READ: "Neueste Änderungen werden abgerufen",
+    TITLE_WRITE: "Änderungen werden gespeichert",
+    RELOAD: "Neu laden",
+  },
+  backup: {
+    TITLE: "Lokale Kopie",
+    INDIVIDUAL: "Einzeldateien",
+    DISCLAIMER:
+      "Das Backup in diesem Browser gespeichert und bleibt nur auf diesem Computer.",
+    DOWNLOAD: "Alles herunterladen",
+    RESTORE: "Wiederherstellen",
+  },
+  modal: {
+    CLOSE: "Schließen",
+  },
+  actionSearch: {
+    PLACEHOLDER: "Nach Aktionen suchen",
+    CURRENT_ACTION: "Aktuelle Aktion",
+    NEXT_ACTION: "Aktion nach dem nächsten Speichern",
+    DELETE: "Entfernen",
+    filter: {
+      ALL: "Alle",
+    },
+    LIVE_LAYOUT_INFO:
+      "Diese Aktion wurde auf Basis des Systemtastaturlayouts ermittelt.",
+    SHIFT_WARNING: "Diese Aktion hält <kbd class='icon'>shift</kbd>",
+    ALT_CODE_WARNING: "Dieses Alt-Code Makro funktioniert nur unter Windows",
+  },
+  share: {
+    TITLE: "Teilen",
+    URL_COPIED: "Teilbare URL kopiert!",
+    EXTRA_DOWNLOAD: "Als Datei herunterladen",
+  },
+  print: {
+    TITLE: "Drucken",
+  },
+  profile: {
+    TITLE: "Profil",
+    LANGUAGE: "Sprache",
+    theme: {
+      TITLE: "Darstellung",
+      COLOR_SCHEME: "Farbschema",
+      DARK_MODE: "Dunkel",
+      LIGHT_MODE: "Hell",
+    },
+  },
+  deviceManager: {
+    TITLE: "Gerät",
+    AUTO_CONNECT: "Automatisch Verbinden",
+    CONNECT: "Verbinden",
+    DISCONNECT: "Entfernen",
+    TERMINAL: "Konsole",
+    APPLY_SETTINGS: "Änderungen auf das Gerät brennen",
+    NO_DEVICE: "Kein Gerät verbunden",
+    LINUX_PERMISSIONS:
+      "Auf den meisten Linux-basierten Systemen müssen zuerst Berechtigungen angepasst werden. Flatpak und Snap Anwendungen benötigen zusätzliche Berechtigungen oder funktionieren möglicherweise gar nicht.",
+    bootMenu: {
+      TITLE: "Bootmenü",
+      REBOOT: "Neustarten",
+      BOOTLOADER: "Bootloader",
+      POWER_WARNING:
+        "Um vom Bootloader aus neu zu starten muss das Gerät neu verbunden werden.",
+    },
+  },
+  browserWarning: {
+    TITLE: "Warnung",
+    INFO_SERIAL_PREFIX:
+      "Der aktuell genutzte Browser wird aufgrund der speziellen Voraussetzung für Kommunikation über die ",
+    INFO_SERIAL_INFIX: "serielle Schnittstelle",
+    INFO_SERIAL_SUFFIX: " nicht unterstützt.",
+    INFO_BROWSER_PREFIX:
+      "Auch wenn alle Chromium-basieren Desktop Browser diese Voraussetzung grundsätzlich erfüllen, haben einige Browser ",
+    INFO_BROWSER_INFIX: "wie zum Beispiel Brave",
+    INFO_BROWSER_SUFFIX:
+      " sich bewusst dazu entschieden die API zu deaktivieren.",
+    DOWNLOAD_APP:
+      "Chrome oder Edge werden offiziell unterstützt, andere Browser könnten aber auch funktionieren.",
+  },
+  changes: {
+    TITLE: "Änderungen importieren",
+    ALL_CHANGES: "Alle Änderungen",
+    layout: {
+      TITLE: "{0} veränderte Belegung{{:|en}}",
+      LAYER: "{changes} Belegung{{changes:|en}} in Ebene {layer} ändern",
+    },
+    settings: {
+      TITLE: "{0} Einstellung{{|en}} anpassen",
+    },
+    chords: {
+      TITLE: "{0} Akkorde",
+      NEW_CHORDS: "{0} neue Akkord{{|e}} hinzufügen",
+      CHANGED_CHORDS: "{0} Akkord{{|e}} ersetzen",
+      DELETED_CHORDS: "{0} Akkord{{|e}} zum löschen markieren",
+    },
+  },
+  configure: {
+    chords: {
+      TITLE: "Akkorde",
+      HOLD_KEYS: "Akkord halten",
+      NEW_CHORD: "Neuer Akkord",
+      DUPLICATE: "Akkord existiert bereits",
+      search: {
+        PLACEHOLDER: "{0} Akkord{{|e}} durchsuchen",
+        NO_RESULTS: "Keine Ergebnisse",
+      },
+      conflict: {
+        TITLE: "Akkordkonflikt",
+        DESCRIPTION:
+          "Der Akkord würde einen bereits existierenden Akkord überschreiben. Wirklich fortfahren?",
+        CONFIRM: "Überschreiben",
+        ABORT: "Überspringen",
+      },
+      VOCABULARY: "Vokabelliste",
+      TRY_TYPING: "Versuche hier zu tippen",
+    },
+    layout: {
+      TITLE: "Layout",
+    },
+    settings: {
+      TITLE: "Einstellungen",
+    },
+  },
+  plugin: {
+    editor: {
+      RUN: "Ausführen",
+    },
+  },
+} satisfies Translation;
+
+export default de;

src/i18n/en/index.ts

@@ -0,0 +1,143 @@
+import type { BaseTranslation } from "../i18n-types";
+
+const en = {
+  TITLE: "CharaChorder Device Manager",
+  DESCRIPTION:
+    "The device manager and configuration tool for CharaChorder devices.",
+  saveActions: {
+    UNDO: "Undo (hold <kbd class='icon'>shift</kbd> to undo all changes)",
+    REDO: "Redo",
+    SAVE: "Save",
+  },
+  update: {
+    TITLE: "Update your device",
+  },
+  backup: {
+    TITLE: "Local backup",
+    INDIVIDUAL: "Individual backups",
+    DISCLAIMER:
+      "A backup is made and stored in this browser, and always remains only on your computer.",
+    DOWNLOAD: "Download Everything",
+    RESTORE: "Restore",
+  },
+  sync: {
+    TITLE_READ: "Reading latest changes",
+    TITLE_WRITE: "Saving changes to device",
+    RELOAD: "Reload",
+  },
+  modal: {
+    CLOSE: "Close",
+  },
+  actionSearch: {
+    PLACEHOLDER: "Search for actions",
+    CURRENT_ACTION: "Current action",
+    NEXT_ACTION: "Action after next save",
+    DELETE: "Remove",
+    filter: {
+      ALL: "All",
+    },
+    LIVE_LAYOUT_INFO: "This output was determined using on your system layout.",
+    SHIFT_WARNING: "This action holds <kbd class='icon'>shift</kbd>",
+    ALT_CODE_WARNING: "This alt-code macro only works on Windows",
+  },
+  share: {
+    TITLE: "Share",
+    URL_COPIED: "Sharable URL copied!",
+    EXTRA_DOWNLOAD: "Download as file",
+  },
+  print: {
+    TITLE: "Print",
+  },
+  profile: {
+    TITLE: "Profile",
+    LANGUAGE: "Language",
+    theme: {
+      TITLE: "Theme",
+      COLOR_SCHEME: "Color scheme",
+      DARK_MODE: "Dark",
+      LIGHT_MODE: "Light",
+    },
+  },
+  deviceManager: {
+    TITLE: "Device",
+    AUTO_CONNECT: "Auto-connect",
+    CONNECT: "Connect",
+    DISCONNECT: "Disconnect",
+    TERMINAL: "Terminal",
+    APPLY_SETTINGS: "Flash changes to device",
+    NO_DEVICE: "No device connected",
+    LINUX_PERMISSIONS:
+      "Most Linux based systems need adjusted permissions in order to connect your device. Flatpak or Snap versions in particular might need additional permissions or may not work at all.",
+    bootMenu: {
+      TITLE: "Boot Menu",
+      REBOOT: "Reboot",
+      BOOTLOADER: "Bootloader",
+      POWER_WARNING:
+        "To reboot from bootloader you need to physically reconnect your device.",
+    },
+  },
+  browserWarning: {
+    TITLE: "Warning",
+    INFO_SERIAL_PREFIX:
+      "Your current browser is not supported due to this site's unique requirement for ",
+    INFO_SERIAL_INFIX: "serial connections",
+    INFO_SERIAL_SUFFIX: ".",
+    INFO_BROWSER_PREFIX:
+      "Though all chromium-based desktop browsers fulfill this requirement, some derivations such as Brave ",
+    INFO_BROWSER_INFIX: "have been known to disable the API intentionally",
+    INFO_BROWSER_SUFFIX: ".",
+    DOWNLOAD_APP:
+      "Chrome or Edge are officially supported, but other browsers might work as well.",
+  },
+  changes: {
+    TITLE: "Import changes",
+    ALL_CHANGES: "All changes",
+    layout: {
+      TITLE: "{0} layout change{{|s}}",
+      LAYER: "Update {changes} key{{changes:|s}} in layer {layer}",
+    },
+    settings: {
+      TITLE: "Update {0} setting{{|s}}",
+    },
+    chords: {
+      TITLE: "{0} chords",
+      NEW_CHORDS: "Add {0} new chord{{|s}}",
+      CHANGED_CHORDS: "Replace {0} chord{{|s}}",
+      DELETED_CHORDS: "Mark {0} chord{{|s}} for deletion",
+    },
+  },
+  configure: {
+    chords: {
+      TITLE: "Chords",
+      HOLD_KEYS: "Hold chord",
+      NEW_CHORD: "New chord",
+      DUPLICATE: "Chord already exists",
+      search: {
+        PLACEHOLDER: "Search {0} chord{{|s}}",
+        NO_RESULTS: "No results",
+      },
+      conflict: {
+        TITLE: "Chord conflict",
+        DESCRIPTION:
+          "Your chord conflicts with an existing chord. Are you sure you want to overwrite this chord?",
+        CONFIRM: "Overwrite",
+        ABORT: "Skip",
+      },
+      VOCABULARY: "Vocabulary",
+      TRY_TYPING: "Try typing here",
+    },
+    layout: {
+      TITLE: "Layout",
+    },
+    settings: {
+      TITLE: "Settings",
+    },
+  },
+  plugin: {
+    editor: {
+      RUN: "Run",
+    },
+  },
+} satisfies BaseTranslation;
+
+export default en;

src/i18n/formatters.ts

@@ -0,0 +1,12 @@
+import type { FormattersInitializer } from "typesafe-i18n";
+import type { Locales, Formatters } from "./i18n-types";
+
+export const initFormatters: FormattersInitializer<Locales, Formatters> = (
+  _locale: Locales,
+) => {
+  const formatters: Formatters = {
+    // add your formatter functions here
+  };
+
+  return formatters;
+};

src/lib/assets/keymaps/action-codes.yml

@@ -1,67 +0,0 @@
-name: Action Codes
-description: 10-bit action codes 0x00-0x1F
-actions:
-  0x00:
-    id: "0x00"
-  0x01:
-    id: "0x01"
-  0x02:
-    id: "0x02"
-  0x03:
-    id: "0x03"
-  0x04:
-    id: "0x04"
-  0x05:
-    id: "0x05"
-  0x06:
-    id: "0x06"
-  0x07:
-    id: "0x07"
-  0x08:
-    id: "0x08"
-  0x09:
-    id: "0x09"
-  0x0A:
-    id: "0x0A"
-  0x0B:
-    id: "0x0B"
-  0x0C:
-    id: "0x0C"
-  0x0D:
-    id: "0x0D"
-  0x0E:
-    id: "0x0E"
-  0x0F:
-    id: "0x0F"
-  0x10:
-    id: "0x10"
-  0x11:
-    id: "0x11"
-  0x12:
-    id: "0x12"
-  0x13:
-    id: "0x13"
-  0x14:
-    id: "0x14"
-  0x15:
-    id: "0x15"
-  0x16:
-    id: "0x16"
-  0x17:
-    id: "0x17"
-  0x18:
-    id: "0x18"
-  0x19:
-    id: "0x19"
-  0x1A:
-    id: "0x1A"
-  0x1B:
-    id: "0x1B"
-  0x1C:
-    id: "0x1C"
-  0x1D:
-    id: "0x1D"
-  0x1E:
-    id: "0x1E"
-  0x1F:
-    id: "0x1F"

src/lib/assets/keymaps/ascii-macros.yml

@@ -0,0 +1,144 @@
+name: ASCII Macros
+description: ASCII Characters that are macros for SHFT + key
+actions:
+  33:
+    id: "!"
+    title: Exclamation Point
+  34:
+    id: '"'
+    title: Double Quote
+  35:
+    id: "#"
+    title: Hash Symbol
+  36:
+    id: "$"
+    title: Dollar Sign
+  37:
+    id: "%"
+    title: Percent
+  38:
+    id: "&"
+    title: Ampersand
+  40:
+    id: "("
+    title: Opening Parenthesis
+  41:
+    id: ")"
+    title: Closing Parenthesis
+  42:
+    id: "*"
+    title: Asterisk
+  43:
+    id: "+"
+    title: Plus
+  58:
+    id: ":"
+    title: Colon
+  60:
+    id: "<"
+    title: Less Than
+  62:
+    id: ">"
+    title: Greater Than
+  63:
+    id: "?"
+    title: Question Mark
+  64:
+    id: "@"
+    title: At Symbol
+  65:
+    id: "A"
+    title: Uppercase A
+  66:
+    id: "B"
+    title: Uppercase B
+  67:
+    id: "C"
+    title: Uppercase C
+  68:
+    id: "D"
+    title: Uppercase D
+  69:
+    id: "E"
+    title: Uppercase E
+  70:
+    id: "F"
+    title: Uppercase F
+  71:
+    id: "G"
+    title: Uppercase G
+  72:
+    id: "H"
+    title: Uppercase H
+  73:
+    id: "I"
+    title: Uppercase I
+  74:
+    id: "J"
+    title: Uppercase J
+  75:
+    id: "K"
+    title: Uppercase K
+  76:
+    id: "L"
+    title: Uppercase L
+  77:
+    id: "M"
+    title: Uppercase M
+  78:
+    id: "N"
+    title: Uppercase N
+  79:
+    id: "O"
+    title: Uppercase O
+  80:
+    id: "P"
+    title: Uppercase P
+  81:
+    id: "Q"
+    title: Uppercase Q
+  82:
+    id: "R"
+    title: Uppercase R
+  83:
+    id: "S"
+    title: Uppercase S
+  84:
+    id: "T"
+    title: Uppercase T
+  85:
+    id: "U"
+    title: Uppercase U
+  86:
+    id: "V"
+    title: Uppercase V
+  87:
+    id: "W"
+    title: Uppercase W
+  88:
+    id: "X"
+    title: Uppercase X
+  89:
+    id: "Y"
+    title: Uppercase Y
+  90:
+    id: "Z"
+    title: Uppercase Z
+  94:
+    id: "^"
+    title: Caret
+  95:
+    id: "_"
+    title: Underscore
+  123:
+    id: "{"
+    title: Left Curly Brace
+  124:
+    id: "|"
+    title: Pipe
+  125:
+    id: "}"
+    title: Right Curly Brace
+  126:
+    id: "~"
+    title: Tilde

src/lib/assets/keymaps/ascii.yml

@@ -7,39 +7,9 @@ actions:
     description: |
       While SPACE is used for keymaps and chord, just a " " is used in chord outputs.
       This action is unique in this way. Technically it is "printable", but it is not visible.
-  33:
-    id: "!"
-    title: Exclamation Point
-  34:
-    id: '"'
-    title: Double Quote
-  35:
-    id: "#"
-    title: Hash Symbol
-  36:
-    id: "$"
-    title: Dollar Sign
-  37:
-    id: "%"
-    title: Percent
-  38:
-    id: "&"
-    title: Ampersand
   39:
     id: "'"
     title: Single Quote
-  40:
-    id: "("
-    title: Opening Parenthesis
-  41:
-    id: ")"
-    title: Closing Parenthesis
-  42:
-    id: "*"
-    title: Asterisk
-  43:
-    id: "+"
-    title: Plus
   44:
     id: ","
     title: Comma
@@ -82,105 +52,12 @@ actions:
   57:
     id: "9"
     title: Nine
-  58:
-    id: ":"
-    title: Colon
   59:
     id: ";"
     title: Semicolon
-  60:
-    id: "<"
-    title: Less Than
   61:
     id: "="
     title: Equals
-  62:
-    id: ">"
-    title: Greater Than
-  63:
-    id: "?"
-    title: Question Mark
-  64:
-    id: "@"
-    title: At Symbol
-  65:
-    id: "A"
-    title: Uppercase A
-  66:
-    id: "B"
-    title: Uppercase B
-  67:
-    id: "C"
-    title: Uppercase C
-  68:
-    id: "D"
-    title: Uppercase D
-  69:
-    id: "E"
-    title: Uppercase E
-  70:
-    id: "F"
-    title: Uppercase F
-  71:
-    id: "G"
-    title: Uppercase G
-  72:
-    id: "H"
-    title: Uppercase H
-  73:
-    id: "I"
-    title: Uppercase I
-  74:
-    id: "J"
-    title: Uppercase J
-  75:
-    id: "K"
-    title: Uppercase K
-  76:
-    id: "L"
-    title: Uppercase L
-  77:
-    id: "M"
-    title: Uppercase M
-  78:
-    id: "N"
-    title: Uppercase N
-  79:
-    id: "O"
-    title: Uppercase O
-  80:
-    id: "P"
-    title: Uppercase P
-  81:
-    id: "Q"
-    title: Uppercase Q
-  82:
-    id: "R"
-    title: Uppercase R
-  83:
-    id: "S"
-    title: Uppercase S
-  84:
-    id: "T"
-    title: Uppercase T
-  85:
-    id: "U"
-    title: Uppercase U
-  86:
-    id: "V"
-    title: Uppercase V
-  87:
-    id: "W"
-    title: Uppercase W
-  88:
-    id: "X"
-    title: Uppercase X
-  89:
-    id: "Y"
-    title: Uppercase Y
-  90:
-    id: "Z"
-    title: Uppercase Z
   91:
     id: "["
     title: Left Bracket
@@ -190,12 +67,6 @@ actions:
   93:
     id: "]"
     title: Right Bracket
-  94:
-    id: "^"
-    title: Caret
-  95:
-    id: "_"
-    title: Underscore
   96:
     id: "`"
     title: Backtick
@@ -277,19 +148,6 @@ actions:
   122:
     id: "z"
     title: Lowercase z
-  123:
-    id: "{"
-    title: Left Curly Brace
-  124:
-    id: "|"
-    title: Pipe
-  125:
-    id: "}"
-    title: Right Curly Brace
-  126:
-    id: "~"
-    title: Tilde
   127:
     id: "DEL"
     title: Delete
-    icon: delete_forever

src/lib/assets/keymaps/chara-chorder-one.yml

@@ -6,34 +6,73 @@ type: unassigned
 actions:
   600:
     id: "LH_THUMB_3_3D"
-    title: Left Hand Thumb Top 3D Click
+    title: "Left Hand Thumb Bottom 3D Click"
+    icon: "adjust"
   601:
     id: "LH_THUMB_2_3D"
-    title: Left Hand Thumb Middle 3D Click
+    title: "Left Hand Thumb Middle 3D Click"
+    icon: "adjust"
   602:
     id: "LH_THUMB_1_3D"
-    title: Left Hand Thumb Bottom 3D Click
+    title: "Left Hand Thumb Top 3D Click"
+    icon: "adjust"
   603:
     id: "LH_INDEX_3D"
-    title: Left Hand Index Finger 3D Click
+    title: "Left Hand Index Finger 3D Click"
+    icon: "adjust"
   604:
     id: "LH_MID_1_3D"
-    title: Left Hand Middle Finger 3D Click
+    title: "Left Hand Middle Finger 3D Click"
+    icon: "adjust"
   605:
     id: "LH_RING_1_3D"
-    title: Left Hand Ring Finger 3D Click
+    title: "Left Hand Ring Finger 3D Click"
+    icon: "adjust"
   606:
     id: "LH_PINKY_3D"
-    title: Left Hand Pinky 3D Click,
+    title: "Left Hand Pinky 3D Click"
-  # TODO...
+    icon: "adjust"
-  # ["607", "CharaChorder One", "LH_MID_2_3D", "", ""],
+  607:
-  # ["608", "CharaChorder One", "LH_RING_2_3D", "", ""],
+    id: "LH_MID_2_3D"
-  # ["609", "CharaChorder One", "RH_THUMB_3_3D", "", ""],
+    title: "Left Hand Middle Finger 2 3D Click"
-  # ["610", "CharaChorder One", "RH_THUMB_2_3D", "", ""],
+    icon: "adjust"
-  # ["611", "CharaChorder One", "RH_THUMB_1_3D", "", ""],
+  608:
-  # ["612", "CharaChorder One", "RH_INDEX_3D", "", ""],
+    id: "LH_RING_2_3D"
-  # ["613", "CharaChorder One", "RH_MID_1_3D", "", ""],
+    title: "Left Hand Ring Finger 2 3D Click"
-  # ["614", "CharaChorder One", "RH_RING_1_3D", "", ""],
+    icon: "adjust"
-  # ["615", "CharaChorder One", "RH_PINKY_3D", "", ""],
+  609:
-  # ["616", "CharaChorder One", "RH_MID_2_3D", "", ""],
+    id: "RH_THUMB_3_3D"
-  # ["617", "CharaChorder One", "RH_RING_2_3D", "", ""]
+    title: "Right Hand Thumb Bottom 3D Click"
+    icon: "adjust"
+  610:
+    id: "RH_THUMB_2_3D"
+    title: "Right Hand Thumb Middle 3D Click"
+    icon: "adjust"
+  611:
+    id: "RH_THUMB_1_3D"
+    title: "Right Hand Thumb Top 3D Click"
+    icon: "adjust"
+  612:
+    id: "RH_INDEX_3D"
+    title: "Right Hand Index Finger 3D Click"
+    icon: "adjust"
+  613:
+    id: "RH_MID_1_3D"
+    title: "Right Hand Middle Finger 3D Click"
+    icon: "adjust"
+  614:
+    id: "RH_RING_1_3D"
+    title: "Right Hand Ring Finger 3D Click"
+    icon: "adjust"
+  615:
+    id: "RH_PINKY_3D"
+    title: "Right Hand Pinky 3D Click"
+    icon: "adjust"
+  616:
+    id: "RH_MID_2_3D"
+    title: "Right Hand Middle Finger 2 3D Click"
+    icon: "adjust"
+  617:
+    id: "RH_RING_2_3D"
+    title: "Right Hand Ring Finger 2 3D Click"
+    icon: "adjust"

src/lib/assets/keymaps/chara-chorder.yml

@@ -1,6 +1,9 @@
 name: CharaChorder
 description: CharaChorder specific actions
 actions:
+  0:
+    id: "NO_ACTION"
+    display: "No Action"
   528:
     id: "RESTART"
     title: Restart Device
@@ -26,7 +29,7 @@ actions:
   536:
     id: "DUP"
     title: Repeat Last Note
-    icon: control_point_duplicate
+    icon: copy_all
     description: |
       In character entry, it repeats your last input.
       In chorded entry, it is used for words with repeating letters.
@@ -58,6 +61,7 @@ actions:
   544:
     variantOf: 36
     id: "SPACERIGHT"
+    display: " "
     title: Right Spacebar (eg CC Lite)
     icon: space_bar
     variant: right
@@ -66,6 +70,9 @@ actions:
     title: Primary Keymap
     icon: counter_1
     variant: left
+    description: |
+      Acts as a toggle if the same action is not assigned
+      to the target layer
   549:
     variantOf: 548
     <<: *primary_keymap
@@ -76,6 +83,9 @@ actions:
     title: Numeric Layer
     icon: counter_2
     variant: left
+    description: |
+      Acts as a toggle if the same action is not assigned
+      to the target layer
   551:
     variantOf: 550
     <<: *secondary_keymap
@@ -86,8 +96,27 @@ actions:
     title: Function Layer
     icon: counter_3
     variant: left
+    description: |
+      Acts as a toggle if the same action is not assigned
+      to the target layer
   553:
     variationOf: 552
     <<: *tertiary_keymap
     id: "KM_3_R"
     variant: right
+  576:
+    id: ACTION_DELAY_1000
+    icon: clock_loader_90
+    description: Wait for one second
+  577:
+    id: ACTION_DELAY_100
+    icon: clock_loader_60
+    description: Wait for 100 milliseconds
+  578:
+    id: ACTION_DELAY_10
+    icon: clock_loader_40
+    description: Wait for 10 milliseconds
+  579:
+    id: ACTION_DELAY_1
+    icon: clock_loader_10
+    description: Wait for one millisecond

src/lib/assets/keymaps/keyboard.yml

@@ -4,41 +4,52 @@ icon: keyboard
 actions:
   512: &left_ctrl
     id: "LEFT_CTRL"
+    display: CTRL
     title: Control Keyboard Modifier
+    keyCode: ControlLeft
     variant: left
-    icon: keyboard_control_key
   513: &left_shift
     id: "LEFT_SHIFT"
     title: Shift Keyboard Modifier
+    keyCode: ShiftLeft
     variant: left
     icon: shift
   514: &left_alt
     id: "LEFT_ALT"
+    display: ALT
     title: Alt Keyboard Modifier
+    keyCode: AltLeft
     variant: left
-    icon: keyboard_option_key
   515: &left_gui
     id: "LEFT_GUI"
     title: GUI Keyboard Modifier
+    keyCode: MetaLeft
+    icon: apps
     variant: left
-    icon: keyboard_command_key
   516:
     variationOf: 512
     <<: *left_ctrl
     id: "RIGHT_CTRL"
+    keyCode: ControlRight
     variant: right
   517:
     variationOf: 513
     <<: *left_shift
     id: "RIGHT_SHIFT"
+    keyCode: ShiftRight
+    variant: right
   518:
     variationOf: 514
     <<: *left_alt
     id: "RIGHT_ALT"
+    keyCode: AltRight
+    variant: right
   519:
     variationOf: 515
     <<: *left_gui
     id: "RIGHT_GUI"
+    keyCode: MetaRight
+    variant: right
   520:
     id: "RELEASE_MOD"
     title: Release all keyboard modifiers
@@ -51,3 +62,11 @@ actions:
     id: "RELEASE_KEYS"
     title: Release all keys, but not keyboard modifiers
     icon: text_rotate_up
+  523:
+    id: "PRESS_NEXT"
+    title: "Press and do not release the next key/action"
+    icon: download
+  524:
+    id: "RELEASE_NEXT"
+    title: "Release the next key/action in the sequence"
+    icon: upload

src/lib/assets/keymaps/keymap.d.ts

@@ -1,16 +1,19 @@
 export interface KeymapCategory {
-  name: string
+  name: string;
-  description: string
+  description: string;
-  icon?: string
+  icon?: string;
-  type?: "unassigned"
+  display?: string;
-  actions: Record<number, Partial<ActionInfo>>
+  type?: "unassigned";
+  actions: Record<number, Partial<ActionInfo>>;
 }
 
 export interface ActionInfo {
-  id: string
+  id: string;
-  title: string
+  title: string;
-  icon: string
+  icon: string;
-  description: string
+  display: string;
-  variant: "left" | "right"
+  description: string;
-  variantOf: number
+  variant: "left" | "right";
+  variantOf: number;
+  keyCode: string;
 }

src/lib/assets/keymaps/scancode.yml

@@ -1,9 +1,11 @@
-name: Raw Scancodes
+name: Key codes
-description: Raw Keyboard Scancodes
+description: OS-Layout sensitive keycodes
 actions:
   256:
     id: "KSC_00"
+    icon: block
     title: No Key Pressed
+    description: Also commonly used at the end of a chord to remove auto-spaces
   257:
     id: "KSC_01"
     title: Keyboard Error Roll Over
@@ -15,322 +17,421 @@ actions:
     title: Keyboard Error Undefined
   260:
     id: "KEY_A"
+    keyCode: "KeyA"
     title: Keyboard a and A (US English)
     description: Non US English keyboard users may prefer these Raw Scancodes
   261:
     id: "KEY_B"
+    keyCode: "KeyB"
     title: Keyboard b and B (US English)
   262:
     id: "KEY_C"
+    keyCode: "KeyC"
     title: Keyboard c and C (US English)
   263:
     id: "KEY_D"
+    keyCode: "KeyD"
     title: Keyboard d and D (US English)
   264:
     id: "KEY_E"
+    keyCode: "KeyE"
     title: Keyboard e and E (US English)
   265:
     id: "KEY_F"
+    keyCode: "KeyF"
     title: Keyboard f and F (US English)
   266:
     id: "KEY_G"
+    keyCode: "KeyG"
     title: Keyboard g and G (US English)
   267:
     id: "KEY_H"
+    keyCode: "KeyH"
     title: Keyboard h and H (US English)
   268:
     id: "KEY_I"
+    keyCode: "KeyI"
     title: Keyboard i and I (US English)
   269:
     id: "KEY_J"
+    keyCode: "KeyJ"
     title: Keyboard j and J (US English)
   270:
     id: "KEY_K"
+    keyCode: "KeyK"
     title: Keyboard k and K (US English)
   271:
     id: "KEY_L"
+    keyCode: "KeyL"
     title: Keyboard l and L (US English)
   272:
     id: "KEY_M"
+    keyCode: "KeyM"
     title: Keyboard m and M (US English)
   273:
     id: "KEY_N"
+    keyCode: "KeyN"
     title: Keyboard n and N (US English)
   274:
     id: "KEY_O"
+    keyCode: "KeyO"
     title: Keyboard o and O (US English)
   275:
     id: "KEY_P"
+    keyCode: "KeyP"
     title: Keyboard p and P (US English)
   276:
     id: "KEY_Q"
+    keyCode: "KeyQ"
     title: Keyboard q and Q (US English)
   277:
     id: "KEY_R"
+    keyCode: "KeyR"
     title: Keyboard r and R (US English)
   278:
     id: "KEY_S"
+    keyCode: "KeyS"
     title: Keyboard s and S (US English)
   279:
     id: "KEY_T"
+    keyCode: "KeyT"
     title: Keyboard t and T (US English)
   280:
     id: "KEY_U"
+    keyCode: "KeyU"
     title: Keyboard u and U (US English)
   281:
     id: "KEY_V"
+    keyCode: "KeyV"
     title: Keyboard v and V (US English)
   282:
     id: "KEY_W"
+    keyCode: "KeyW"
     title: Keyboard w and W (US English)
   283:
     id: "KEY_X"
+    keyCode: "KeyX"
     title: Keyboard x and X (US English)
   284:
     id: "KEY_Y"
+    keyCode: "KeyY"
     title: Keyboard y and Y (US English)
   285:
     id: "KEY_Z"
+    keyCode: "KeyZ"
     title: Keyboard z and Z (US English)
   286:
     id: "KEY_1"
+    keyCode: "Digit1"
     title: Keyboard 1 and ! (US English)
   287:
     id: "KEY_2"
+    keyCode: "Digit2"
     title: Keyboard 2 and @ (US English)
   288:
     id: "KEY_3"
+    keyCode: "Digit3"
     title: Keyboard 3 and # (US English)
   289:
     id: "KEY_4"
+    keyCode: "Digit4"
     title: Keyboard 4 and $ (US English)
   290:
     id: "KEY_5"
+    keyCode: "Digit5"
     title: Keyboard 5 and % (US English)
   291:
     id: "KEY_6"
+    keyCode: "Digit6"
     title: Keyboard 6 and ^ (US English)
   292:
     id: "KEY_7"
+    keyCode: "Digit7"
     title: Keyboard 7 and & (US English)
   293:
     id: "KEY_8"
+    keyCode: "Digit8"
     title: Keyboard 8 and * (US English)
   294:
     id: "KEY_9"
+    keyCode: "Digit9"
     title: Keyboard 9 and ( (US English)
   295:
     id: "KEY_0"
+    keyCode: "Digit0"
     title: Keyboard 0 and ) (US English)
   296:
     id: "ENTER"
+    keyCode: "Enter"
     title: Keyboard Return (US English)
     icon: keyboard_return
   297:
     id: "ESC"
+    keyCode: "Escape"
     title: Keyboard Escape (US English)
   298:
     id: "BKSP"
+    keyCode: "Backspace"
     title: Keyboard Backspace (US English)
     icon: backspace
   299:
     id: "TAB"
+    keyCode: "Tab"
     title: Keyboard Tab (US English)
     icon: keyboard_tab
   300:
     id: "KSC_2C"
+    keyCode: "Space"
     title: Keyboard Space (US English)
     description: |
       The ASCII space is preferred over this raw scancode for the space bar.
     icon: space_bar
   301:
     id: "KSC_2D"
+    keyCode: "Minus"
     title: Keyboard - and _ (US English)
   302:
     id: "KSC_2E"
+    keyCode: "Equal"
     title: Keyboard = and + (US English)
   303:
     id: "KSC_2F"
+    keyCode: "BracketLeft"
     title: Keyboard [ and { (US English)
   304:
     id: "KSC_30"
+    keyCode: "BracketRight"
     title: Keyboard ] and } (US English)
   305:
     id: "KSC_31"
+    keyCode: "Backslash"
     title: Keyboard \ and | (US English)
   306:
     id: "KSC_32"
+    # TODO: also backslash?
     title: Keyboard Non-US \# and ~ (US English)
   307:
     id: "KSC_33"
+    keyCode: "Semicolon"
     title: "Keyboard ; and : (US English)"
   308:
     id: "KSC_34"
+    keyCode: "Quote"
     title: Keyboard ' and " (US English)
   309:
     id: "KSC_35"
+    keyCode: "Backquote"
     title: Keyboard ` and ~ (US English)
   310:
     id: "KSC_36"
+    keyCode: "Comma"
     title: Keyboard , and < (US English)
   311:
     id: "KSC_37"
+    keyCode: "Period"
     title: Keyboard . and > (US English)
   312:
     id: "KSC_38"
+    keyCode: "Slash"
     title: Keyboard / and ? (US English)
   313:
     id: "CAPSLOCK"
+    keyCode: "CapsLock"
     title: Keyboard Caps Lock
     icon: shift_lock
   314:
     id: "F1"
+    keyCode: "F1"
     title: Keyboard F1
   315:
     id: "F2"
+    keyCode: "F2"
     title: Keyboard F2
   316:
     id: "F3"
+    keyCode: "F3"
     title: Keyboard F3
   317:
     id: "F4"
+    keyCode: "F4"
     title: Keyboard F4
   318:
     id: "F5"
+    keyCode: "F5"
     title: Keyboard F5
   319:
     id: "F6"
+    keyCode: "F6"
     title: Keyboard F6
   320:
     id: "F7"
+    keyCode: "F7"
     title: Keyboard F7
   321:
     id: "F8"
+    keyCode: "F8"
     title: Keyboard F8
   322:
     id: "F9"
+    keyCode: "F9"
     title: Keyboard F9
   323:
     id: "F10"
+    keyCode: "F10"
     title: Keyboard F10
   324:
     id: "F11"
+    keyCode: "F11"
     title: Keyboard F11
   325:
     id: "F12"
+    keyCode: "F12"
     title: Keyboard F12
   326:
     id: "PRTSCN"
+    keyCode: "PrintScreen"
     title: Keyboard Print Screen
     icon: screenshot_monitor
   327:
     id: "SCRLK"
+    keyCode: "ScrollLock"
     title: Keyboard Scroll Lock
   328:
     id: "PAUSE"
+    keyCode: "Pause"
     title: Keyboard Pause
   329:
     id: "INSERT"
+    keyCode: "Insert"
     title: Keyboard Insert
     icon: insert_text
   330:
     id: "HOME"
+    keyCode: "Home"
     title: Keyboard Home
     icon: home
   331:
     id: "PGUP"
+    keyCode: "PageUp"
     title: Keyboard Page Up
     icon: move_up
   332:
     id: "DELETE"
+    keyCode: "Delete"
     title: Keyboard Delete Forward
   333:
     id: "END"
+    keyCode: "End"
     title: Keyboard End
   334:
     id: "PGDN"
+    keyCode: "PageDown"
     title: Keyboard Page Down
     icon: move_down
   335:
     id: "ARROW_RT"
+    keyCode: "ArrowRight"
     title: Keyboard Right Arrow
     icon: keyboard_arrow_right
   336:
     id: "ARROW_LF"
+    keyCode: "ArrowLeft"
     title: Keyboard Left Arrow
     icon: keyboard_arrow_left
   337:
     id: "ARROW_DN"
+    keyCode: "ArrowDown"
     title: Keyboard Down Arrow
     icon: keyboard_arrow_down
   338:
     id: "ARROW_UP"
+    keyCode: "ArrowUp"
     title: Keyboard Up Arrow
     icon: keyboard_arrow_up
   339:
     id: "NUMLOCK"
+    keyCode: "NumLock"
     title: Keyboard Num Lock and Clear
   340:
     id: "KP_SLASH"
+    keyCode: "NumpadDivide"
     title: Keypad /
   341:
     id: "KP_ASTER"
+    keyCode: "NumpadStar"
     title: Keypad *
   342:
     id: "KP_MINUS"
+    keyCode: "NumpadSubtract"
     title: Keypad -
   343:
     id: "KP_PLUS"
+    keyCode: "NumpadAdd"
     title: Keypad +
   344:
     id: "KP_ENTER"
+    keyCode: "NumpadEnter"
     title: Keypad Enter
   345:
     id: "KP_1"
+    keyCode: "Numpad1"
     title: Keypad 1 and End
   346:
     id: "KP_2"
+    keyCode: "Numpad2"
     title: Keypad 2 and Down Arrow
   347:
     id: "KP_3"
+    keyCode: "Numpad3"
     title: Keypad 3 and Page Down
   348:
     id: "KP_4"
+    keyCode: "Numpad4"
     title: Keypad 4 and Left Arrow
   349:
     id: "KP_5"
+    keyCode: "Numpad5"
     title: Keypad 5
   350:
     id: "KP_6"
+    keyCode: "Numpad6"
     title: Keypad 6 and Rigth Arrow
   351:
     id: "KP_7"
+    keyCode: "Numpad7"
     title: Keypad 7 and Home
   352:
     id: "KP_8"
+    keyCode: "Numpad8"
     title: Keypad 8 and Up Arrow
   353:
     id: "KP_9"
+    keyCode: "Numpad9"
     title: Keypad 9 and Page Up
   354:
     id: "KP_0"
+    keyCode: "Numpad0"
     title: Keypad 0 and Insert
   355:
     id: "KP_DOT"
+    keyCode: "NumpadDecimal"
     title: Keypad . and Delete
   356:
     id: "KSC_64"
+    keyCode: "IntlBackslash"
     title: Keyboard Non-US \ and | (US English)
   357:
     id: "COMPOSE"
+    icon: menu
     title: Keyboard Application
-    description: Officially supported by Win, Unix, and Boot
   358:
     id: "POWER"
+    keyCode: "Power"
     title: Keyboard Power
     description: Only officially supported by Mac and Unix
   359:
     id: "KP_EQUAL"
+    keyCode: "NumpadEqual"
     title: Keypad =
     description: Only officially supported by Mac
   360:
@@ -787,10 +888,12 @@ actions:
     description: Not required to be supported by any OS
   472:
     id: "KSC_D8"
+    keyCode: "NumpadClear"
     title: Keypad Clear
     description: Not required to be supported by any OS
   473:
     id: "KSC_D9"
+    keyCode: "NumpadClearEntry"
     title: Keypad Clear Entry
     description: Not required to be supported by any OS
   474:
@@ -841,84 +944,99 @@ actions:
     title: Keyboard Right GUI
   488:
     id: "KSC_E8"
+    icon: play_pause
+    keyCode: "MediaPlayPause"
     title: Media Play Pause
-    description: Not required to be supported by any OS. Possibly deprecated.
   489:
     id: "KSC_E9"
+    icon: stop
+    keyCode: "MediaStop"
     title: Media Stop CD
-    description: Not required to be supported by any OS. Possibly deprecated.
   490:
     id: "KSC_EA"
+    icon: skip_previous
+    keyCode: "MediaTrackPrevious"
     title: Media Previous Song
-    description: Not required to be supported by any OS. Possibly deprecated.
   491:
     id: "KSC_EB"
+    icon: skip_next
+    keyCode: "MediaTrackNext"
     title: Media Next Song
-    description: Not required to be supported by any OS. Possibly deprecated.
   492:
     id: "KSC_EC"
+    icon: eject
+    keyCode: "Eject"
     title: Media Eject CD
-    description: Not required to be supported by any OS. Possibly deprecated.
+    description: MacOS only
   493:
     id: "KSC_ED"
+    icon: volume_up
+    keyCode: "AudioVolumeUp"
     title: Media Volume Up
-    description: Not required to be supported by any OS. Possibly deprecated.
   494:
     id: "KSC_EE"
+    icon: volume_down
+    keyCode: "AudioVolumeDown"
     title: Media Volume Down
-    description: Not required to be supported by any OS. Possibly deprecated.
   495:
     id: "KSC_EF"
+    icon: volume_off
+    keyCode: "AudioVolumeMute"
     title: Media Mute
-    description: Not required to be supported by any OS. Possibly deprecated.
   496:
     id: "KSC_F0"
-    title: Media www
+    icon: language
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Browser
   497:
     id: "KSC_F1"
-    title: Media Back
+    keyCode: "BrowserBack"
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Browser Back
   498:
     id: "KSC_F2"
-    title: Media Forward
+    keyCode: "BrowserForward"
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Browser Forward
   499:
     id: "KSC_F3"
-    title: Media Stop
+    keyCode: "BrowserStop"
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Browser Stop
+    description: Not supported on MacOS
   500:
     id: "KSC_F4"
-    title: Media Find
+    icon: search
-    description: Not required to be supported by any OS. Possibly deprecated.
+    keyCode: "BrowserSearch"
+    title: Media Browser Search
   501:
     id: "KSC_F5"
-    title: Media Scroll Up
+    icon: brightness_high
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Brightness Up
   502:
     id: "KSC_F6"
-    title: Media Scroll Down
+    icon: brightness_low
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Brightness Down
   503:
     id: "KSC_F7"
     title: Media Edit
     description: Not required to be supported by any OS. Possibly deprecated.
   504:
     id: "KSC_F8"
-    title: Media Sleep
+    icon: bedtime
+    keyCode: "Sleep"
+    title: Media System Sleep
     description: Not required to be supported by any OS. Possibly deprecated.
   505:
     id: "KSC_F9"
-    title: Media Coffee
+    icon: routine
-    description: Not required to be supported by any OS. Possibly deprecated.
+    keyCode: "WakeUp"
+    title: Media System Wake
+    description: Not supported on Windows
   506:
     id: "KSC_FA"
-    title: Media Refresh
+    keyCode: "BrowserRefresh"
-    description: Not required to be supported by any OS. Possibly deprecated.
+    title: Media Browser Refresh
   507:
     id: "KSC_FB"
-    title: Media Calc
+    title: Media Calculator
-    description: Not required to be supported by any OS. Possibly deprecated.
+    description: Not supported on MacOS
   508:
     id: "KSC_FC"
     description: Not required to be supported by any OS.
@@ -930,4 +1048,4 @@ actions:
     description: Not required to be supported by any OS.
   511:
     id: "KSC_FF"
-    description: Not required to be supported by any OS.
+    description: Not required to be supported by any OS.

src/lib/assets/layouts/generic/103-key.yml

@@ -0,0 +1,142 @@
+name: 103-key
+col:
+  - row:
+      - key: 41
+      - key: 58
+        offset: [1, 0]
+      - key: 59
+      - key: 60
+      - key: 61
+      - key: 62
+        offset: [0.5, 0]
+      - key: 63
+      - key: 64
+      - key: 65
+      - key: 66
+        offset: [0.5, 0]
+      - key: 67
+      - key: 68
+      - key: 69
+      - key: 70
+        offset: [0.25, 0]
+      - key: 71
+      - key: 72
+  - offset: [0, 0.25]
+    row:
+      - key: 53
+      - key: 30
+      - key: 31
+      - key: 32
+      - key: 33
+      - key: 34
+      - key: 35
+      - key: 36
+      - key: 37
+      - key: 38
+      - key: 39
+      - key: 45
+      - key: 46
+      - key: 42
+        size: [2, 1]
+      - key: 73
+        offset: [0.25, 0]
+      - key: 74
+      - key: 75
+      - key: 83
+        offset: [0.25, 0]
+      - key: 84
+      - key: 85
+      - key: 86
+  - row:
+      - key: 43
+        size: [1.5, 1]
+      - key: 20
+      - key: 26
+      - key: 8
+      - key: 21
+      - key: 23
+      - key: 28
+      - key: 24
+      - key: 12
+      - key: 18
+      - key: 19
+      - key: 47
+      - key: 48
+      - key: 40
+        size: [1.5, 1]
+      - key: 76
+        offset: [0.25, 0]
+      - key: 77
+      - key: 78
+      - key: 95
+        offset: [0.25, 0]
+      - key: 96
+      - key: 97
+      - key: 87
+        size: [1, 2]
+  - offset: [0, -1]
+    row:
+      - key: 57
+        size: [2, 1]
+      - key: 4
+      - key: 22
+      - key: 7
+      - key: 9
+      - key: 10
+      - key: 11
+      - key: 13
+      - key: 14
+      - key: 15
+      - key: 51
+      - key: 52
+      - key: 49
+        size: [2, 1]
+      - key: 92
+        offset: [3.5, 0]
+      - key: 93
+      - key: 94
+  - row:
+      - key: 225
+        size: [2.5, 1]
+      - key: 29
+      - key: 27
+      - key: 6
+      - key: 25
+      - key: 5
+      - key: 17
+      - key: 16
+      - key: 54
+      - key: 55
+      - key: 56
+      - key: 229
+        size: [2.5, 1]
+      - key: 82
+        offset: [1.25, 0]
+      - key: 89
+        offset: [1.25, 0]
+      - key: 90
+      - key: 91
+      - key: 88
+        size: [1, 2]
+  - offset: [0, -1]
+    row:
+      - key: 224
+        size: [1.5, 1]
+      - key: 227
+      - key: 226
+        size: [1.5, 1]
+      - key: 44
+        size: [7, 1]
+      - key: 230
+        size: [1.5, 1]
+      - key: 231
+      - key: 228
+        size: [1.5, 1]
+      - key: 80
+        offset: [0.25, 0]
+      - key: 81
+      - key: 79
+      - key: 98
+        offset: [0.25, 0]
+        size: [2, 1]
+      - key: 99

src/lib/assets/layouts/lite.yml

@@ -0,0 +1,86 @@
+name: Lite
+col:
+  - row:
+      - key: 53
+      - key: 54
+      - key: 55
+      - key: 56
+      - key: 57
+      - key: 58
+      - key: 59
+      - key: 60
+      - key: 61
+      - key: 62
+      - key: 63
+      - key: 64
+      - key: 65
+      - key: 66
+        size: [2, 1]
+  - row:
+      - key: 39
+        size: [1.5, 1]
+      - key: 40
+      - key: 41
+      - key: 42
+      - key: 43
+      - key: 44
+      - key: 45
+      - key: 46
+      - key: 47
+      - key: 48
+      - key: 49
+      - key: 50
+      - key: 51
+      - key: 52
+        size: [1.5, 1]
+  - row:
+      - key: 26
+        size: [1.75, 1]
+      - key: 27
+      - key: 28
+      - key: 29
+      - key: 30
+      - key: 31
+      - key: 32
+      - key: 33
+      - key: 34
+      - key: 35
+      - key: 36
+      - key: 37
+      - key: 38
+        size: [2.25, 1]
+  - row:
+      - key: 12
+        size: [2, 1]
+      - key: 13
+      - key: 14
+      - key: 15
+      - key: 16
+      - key: 17
+      - key: 18
+      - key: 19
+      - key: 20
+      - key: 21
+      - key: 22
+      - key: 23
+      - key: 24
+      - key: 25
+  - row:
+      - key: 0
+      - key: 1
+        size: [1.25, 1]
+      - key: 2
+        size: [1.25, 1]
+      - key: 3
+        size: [2, 1]
+      - key: 4
+      - key: 5
+      - key: 6
+        size: [2, 1]
+      - key: 7
+        size: [1.25, 1]
+      - key: 8
+        size: [1.25, 1]
+      - key: 9
+      - key: 10
+      - key: 11

src/lib/assets/layouts/one.yml

@@ -0,0 +1,42 @@
+name: CC1
+col:
+  # Ring / Middle
+  - offset: [2, 0]
+    row:
+      - switch: { d: 25, e: 26, n: 27, w: 28, s: 29 }
+      - switch: { d: 20, e: 21, n: 22, w: 23, s: 24 }
+      - offset: [4, 0]
+        switch: { d: 65, w: 66, n: 67, e: 68, s: 69 }
+      - switch: { d: 70, w: 71, n: 72, e: 73, s: 74 }
+  - offset: [2, 0]
+    row:
+      - switch: { d: 40, e: 41, n: 42, w: 43, s: 44 }
+      - switch: { d: 35, e: 36, n: 37, w: 38, s: 39 }
+      - offset: [4, 0]
+        switch: { d: 80, w: 81, n: 82, e: 83, s: 84 }
+      - switch: { d: 85, w: 86, n: 87, e: 88, s: 89 }
+  # Pinkie / Index
+  - offset: [0, -3]
+    row:
+      - switch: { d: 30, e: 31, n: 32, w: 33, s: 34 }
+      - offset: [4, 0]
+        switch: { d: 15, e: 16, n: 17, w: 18, s: 19 }
+      - switch: { d: 60, w: 61, n: 62, e: 63, s: 64 }
+      - offset: [4, 0]
+        switch: { d: 75, w: 76, n: 77, e: 78, s: 79 }
+  # Thumbs
+  - row:
+      - offset: [5.5, 0.5]
+        switch: { d: 10, e: 11, n: 12, w: 13, s: 14 }
+      - offset: [1, 0.5]
+        switch: { d: 55, w: 56, n: 57, e: 58, s: 59 }
+  - row:
+      - offset: [4.5, -0.25]
+        switch: { d: 5, e: 6, n: 7, w: 8, s: 9 }
+      - offset: [3, -0.25]
+        switch: { d: 50, w: 51, n: 52, e: 53, s: 54 }
+  - row:
+      - offset: [3.5, -0.25]
+        switch: { d: 0, e: 1, n: 2, w: 3, s: 4 }
+      - offset: [5, -0.25]
+        switch: { d: 45, w: 46, n: 47, e: 48, s: 49 }

src/lib/assets/quater-ring.svg

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
-    <mask id="cross" maskUnits="userSpaceOnUse">
-        <rect x="0" y="0" width="32" height="32" fill="white" />
-        <path d="M0 0L32 32M0 32L32 0" stroke="black" stroke-width="3" />
-    </mask>
-    <circle cx="16" cy="16" r="11.5" fill="none" stroke="white" stroke-width="9" mask="url(#cross)" />
-</svg>

src/lib/assets/random-tips/en.json

@@ -0,0 +1,38 @@
+[
+  "You can use DUP+i to create chords on the fly in any text box",
+  "This site is open source! Check out the full source code on GitHub in the bottom left",
+  "Two letter chords can be activated accidentally in chentry. Be cautious around them",
+  "More inputs in a chord increase the tolerance, making them easier to activate",
+  "The maximum number of outputs in a chord is 256",
+  "You can create backups of your device on the top right",
+  "For programming you should set your auto-delete timeout to about 200ms",
+  "Large parts of this site were written on a CC1",
+  "I use VIM btw...",
+  "I use NixOS btw...",
+  "You can hold shift on the undo button to undo all changes",
+  "GTM stands for Generative Text Menu and can be used to change your device's settings anywhere",
+  "Ambidextrous Throwover (aka Mirror Mode) is a mode designed for one-handed use",
+  "Chentry stands for character entry, or typing letter by letter on a chording enabled device",
+  "Chord modifiers are hard-coded (as of now) and can be used in the English language to add conjucations and more",
+  "You can use 'cursor warping' by adding arrow key actions to a chord, for example to chord '()' with the cursor in the middle of the brackets",
+  "An arpeggiate is a single key press that modifies the preceding chord. Modifiers can be arpeggiated",
+  "Some actions are marked as a 'macro', which means the output is generated by a key sequence rather than a pure key press. Be cautious with those, as they can affect other keys when held together!",
+  "Spurring is a chording only mode which is more advanced, but can greatly improve typing speed when mastered",
+  "The forced chord phenomenon is when typing a word character by character starts to feel unnatural",
+  "Don't be afraid to delete chords you keep getting wrong",
+  "Most people find it easier to start their chord library from scratch rather than learning someone else's",
+  "A common techinque to deal with conflicts is to add DUP or the same key mirrored on the other hand",
+  "A longer chord is not always more difficult",
+  "Riley Keen made headlines when his Monkeytype score of 500WPM using a CC1 got him banned off the site",
+  "A 3d press refers to pressing down into a 5-way switch",
+  "The serial communication protocol used by CCOS is documented on docs.charachorder.com",
+  "The 'CCOS is ready' message can be turned off in the settings",
+  "Most people using the CC1 don't change the a-z key layout, as further modification provides very little benefit",
+  "Using VIM on the default CC1 a-z layout is perfectly doable, it's just a matter of getting used to it",
+  "You can use Nexus to track words you might want to add to your chord library",
+  "The CC1 default layout was 80% science, 20% art",
+  "There is little to no reason to use hjkl in VIM on a CC1 since the arrows keys are so close already",
+  "The device manager automatically creates a backup for you when you reboot your device into the bootloader",
+  "You can use \"compound\", \"macro\", \"suffix\" and \"cursor warp\" in the chord search to find specific types of chords",
+  "You can search for chord inputs by using a leading \"+\", for example \"+a +DUP\" will show all chords with inputs that contain both a and DUP"
+]

src/lib/assets/settings.yml

@@ -0,0 +1,118 @@
+settings:
+  0x1:
+    title: Enable Serial Header
+    description: boolean 0 or 1, default is 0
+  0x2:
+    title: Enable Serial Logging
+    description: boolean 0 or 1, default is 0
+  0x3:
+    title: Enable Serial Debugging
+    description: boolean 0 or 1, default is 0
+  0x4:
+    title: Enable Serial Raw
+    description: boolean 0 or 1, default is 0
+  0x5:
+    title: Enable Serial Chord
+    description: boolean 0 or 1, default is 0
+  0x6:
+    title: Enable Serial Keyboard
+    description: boolean 0 or 1, default is 0
+  0x7:
+    title: Enable Serial Mouse
+    description: boolean 0 or 1, default is 0
+  0x11:
+    title: Enable USB HID Keyboard
+    description: boolean 0 or 1, default is 1
+  0x12:
+    title: Enable Character Entry
+    description: boolean 0 or 1
+  0x13:
+    title: GUI-CTRL Swap Mode
+    description: boolean 0 or 1; 1 swaps keymap 0 and 1. (CCL only)
+  0x14:
+    title: Key Scan Duration
+    description: scan rate described in milliseconds; default is 2ms = 500Hz
+  0x15:
+    title: Key Debounce Press Duration
+    description: debounce time in milliseconds; default is 7ms on the One and 20ms on the Lite
+  0x16:
+    title: Key Debounce Release Duration
+    description: debounce time in milliseconds; default is 7ms on the One and 20ms on the Lite
+  0x17:
+    title: Keyboard Output Character Microsecond Delays
+    description: delay time in microseconds (one delay for press and again for release); default is 480us; max is 10240us; increments of 40us
+  0x21:
+    title: Enable USB HID Mouse
+    description: boolean 0 or 1; default is 1
+  0x22:
+    title: Slow Mouse Speed
+    description: pixels to move at the mouse poll rate; default for CC1 is 5 = 250px/s
+  0x23:
+    title: Fast Mouse Speed
+    description: pixels to move at the mouse poll rate; default for CC1 is 25 = 1250px/s
+  0x24:
+    title: Enable Active Mouse
+    description: boolean 0 or 1; moves mouse back and forth every 60s
+  0x25:
+    title: Mouse Scroll Speed
+    description: default is 1; polls at 1/4th the rate of the mouse move updates
+  0x26:
+    title: Mouse Poll Duration
+    description: poll rate described in milliseconds; default is 20ms = 50Hz
+  0x31:
+    title: Enable Chording
+    description: boolean 0 or 1
+  0x32:
+    title: Enable Chording Character Counter Timeout
+    description: boolean 0 or 1; default is 1
+  0x33:
+    title: Chording Character Counter Timeout Timer
+    description: 0-255 deciseconds; default is 40 or 4.0 seconds
+  0x34:
+    title: Chord Detection Press Tolerance(ms)
+    description: 1-50 milliseconds
+  0x35:
+    title: Chord Detection Release Tolerance(ms)
+    description: 1-50 milliseconds
+  0x41:
+    title: Enable Spurring
+    description: boolean 0 or 1; default is 1
+  0x42:
+    title: Enable Spurring Character Counter Timeout
+    description: boolean 0 or 1; default is 1
+  0x43:
+    title: Spurring Character Counter Timeout Timer
+    description: 0-255 seconds; default is 240
+  0x51:
+    title: Enable Arpeggiates
+    description: boolean 0 or 1; default is 1
+  0x54:
+    title: Arpeggiate Tolerance
+    description: in milliseconds; default 800ms
+  0x61:
+    title: Enable Compound Chording (coming soon)
+    description: boolean 0 or 1; default is 0
+  0x64:
+    title: Compound Tolerance
+    description: in milliseconds; default 1500ms
+  0x81:
+    title: LED Brightness
+    description: 0-50 (CCL only); default is 5, which draws around 100 mA of current
+  0x82:
+    title: LED Color Code
+    description: Color Codes to be listed (CCL only)
+  0x83:
+    title: Enable LED Key Highlight (coming soon)
+    description: boolean 0 or 1 (CCL only)
+  0x84:
+    title: Enable LEDs
+    description: boolean 0 or 1; default is 1 (CCL only)
+  0x91:
+    title: Operating System
+    description: Operating system codes listed below
+  0x92:
+    title: Enable Realtime Feedback
+    description: boolean 0 or 1; default is 1
+  0x93:
+    title: Enable CharaChorder Ready on startup
+    description: boolean 0 or 1; default is 1

src/lib/backup/backup.ts

@@ -0,0 +1,197 @@
+import type {
+  CharaBackupFile,
+  CharaChordFile,
+  CharaFile,
+  CharaLayoutFile,
+  CharaSettingsFile,
+} from "$lib/share/chara-file.js";
+import type { Change } from "$lib/undo-redo.js";
+import {
+  changes,
+  ChangeType,
+  chords,
+  layout,
+  settings,
+} from "$lib/undo-redo.js";
+import { get } from "svelte/store";
+import { serialPort } from "../serial/connection";
+import { csvLayoutToJson, isCsvLayout } from "$lib/backup/compat/legacy-layout";
+import { isCsvChords, csvChordsToJson } from "./compat/legacy-chords";
+
+export function downloadFile<T extends CharaFile<string>>(contents: T) {
+  const downloadUrl = URL.createObjectURL(
+    new Blob([JSON.stringify(contents)], { type: "application/json" }),
+  );
+  const element = document.createElement("a");
+  element.setAttribute(
+    "download",
+    `${contents.type}-${
+      get(serialPort)?.device
+    }-${new Date().toISOString()}.json`,
+  );
+  element.href = downloadUrl;
+  element.setAttribute("target", "_blank");
+  element.click();
+  URL.revokeObjectURL(downloadUrl);
+}
+
+export function downloadBackup() {
+  downloadFile<CharaBackupFile>({
+    charaVersion: 1,
+    type: "backup",
+    history: [
+      [createChordBackup(), createLayoutBackup(), createSettingsBackup()],
+    ],
+  });
+}
+
+export function createLayoutBackup(): CharaLayoutFile {
+  return {
+    charaVersion: 1,
+    type: "layout",
+    device: get(serialPort)?.device,
+    layout: get(layout).map((it) => it.map((it) => it.action)) as [
+      number[],
+      number[],
+      number[],
+    ],
+  };
+}
+
+export function createChordBackup(): CharaChordFile {
+  return {
+    charaVersion: 1,
+    type: "chords",
+    chords: get(chords).map((it) => [it.actions, it.phrase]),
+  };
+}
+
+export function createSettingsBackup(): CharaSettingsFile {
+  return {
+    charaVersion: 1,
+    type: "settings",
+    settings: get(settings).map((it) => it.value),
+  };
+}
+
+export async function restoreBackup(event: Event) {
+  const input = (event.target as HTMLInputElement).files![0];
+  if (!input) return;
+  const text = await input.text();
+  if (input.name.endsWith(".json")) {
+    restoreFromFile(JSON.parse(text));
+  } else if (isCsvLayout(text)) {
+    restoreFromFile(csvLayoutToJson(text));
+  } else if (isCsvChords(text)) {
+    restoreFromFile(csvChordsToJson(text));
+  } else {
+  }
+}
+
+export function restoreFromFile(
+  file: CharaBackupFile | CharaSettingsFile | CharaLayoutFile | CharaChordFile,
+) {
+  if (file.charaVersion !== 1) throw new Error("Incompatible backup");
+  switch (file.type) {
+    case "backup": {
+      const recent = file.history[0];
+      if (!recent) return;
+      let backupDevice = recent[1].device;
+      if (backupDevice === "TWO") backupDevice = "ONE";
+      let currentDevice = get(serialPort)?.device;
+      if (currentDevice === "TWO") currentDevice = "ONE";
+
+      if (backupDevice !== currentDevice) {
+        alert("Backup is incompatible with this device");
+        throw new Error("Backup is incompatible with this device");
+      }
+
+      changes.update((changes) => {
+        changes.push(
+          ...getChangesFromChordFile(recent[0]),
+          ...getChangesFromLayoutFile(recent[1]),
+          ...getChangesFromSettingsFile(recent[2]),
+        );
+        return changes;
+      });
+      break;
+    }
+    case "chords": {
+      changes.update((changes) => {
+        changes.push(...getChangesFromChordFile(file));
+        return changes;
+      });
+      break;
+    }
+    case "layout": {
+      changes.update((changes) => {
+        changes.push(...getChangesFromLayoutFile(file));
+        return changes;
+      });
+      break;
+    }
+    case "settings": {
+      changes.update((changes) => {
+        changes.push(...getChangesFromSettingsFile(file));
+        return changes;
+      });
+      break;
+    }
+    default: {
+      throw new Error(
+        `Unknown backup type "${(file as CharaFile<string>).type}"`,
+      );
+    }
+  }
+}
+
+export function getChangesFromChordFile(file: CharaChordFile) {
+  const changes: Change[] = [];
+  const existingChords = new Set(
+    get(chords).map(({ phrase, actions }) => JSON.stringify([actions, phrase])),
+  );
+  for (const [input, output] of file.chords) {
+    if (existingChords.has(JSON.stringify([input, output]))) {
+      continue;
+    }
+    changes.push({
+      type: ChangeType.Chord,
+      actions: input,
+      phrase: output,
+      id: input,
+    });
+  }
+  return changes;
+}
+
+export function getChangesFromSettingsFile(file: CharaSettingsFile) {
+  const changes: Change[] = [];
+  for (const [id, value] of file.settings.entries()) {
+    const setting = get(settings)[id];
+    if (setting !== undefined && setting.value !== value) {
+      changes.push({
+        type: ChangeType.Setting,
+        id,
+        setting: value,
+      });
+    }
+  }
+  return changes;
+}
+
+export function getChangesFromLayoutFile(file: CharaLayoutFile) {
+  const changes: Change[] = [];
+  for (const [layer, keys] of file.layout.entries()) {
+    for (const [id, action] of keys.entries()) {
+      if (get(layout)[layer]?.[id]?.action !== action) {
+        changes.push({
+          type: ChangeType.Layout,
+          layer,
+          id,
+          action,
+        });
+      }
+    }
+  }
+  return changes;
+}

src/lib/backup/compat/legacy-chords.sample.csv

@@ -0,0 +1,26 @@
+e + b + a,babe
+e + c + b,because
+f + e + c + a,face
+h + e + c + a,each
+i + d + ',I'd
+i + g + b,big
+i + g + e,give
+k + b + a,back
+k + e + a,take
+l + e + a,late
+l + e + d + a,lead
+l + f + e,feel
+l + g + e + a,large
+l + h + e,help
+l + i + a,Lia
+l + i + f,fill
+l + i + f + e,life
+l + i + g + b + a,gitlab
+l + k + i + e,like
+m + e + a,make
+m + i + ',I'm
+n + c + a,can
+n + d + a,and
+n + e + b,been
+n + e + b + a,enable
+n + e + d,end

src/lib/backup/compat/legacy-chords.sample.json

@@ -0,0 +1,26 @@
+e + b + a,babe
+e + c + b,because
+f + e + c + a,face
+h + e + c + a,each
+i + d + ',I'd
+i + g + b,big
+i + g + e,give
+k + b + a,back
+k + e + a,take
+l + e + a,late
+l + e + d + a,lead
+l + f + e,feel
+l + g + e + a,large
+l + h + e,help
+l + i + a,Lia
+l + i + f,fill
+l + i + f + e,life
+l + i + g + b + a,gitlab
+l + k + i + e,like
+m + e + a,make
+m + i + ',I'm
+n + c + a,can
+n + d + a,and
+n + e + b,been
+n + e + b + a,enable
+n + e + d,end

src/lib/backup/compat/legacy-chords.ts

@@ -0,0 +1,31 @@
+import { KEYMAP_IDS } from "$lib/serial/keymap-codes";
+import type { CharaChordFile } from "$lib/share/chara-file";
+
+const SPECIAL_KEYS = new Map<string, string>([[" ", "SPACE"]]);
+
+export function csvChordsToJson(csv: string): CharaChordFile {
+  return {
+    charaVersion: 1,
+    type: "chords",
+    chords: csv
+      .trim()
+      .split("\n")
+      .map((line) => {
+        const [input, output] = line.split(/,(?=[^,]*$)/, 2);
+        return [
+          input!
+            .split("+")
+            .map((it) => KEYMAP_IDS.get(it.trim())?.code ?? 0)
+            .sort((a, b) => a - b),
+          output!
+            .trim()
+            .split("")
+            .map((it) => KEYMAP_IDS.get(SPECIAL_KEYS.get(it) ?? it)?.code ?? 0),
+        ];
+      }),
+  };
+}
+
+export function isCsvChords(csv: string): boolean {
+  return /^([^+]+( *\+ *[^+]+)* *, *[^+, ]+ *(\n|(?=$)))+$/.test(csv);
+}

src/lib/backup/compat/legacy-layout-converted.sample.json

@@ -0,0 +1,27 @@
+{
+  "charaVersion": 1,
+  "type": "layout",
+  "device": "one",
+  "layout": [
+    [
+      309, 304, 312, 303, 306, 290, 282, 301, 266, 285, 289, 270, 281, 272, 262,
+      288, 277, 298, 307, 264, 287, 268, 332, 311, 274, 286, 308, 329, 310, 280,
+      358, 512, 515, 513, 514, 313, 319, 318, 321, 320, 326, 315, 314, 317, 316,
+      312, 330, 331, 333, 334, 291, 261, 283, 536, 276, 292, 265, 275, 267, 263,
+      293, 260, 296, 544, 279, 294, 271, 299, 269, 273, 295, 284, 297, 302, 278,
+      357, 516, 519, 517, 518, 327, 336, 338, 335, 337, 328, 325, 322, 323, 324
+    ],
+    [
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+    ],
+    [
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+    ]
+  ]
+}

src/lib/backup/compat/legacy-layout.sample.csv

@@ -0,0 +1,270 @@
+A1,0,309
+A1,1,304
+A1,2,312
+A1,3,303
+A1,4,306
+A1,5,290
+A1,6,282
+A1,7,301
+A1,8,266
+A1,9,285
+A1,10,289
+A1,11,270
+A1,12,281
+A1,13,272
+A1,14,262
+A1,15,288
+A1,16,277
+A1,17,298
+A1,18,307
+A1,19,264
+A1,20,287
+A1,21,268
+A1,22,332
+A1,23,311
+A1,24,274
+A1,25,286
+A1,26,308
+A1,27,329
+A1,28,310
+A1,29,280
+A1,30,358
+A1,31,512
+A1,32,515
+A1,33,513
+A1,34,514
+A1,35,313
+A1,36,319
+A1,37,318
+A1,38,321
+A1,39,320
+A1,40,326
+A1,41,315
+A1,42,314
+A1,43,317
+A1,44,316
+A1,45,312
+A1,46,330
+A1,47,331
+A1,48,333
+A1,49,334
+A1,50,291
+A1,51,261
+A1,52,283
+A1,53,536
+A1,54,276
+A1,55,292
+A1,56,265
+A1,57,275
+A1,58,267
+A1,59,263
+A1,60,293
+A1,61,260
+A1,62,296
+A1,63,544
+A1,64,279
+A1,65,294
+A1,66,271
+A1,67,299
+A1,68,269
+A1,69,273
+A1,70,295
+A1,71,284
+A1,72,297
+A1,73,302
+A1,74,278
+A1,75,357
+A1,76,516
+A1,77,519
+A1,78,517
+A1,79,518
+A1,80,327
+A1,81,336
+A1,82,338
+A1,83,335
+A1,84,337
+A1,85,328
+A1,86,325
+A1,87,322
+A1,88,323
+A1,89,324
+A2,0,0
+A2,1,0
+A2,2,0
+A2,3,0
+A2,4,0
+A2,5,0
+A2,6,0
+A2,7,0
+A2,8,0
+A2,9,0
+A2,10,0
+A2,11,0
+A2,12,0
+A2,13,0
+A2,14,0
+A2,15,0
+A2,16,0
+A2,17,0
+A2,18,0
+A2,19,0
+A2,20,0
+A2,21,0
+A2,22,0
+A2,23,0
+A2,24,0
+A2,25,0
+A2,26,0
+A2,27,0
+A2,28,0
+A2,29,0
+A2,30,0
+A2,31,0
+A2,32,0
+A2,33,0
+A2,34,0
+A2,35,0
+A2,36,0
+A2,37,0
+A2,38,0
+A2,39,0
+A2,40,0
+A2,41,0
+A2,42,0
+A2,43,0
+A2,44,0
+A2,45,0
+A2,46,0
+A2,47,0
+A2,48,0
+A2,49,0
+A2,50,0
+A2,51,0
+A2,52,0
+A2,53,0
+A2,54,0
+A2,55,0
+A2,56,0
+A2,57,0
+A2,58,0
+A2,59,0
+A2,60,0
+A2,61,0
+A2,62,0
+A2,63,0
+A2,64,0
+A2,65,0
+A2,66,0
+A2,67,0
+A2,68,0
+A2,69,0
+A2,70,0
+A2,71,0
+A2,72,0
+A2,73,0
+A2,74,0
+A2,75,0
+A2,76,0
+A2,77,0
+A2,78,0
+A2,79,0
+A2,80,0
+A2,81,0
+A2,82,0
+A2,83,0
+A2,84,0
+A2,85,0
+A2,86,0
+A2,87,0
+A2,88,0
+A2,89,0
+A3,0,0
+A3,1,0
+A3,2,0
+A3,3,0
+A3,4,0
+A3,5,0
+A3,6,0
+A3,7,0
+A3,8,0
+A3,9,0
+A3,10,0
+A3,11,0
+A3,12,0
+A3,13,0
+A3,14,0
+A3,15,0
+A3,16,0
+A3,17,0
+A3,18,0
+A3,19,0
+A3,20,0
+A3,21,0
+A3,22,0
+A3,23,0
+A3,24,0
+A3,25,0
+A3,26,0
+A3,27,0
+A3,28,0
+A3,29,0
+A3,30,0
+A3,31,0
+A3,32,0
+A3,33,0
+A3,34,0
+A3,35,0
+A3,36,0
+A3,37,0
+A3,38,0
+A3,39,0
+A3,40,0
+A3,41,0
+A3,42,0
+A3,43,0
+A3,44,0
+A3,45,0
+A3,46,0
+A3,47,0
+A3,48,0
+A3,49,0
+A3,50,0
+A3,51,0
+A3,52,0
+A3,53,0
+A3,54,0
+A3,55,0
+A3,56,0
+A3,57,0
+A3,58,0
+A3,59,0
+A3,60,0
+A3,61,0
+A3,62,0
+A3,63,0
+A3,64,0
+A3,65,0
+A3,66,0
+A3,67,0
+A3,68,0
+A3,69,0
+A3,70,0
+A3,71,0
+A3,72,0
+A3,73,0
+A3,74,0
+A3,75,0
+A3,76,0
+A3,77,0
+A3,78,0
+A3,79,0
+A3,80,0
+A3,81,0
+A3,82,0
+A3,83,0
+A3,84,0
+A3,85,0
+A3,86,0
+A3,87,0
+A3,88,0
+A3,89,0

src/lib/backup/compat/legacy-layout.spec.ts

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import legacyLayout from "./legacy-layout.sample.csv?raw";
+import legacyLayoutConverted from "./legacy-layout-converted.sample.json";
+import { csvLayoutToJson, isCsvLayout } from "./legacy-layout";
+
+describe("legacy layout", () => {
+  it("should detect a legacy layout", () => {
+    expect(isCsvLayout(legacyLayout)).to.be.true;
+  });
+
+  it("should not detect chord maps as layouts", () => {
+    expect(isCsvLayout("e + h + t,the")).to.be.false;
+  });
+
+  it("should convert legacy layouts", () => {
+    expect(csvLayoutToJson(legacyLayout)).to.deep.equal(legacyLayoutConverted);
+  });
+});

src/lib/backup/compat/legacy-layout.ts

@@ -0,0 +1,28 @@
+import type { CharaLayoutFile } from "$lib/share/chara-file";
+
+/**
+ * Converts a legacy CSV-based layout to the modern JSON-based format
+ */
+export function csvLayoutToJson(
+  csv: string,
+  device: CharaLayoutFile["device"] = "one",
+): CharaLayoutFile {
+  const layout: CharaLayoutFile = {
+    charaVersion: 1,
+    type: "layout",
+    device,
+    layout: [[], [], []],
+  };
+
+  for (const layer of csv.trim().split("\n")) {
+    const [layerId, key, action] = layer.substring(1).split(",").map(Number);
+
+    layout.layout[Number(layerId) - 1]![Number(key)] = Number(action);
+  }
+
+  return layout;
+}
+
+export function isCsvLayout(csv: string): boolean {
+  return /^(A[123],\d+,\d+\n?)+$/.test(csv);
+}

src/lib/components/Action.svelte

@@ -0,0 +1,98 @@
+<script lang="ts">
+  import { KEYMAP_CODES } from "$lib/serial/keymap-codes";
+  import type { KeyInfo } from "$lib/serial/keymap-codes";
+  import { action as title } from "$lib/title";
+  import { osLayout } from "$lib/os-layout";
+  import LL from "$i18n/i18n-svelte";
+
+  export let action: number | KeyInfo;
+  export let display: "inline-keys" | "keys" = "inline-keys";
+
+  $: info =
+    typeof action === "number"
+      ? KEYMAP_CODES.get(action) ?? { code: action }
+      : action;
+  $: dynamicMapping = info.keyCode && $osLayout.get(info.keyCode);
+
+  $: tooltip =
+    `&lt;${info.id ?? `0x${info.code.toString(16)}`}&gt; ` +
+    (info.title ?? "") +
+    (info.variant === "left"
+      ? " (left)"
+      : info.variant === "right"
+        ? " (right)"
+        : "");
+</script>
+
+{#if dynamicMapping}
+  <span
+    use:title={{ title: $LL.actionSearch.LIVE_LAYOUT_INFO() }}
+    class="dynamic"
+    class:left={info.variant === "left"}
+    class:right={info.variant === "right"}
+    class:inline={display === "inline-keys"}>{dynamicMapping}</span
+  >
+{:else if display === "keys"}
+  <kbd
+    class:icon={!!info.icon}
+    class:left={info.variant === "left"}
+    class:right={info.variant === "right"}
+    use:title={{ title: tooltip }}
+  >
+    {info.icon ?? info.display ?? info.id ?? `0x${info.code.toString(16)}`}
+  </kbd>
+{:else if display === "inline-keys"}
+  {#if !info.icon && info.id?.length === 1}
+    <span
+      class:left={info.variant === "left"}
+      class:right={info.variant === "right"}>{info.id}</span
+    >
+  {:else}
+    <kbd
+      class="inline-kbd"
+      class:left={info.variant === "left"}
+      class:right={info.variant === "right"}
+      class:icon={!!info.icon}
+      use:title={{ title: tooltip }}
+    >
+      {info.icon ??
+        info.display ??
+        info.id ??
+        `0x${info.code.toString(16)}`}</kbd
+    >
+  {/if}
+{/if}
+
+<style lang="scss">
+  kbd:not(.inline-kbd) {
+    height: 24px;
+    padding-block: auto;
+    transition: color 250ms ease;
+  }
+
+  .left {
+    border-left-width: 3px;
+  }
+  .right {
+    border-right-width: 3px;
+  }
+
+  .dynamic {
+    padding: 4px;
+    border-radius: 1px;
+    min-width: 8px;
+    background: var(--md-sys-color-surface-variant);
+
+    &.inline {
+      padding: 0px;
+    }
+  }
+
+  .inline-kbd {
+    margin-inline-end: 2px;
+  }
+
+  :global(span) + .inline-kbd {
+    margin-inline-start: 2px;
+  }
+</style>

src/lib/components/ActionListItem.svelte

@@ -0,0 +1,98 @@
+<script lang="ts">
+  import { KEYMAP_CODES } from "$lib/serial/keymap-codes";
+  import type { KeyInfo } from "$lib/serial/keymap-codes";
+  import LL from "$i18n/i18n-svelte";
+  import Action from "$lib/components/Action.svelte";
+
+  export let id: number | KeyInfo;
+
+  $: key = (typeof id === "number" ? KEYMAP_CODES.get(id) ?? id : id) as
+    | number
+    | KeyInfo;
+</script>
+
+<button on:click>
+  {#if typeof key === "object"}
+    <div class="title">
+      <b>
+        {key.title || ""}
+        {#if key.variant === "left"}
+          (Left)
+        {:else if key.variant === "right"}
+          (Right)
+        {/if}
+      </b>
+      {#if key.description}
+        <i>{key.description}</i>
+      {/if}
+      {#if key.category?.name === "ASCII Macros"}
+        <span class="warning">{@html $LL.actionSearch.SHIFT_WARNING()}</span>
+      {/if}
+      {#if key.category?.name === "CP-1252"}
+        <span class="warning">{@html $LL.actionSearch.ALT_CODE_WARNING()}</span>
+      {/if}
+    </div>
+    <Action display="keys" action={key} />
+  {:else}
+    <span class="key">0x{key.toString(16)}</span>
+  {/if}
+</button>
+
+<style lang="scss">
+  button {
+    display: flex;
+    gap: 4px;
+    align-items: center;
+
+    width: 100%;
+    height: auto;
+    margin: 0;
+    padding: 8px;
+
+    font-family: "Noto Sans Mono", monospace;
+    border-radius: 8px;
+
+    @media not (forced-colors: active) {
+      color: inherit;
+
+      background: transparent;
+      border: none;
+
+      &:focus-visible {
+        color: var(--md-sys-color-on-surface-variant);
+        background: var(--md-sys-color-surface-variant);
+        outline: none;
+      }
+    }
+
+    @media (forced-colors: active) {
+      border: 1px solid ButtonBorder;
+      margin-block: 4px;
+
+      &:hover {
+        color: ActiveText;
+      }
+    }
+  }
+
+  .title {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: flex-start;
+
+    text-align: start;
+  }
+
+  .warning {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+    color: var(--md-sys-color-error);
+
+    > :global(.icon) {
+      font-size: 16px;
+    }
+  }
+</style>

src/lib/components/ActionString.svelte

@@ -0,0 +1,11 @@
+<script lang="ts">
+  import Action from "$lib/components/Action.svelte";
+  import type { KeyInfo } from "$lib/serial/keymap-codes";
+
+  export let actions: Array<number | KeyInfo>;
+  export let display: "keys" | "inline-keys" = "inline-keys";
+</script>
+
+{#each actions as action, i (`${typeof action === "number" ? action : action.code}:${i}`)}
+  <Action {action} {display} />
+{/each}

src/lib/components/LayoutCC1.svelte

@@ -1,127 +0,0 @@
-<script>
-  import RingInput from "$lib/components/RingInput.svelte"
-
-  let activeLayer = 0
-</script>
-
-<fieldset>
-  {#each [["Numeric Layer", "123", 1], ["Primary Layer", "abc", 0], ["Function Layer", "function", 2]] as [title, icon, value]}
-    <button {title} class="icon" on:click={() => (activeLayer = value)} class:active={activeLayer === value}>
-      {icon}
-    </button>
-  {/each}
-</fieldset>
-
-<div class="col layout" style="gap: 0">
-  <div class="row" style="gap: 156px">
-    <div class="row">
-      <RingInput {activeLayer} keys={{d: 30, e: 31, n: 32, w: 33, s: 34}} type="tertiary" />
-      <div class="col">
-        <RingInput {activeLayer} keys={{d: 25, e: 26, n: 27, w: 28, s: 29}} />
-        <RingInput {activeLayer} keys={{d: 40, e: 41, n: 42, w: 43, s: 44}} type="secondary" />
-      </div>
-      <div class="col">
-        <RingInput {activeLayer} keys={{d: 20, e: 21, n: 22, w: 23, s: 24}} />
-        <RingInput {activeLayer} keys={{d: 35, e: 36, n: 37, w: 38, s: 39}} type="secondary" />
-      </div>
-      <RingInput {activeLayer} keys={{d: 15, e: 16, n: 17, w: 18, s: 19}} />
-    </div>
-
-    <div class="row">
-      <RingInput {activeLayer} keys={{d: 60, w: 61, n: 62, e: 63, s: 64}} />
-      <div class="col">
-        <RingInput {activeLayer} keys={{d: 65, w: 66, n: 67, e: 68, s: 69}} />
-        <RingInput {activeLayer} keys={{d: 80, w: 81, n: 82, e: 83, s: 84}} />
-      </div>
-      <div class="col">
-        <RingInput {activeLayer} keys={{d: 70, w: 71, n: 72, e: 73, s: 74}} />
-        <RingInput {activeLayer} keys={{d: 85, w: 86, n: 87, e: 88, s: 89}} />
-      </div>
-      <RingInput {activeLayer} keys={{d: 75, w: 76, n: 77, e: 78, s: 79}} />
-    </div>
-  </div>
-  <div class="row" style="gap: 48px; margin-top: -32px">
-    <RingInput {activeLayer} keys={{d: 10, e: 11, n: 12, w: 13, s: 14}} />
-    <RingInput {activeLayer} keys={{d: 55, w: 56, n: 57, e: 58, s: 59}} />
-  </div>
-  <div class="row" style="gap: 160px">
-    <RingInput {activeLayer} keys={{d: 5, e: 6, n: 7, w: 8, s: 9}} />
-    <RingInput {activeLayer} keys={{d: 50, w: 51, n: 52, e: 53, s: 54}} />
-  </div>
-  <div class="row" style="gap: 320px; margin-top: -12px">
-    <RingInput {activeLayer} keys={{d: 0, e: 1, n: 2, w: 3, s: 4}} type="secondary" />
-    <RingInput {activeLayer} keys={{d: 45, w: 46, n: 47, e: 48, s: 49}} type="secondary" />
-  </div>
-</div>
-
-<style lang="scss">
-  fieldset {
-    position: relative;
-
-    display: flex;
-    align-items: center;
-    justify-content: center;
-
-    margin-block-end: -36px;
-    padding: 0;
-
-    border: none;
-  }
-
-  button.icon {
-    cursor: pointer;
-
-    z-index: 1;
-
-    font-size: 24px;
-    color: var(--md-sys-color-on-surface-variant);
-
-    background: var(--md-sys-color-surface-variant);
-    border: none;
-
-    transition: all 250ms ease;
-
-    &:nth-child(2) {
-      z-index: 2;
-
-      aspect-ratio: 1;
-
-      font-size: 32px;
-
-      border-radius: 50%;
-      outline: 8px solid var(--md-sys-color-background);
-    }
-
-    &:first-child {
-      padding-inline-end: 16px;
-      border-radius: 16px 0 0 16px;
-    }
-
-    &:last-child {
-      padding-inline-start: 16px;
-      border-radius: 0 16px 16px 0;
-    }
-
-    &.active {
-      font-weight: 900;
-      color: var(--md-sys-color-on-tertiary);
-      background: var(--md-sys-color-tertiary);
-    }
-  }
-
-  .row,
-  .col {
-    display: flex;
-    gap: 8px;
-    align-items: center;
-    justify-content: center;
-  }
-
-  .row {
-    flex-direction: row;
-  }
-
-  .col {
-    flex-direction: column;
-  }
-</style>

src/lib/components/Navigation.svelte

@@ -1,209 +0,0 @@
-<script>
-  import {serialPort, syncStatus} from "$lib/serial/connection"
-  import {browser} from "$app/environment"
-  import {page} from "$app/stores"
-  import {slide} from "svelte/transition"
-
-  const training = [
-    {slug: "cpm", title: "CPM - Characters Per Minute", icon: "music_note"},
-    {slug: "chords", title: "ChM - Chords Mastered", icon: "piano"},
-    {slug: "avg-wpm", title: "aWPM - Average Words Per Minute", icon: "avg_pace"},
-    {slug: "sentences", title: "StM - Sentences Mastered", icon: "lyrics"},
-    {slug: "top-wpm", title: "tWPM - Top Words Per Minute", icon: "speed"},
-    {slug: "cm", title: "CM - Concepts Mastered", icon: "cognition"},
-  ]
-</script>
-
-<nav>
-  <a href="/" class="title">dot i/o</a>
-
-  <div class="steps">
-    {#each training as { slug, title, icon }}
-      <a
-        href="/train/{slug}/"
-        {title}
-        class="icon train {slug}"
-        class:active={$page.url.pathname === `/train/${slug}/`}>{icon}</a
-      >
-    {/each}
-  </div>
-
-  <div class="actions">
-    {#await import("$lib/components/PwaStatus.svelte") then { default: PwaStatus }}
-      <PwaStatus />
-    {/await}
-    {#if browser && !("serial" in navigator)}
-      <abbr
-        title="Your browser does not support serial connections. Try using Chrome instead."
-        class="icon error"
-      >
-        warning
-      </abbr>
-    {/if}
-    <a
-      title="Backup & Restore"
-      href="/backup/"
-      class="icon {$syncStatus}"
-      class:active={$page.url.pathname.startsWith("/backup/")}
-    >
-      {#if $syncStatus === "downloading"}
-        backup
-      {:else if $syncStatus === "uploading"}
-        cloud_download
-      {:else}
-        cloud_done
-      {/if}
-    </a>
-    <a
-      href="/config/"
-      title="Device Manager"
-      class="icon connect"
-      class:active={$page.url.pathname.startsWith("/config/")}
-      class:error={$serialPort === undefined}
-    >
-      cable
-    </a>
-    <a href="/" title="Statistics" class="icon account">person</a>
-  </div>
-</nav>
-
-<style lang="scss">
-  @keyframes sync {
-    0% {
-      scale: 1 1;
-      opacity: 1;
-    }
-
-    85% {
-      scale: 1 0;
-      opacity: 1;
-    }
-
-    86% {
-      scale: 1 1;
-      opacity: 0;
-    }
-
-    100% {
-      scale: 1 1;
-      opacity: 1;
-    }
-  }
-
-  .uploading::after,
-  .downloading::after {
-    content: "";
-
-    position: absolute;
-    top: 12px;
-    left: 50%;
-    transform-origin: top;
-    translate: -50% 0;
-
-    width: 8px;
-    height: 10px;
-
-    background: var(--md-sys-color-background);
-
-    animation: sync 1s linear infinite;
-  }
-
-  .downloading.active::after,
-  .uploading.active::after {
-    background: var(--md-sys-color-primary);
-  }
-
-  .sync.downloading::after {
-    top: 10px;
-    transform-origin: bottom;
-    border-radius: 4px;
-  }
-
-  nav {
-    display: flex;
-    gap: 4px;
-    align-items: center;
-    justify-content: space-between;
-
-    margin-block: 8px;
-    margin-inline: 16px;
-  }
-
-  .title {
-    margin-block: 0;
-
-    font-size: 1.5rem;
-    font-weight: bold;
-    color: var(--md-sys-color-primary);
-    text-decoration: none;
-  }
-
-  .icon {
-    cursor: pointer;
-
-    position: relative;
-
-    aspect-ratio: 1;
-    padding: 4px;
-
-    color: inherit;
-    text-decoration: none;
-
-    background: transparent;
-    border: none;
-    border-radius: 50%;
-
-    transition: all 250ms ease;
-
-    &.error {
-      color: var(--md-sys-color-on-error);
-      background: var(--md-sys-color-error);
-    }
-
-    &.active,
-    &:active {
-      color: var(--md-sys-color-on-primary);
-      background: var(--md-sys-color-primary);
-    }
-  }
-
-  .steps {
-    display: flex;
-
-    > a.icon {
-      aspect-ratio: unset;
-      margin-inline: -4px;
-      padding-inline: 16px;
-
-      font-size: 24px;
-      color: var(--md-sys-on-surface-variant);
-
-      background: var(--md-sys-color-surface-variant);
-      clip-path: polygon(25% 50%, 0% 0%, 75% 0%, 100% 50%, 75% 100%, 0% 100%);
-      border-radius: 0;
-
-      &.active,
-      &:active {
-        color: var(--md-sys-color-on-tertiary);
-        background: var(--md-sys-color-tertiary);
-
-        &,
-        ~ * {
-          translate: 8px 0;
-        }
-      }
-    }
-  }
-
-  .actions {
-    display: flex;
-    gap: 8px;
-    align-items: center;
-  }
-
-  .icon.account {
-    font-size: 32px;
-    color: var(--md-sys-color-on-secondary-container);
-    background: var(--md-sys-color-secondary-container);
-  }
-</style>

src/lib/components/PwaStatus.svelte

@@ -1,11 +1,14 @@
 <script>
-  import {useRegisterSW} from "virtual:pwa-register/svelte"
+  // @ts-expect-error no types here
+  import { useRegisterSW } from "virtual:pwa-register/svelte";
 
-  const {needRefresh, updateServiceWorker, offlineReady} = useRegisterSW()
+  const { needRefresh, updateServiceWorker, offlineReady } = useRegisterSW();
 </script>
 
 {#if $needRefresh}
-  <button title="Update ready" class="icon" on:click={() => updateServiceWorker(true)}>update</button>
+  <button title="Update ready" on:click={() => updateServiceWorker(true)}
+    >Update <span class="icon">update</span></button
+  >
 {:else if $offlineReady}
   <div title="App can now be used offline" class="icon">offline_pin</div>
 {/if}

src/lib/components/RingInput.svelte

@@ -1,168 +0,0 @@
-<script lang="ts">
-  import {layout} from "$lib/serial/connection"
-  import type {CharaLayout} from "$lib/serial/connection"
-  import {KEYMAP_CODES} from "$lib/serial/keymap-codes"
-  import type {KeyInfo} from "$lib/serial/keymap-codes"
-
-  export let activeLayer = 0
-  export let keys: Record<"d" | "n" | "w" | "e", number>
-  export let type: "primary" | "secondary" | "tertiary" = "primary"
-
-  const layerNames = ["Primary Layer", "Number Layer", "Function Layer"]
-
-  const virtualLayerMap = [1, 0, 2]
-  const characterOffset = 8
-
-  function offsetDistance(quadrant: number, layer: number, activeLayer: number): number {
-    const layerOffsetIndex = virtualLayerMap[layer] - virtualLayerMap[activeLayer]
-    const layerOffset = quadrant > 2 ? -characterOffset : characterOffset
-    return 25 * quadrant + layerOffsetIndex * layerOffset
-  }
-
-  function getKeyDescriptions(keys: KeyInfo[]): string {
-    return keys
-      .filter(it => !!it)
-      .map(({title, id, code}, i) => `${title || id || code} (${layerNames[i]})`)
-      .join("\n")
-  }
-
-  function getActions(id: number, layout: CharaLayout): KeyInfo[] {
-    return Array.from({length: 3}).map((_, i) => {
-      const actionId = layout?.[i][id]
-      return KEYMAP_CODES[actionId]
-    })
-  }
-</script>
-
-<div class="radial {type}">
-  {#each [keys.n, keys.e, keys.s, keys.w] as id, quadrant}
-    {@const actions = getActions(id, $layout)}
-    <button title={getKeyDescriptions(actions)}>
-      {#each actions as keyInfo, layer}
-        {#if keyInfo}
-          <span
-            class:active={virtualLayerMap[activeLayer] === virtualLayerMap[layer]}
-            class:icon={!!keyInfo.icon}
-            style="offset-distance: {offsetDistance(quadrant, layer, activeLayer)}%"
-            >{keyInfo.icon || keyInfo.id || keyInfo.code}</span
-          >
-        {/if}
-      {/each}
-    </button>
-  {/each}
-</div>
-
-<style lang="scss">
-  @use "sass:math";
-
-  $border-width: 18px;
-  $gap: 6px;
-  $size: 96;
-  $offset: 14;
-  $scale-difference: 0.2;
-  $transition-time: 750ms;
-
-  .radial {
-    position: relative;
-
-    container: radial / size;
-
-    width: #{$size * 1px};
-    height: #{$size * 1px};
-
-    transition: all 250ms ease;
-  }
-
-  span {
-    $cr: math.div($size, 2) - 2 * $offset;
-
-    will-change: scale, offset-distance;
-    user-select: none;
-
-    scale: 0.9;
-    offset-path: path(
-      "M#{math.div($size, 2)} #{$offset}A#{$cr} #{$cr} 0 1 1 #{math.div($size, 2)} #{$size - $offset}A#{$cr} #{$cr} 0 1 1 #{math.div($size, 2)} #{$offset}Z"
-    );
-    offset-rotate: 0deg;
-
-    display: flex;
-    grid-column: 1;
-    grid-row: 1;
-    align-items: center;
-    justify-content: center;
-
-    width: 100%;
-    height: 100%;
-
-    font-size: 16px;
-
-    opacity: 0.2;
-
-    transition: scale $transition-time ease, opacity $transition-time ease,
-      offset-distance $transition-time ease;
-
-    &.active {
-      scale: 1;
-      opacity: 1;
-    }
-
-    &.icon {
-      font-size: 20px;
-      font-weight: 800;
-    }
-  }
-
-  button {
-    cursor: pointer;
-
-    position: absolute;
-
-    display: grid;
-
-    width: 100cqw;
-    height: 100cqh;
-    padding: 0;
-
-    font-family: "Noto Sans Mono", monospace;
-    font-size: 16px;
-    font-weight: 900;
-    color: var(--md-sys-color-on-surface-variant);
-
-    background: var(--md-sys-color-surface-variant);
-    border: none;
-
-    transition: all 250ms ease;
-
-    mask-image: url("$lib/assets/quater-ring.svg");
-    mask-size: 100% 100%;
-
-    &:active {
-      color: var(--md-sys-color-on-tertiary);
-      background: var(--md-sys-color-tertiary);
-    }
-
-    &:nth-child(1) {
-      clip-path: polygon(50% 50%, 0 0, 100% 0);
-    }
-
-    &:nth-child(2) {
-      clip-path: polygon(50% 50%, 100% 0, 100% 100%);
-    }
-
-    &:nth-child(3) {
-      clip-path: polygon(50% 50%, 0 100%, 100% 100%);
-    }
-
-    &:nth-child(4) {
-      clip-path: polygon(50% 50%, 0 0, 0 100%);
-    }
-  }
-
-  .secondary > button {
-    filter: brightness(80%) contrast(120%);
-  }
-
-  .tertiary > button {
-    filter: brightness(80%) contrast(110%);
-  }
-</style>

src/lib/components/Terminal.svelte

@@ -1,22 +1,28 @@
 <script lang="ts">
-  import {serialLog, serialPort} from "$lib/serial/connection"
+  import { serialLog, serialPort } from "$lib/serial/connection";
-  import {slide} from "svelte/transition"
+  import { slide } from "svelte/transition";
 
-  function submit(event: InputEvent) {
+  function submit(event: Event) {
-    event.preventDefault()
+    event.preventDefault();
-    $serialPort.send(value.trim())
+    $serialPort?.send(0, value.trim());
-    value = ""
+    value = "";
-    io.scrollTo({top: io.scrollHeight})
+    io.scrollTo({ top: io.scrollHeight });
   }
 
-  let value: string
+  let value: string;
-  let io: HTMLDivElement
+  let io: HTMLDivElement;
 </script>
 
 <form on:submit={submit}>
   <div bind:this={io} class="io">
     {#each $serialLog as { type, value }}
-      <p class={type} transition:slide>{value}</p>
+      {#if type === "input"}
+        <code transition:slide>{value}</code>
+      {:else if type === "output"}
+        <samp transition:slide>{value}</samp>
+      {:else}
+        <p transition:slide>{value}</p>
+      {/if}
     {/each}
     <div class="anchor" />
   </div>
@@ -111,17 +117,15 @@
     height: 1px;
   }
 
+  code,
+  samp,
   p {
+    display: block;
     overflow-anchor: none;
     margin-block: 0.15rem;
   }
 
-  p.input {
+  p {
-    margin-block-end: 0.25rem;
-    font-weight: bold;
-  }
-
-  p.system {
     display: flex;
     justify-content: center;
 
@@ -134,8 +138,9 @@
     border-radius: 8px;
   }
 
-  p.input::before {
+  code::before {
     content: "> ";
+    margin-block-end: 0.25rem;
     font-weight: 900;
     color: var(--md-sys-color-primary);
   }

src/lib/components/Tooltip.svelte

@@ -0,0 +1,22 @@
+<script lang="ts">
+  export let title: string | undefined;
+  export let shortcut: string | undefined;
+</script>
+
+{#if title}
+  <p>{@html title}</p>
+{/if}
+
+{#if shortcut}
+  <kbd>
+    {#each shortcut.split("+") as key}
+      <kbd>{key}</kbd>
+    {/each}
+  </kbd>
+{/if}
+
+<style lang="scss">
+  p {
+    margin-block: 0;
+  }
+</style>

src/lib/components/layout/ActionSelector.svelte

@@ -0,0 +1,333 @@
+<script lang="ts">
+  import {
+    KEYMAP_CATEGORIES,
+    KEYMAP_CODES,
+    KEYMAP_IDS,
+  } from "$lib/serial/keymap-codes";
+  import FlexSearch from "flexsearch";
+  import { createEventDispatcher, onMount } from "svelte";
+  import ActionListItem from "$lib/components/ActionListItem.svelte";
+  import LL from "$i18n/i18n-svelte";
+  import { action } from "$lib/title";
+
+  export let currentAction: number | undefined = undefined;
+  export let nextAction: number | undefined = undefined;
+
+  onMount(() => {
+    searchBox.focus();
+  });
+
+  const index = new FlexSearch.Index({ tokenize: "full" });
+  createIndex();
+
+  async function createIndex() {
+    for (const [, action] of KEYMAP_CODES) {
+      await index?.addAsync(
+        action.code,
+        `${action.title || ""} ${action.variant || ""} ${action.category} ${action.id || ""} ${
+          action.description || ""
+        }`,
+      );
+    }
+  }
+
+  async function search() {
+    results = (await index!.searchAsync(searchBox.value)) as number[];
+    exact = KEYMAP_IDS.get(searchBox.value)?.code;
+    code = Number(searchBox.value);
+  }
+
+  function select(id?: number) {
+    if (id !== undefined) {
+      dispatch("select", id);
+    }
+  }
+
+  function keyboardNavigation(event: KeyboardEvent) {
+    if (event.shiftKey && event.key === "Enter") {
+      dispatch("select", exact);
+    } else if (event.key === "ArrowDown") {
+      const element =
+        resultList.querySelector("li:focus-within")?.nextSibling ??
+        resultList.querySelector("li:not(.exact)");
+      if (element instanceof HTMLLIElement) {
+        element.querySelector("button")?.focus();
+      }
+    } else if (event.key === "ArrowUp") {
+      const element =
+        resultList.querySelector("li:focus-within")?.previousSibling ??
+        resultList.querySelector("li:not(.exact)");
+      if (element instanceof HTMLLIElement) {
+        element.querySelector("button")?.focus();
+      }
+    } else {
+      searchBox.focus();
+      return;
+    }
+    event.preventDefault();
+  }
+
+  let results: number[] = [];
+  let exact: number | undefined = undefined;
+  let code: number = Number.NaN;
+
+  const dispatch = createEventDispatcher();
+  let searchBox: HTMLInputElement;
+  let resultList: HTMLUListElement;
+  let filter: Set<number>;
+</script>
+
+<svelte:window on:keydown={keyboardNavigation} />
+
+<!-- svelte-ignore a11y-click-events-have-key-events a11y-no-noninteractive-element-interactions -->
+<dialog open on:click|self={() => dispatch("close")}>
+  <div class="content">
+    <div class="search-row">
+      <input
+        type="search"
+        bind:this={searchBox}
+        on:input={search}
+        on:keypress={(event) => {
+          if (event.key === "Enter") {
+            select(exact);
+          }
+        }}
+        placeholder={$LL.actionSearch.PLACEHOLDER()}
+      />
+      <button on:click={() => select(0)} use:action={{ shortcut: "shift+esc" }}
+        >{$LL.actionSearch.DELETE()}</button
+      >
+      <button
+        use:action={{ title: $LL.modal.CLOSE(), shortcut: "esc" }}
+        class="icon"
+        on:click={() => dispatch("close")}>close</button
+      >
+    </div>
+    <fieldset class="filters">
+      <label
+        >{$LL.actionSearch.filter.ALL()}<input
+          checked
+          name="category"
+          type="radio"
+          value={undefined}
+          bind:group={filter}
+        /></label
+      >
+      {#each KEYMAP_CATEGORIES as category}
+        <label
+          >{category.name}<input
+            name="category"
+            type="radio"
+            value={new Set(Object.keys(category.actions).map(Number))}
+            bind:group={filter}
+          /></label
+        >
+      {/each}
+    </fieldset>
+    {#if currentAction !== undefined}
+      <aside>
+        <h3>{$LL.actionSearch.CURRENT_ACTION()}</h3>
+        <ActionListItem id={currentAction} />
+      </aside>
+      {#if nextAction}
+        <aside>
+          <h3>{$LL.actionSearch.NEXT_ACTION()}</h3>
+          <ActionListItem id={nextAction} />
+        </aside>
+      {/if}
+    {/if}
+    <ul bind:this={resultList}>
+      {#if exact !== undefined}
+        <li class="exact">
+          <i>Exact match</i>
+          <ActionListItem id={exact} on:click={() => select(exact)} />
+        </li>
+      {/if}
+      {#if !exact && code}
+        {#if code >= 2 ** 5 && code < 2 ** 13}
+          <li><button on:click={() => select(code)}>USE CODE</button></li>
+        {:else}
+          <li>Action code is out of range</li>
+        {/if}
+      {/if}
+      {#if filter !== undefined || results.length > 0}
+        {@const resultValue =
+          results.length === 0
+            ? Array.from(KEYMAP_CODES, ([it]) => it)
+            : results}
+        {#each filter ? resultValue.filter( (it) => filter.has(it), ) : resultValue as id (id)}
+          <li><ActionListItem {id} on:click={() => select(id)} /></li>
+        {/each}
+      {/if}
+    </ul>
+  </div>
+</dialog>
+
+<style lang="scss">
+  .filters {
+    display: flex;
+    gap: 4px;
+    border: none;
+
+    label {
+      height: unset;
+      padding-block: 2px;
+      padding-inline: 4px;
+
+      font-size: 14px;
+
+      border: 1px solid currentcolor;
+      border-radius: 6px;
+
+      &:has(:checked) {
+        color: var(--md-sys-color-on-secondary);
+        background: var(--md-sys-color-secondary);
+      }
+
+      input {
+        display: none;
+      }
+    }
+  }
+
+  dialog {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+
+    width: 100%;
+    height: 100%;
+
+    background: rgba(0 0 0 / 60%);
+
+    border: none;
+  }
+
+  aside {
+    pointer-events: none;
+
+    margin: 8px;
+
+    opacity: 0.4;
+    border: 1px dashed var(--md-sys-color-outline);
+    border-radius: 8px;
+
+    > h3 {
+      width: fit-content;
+      margin-block-start: -13px;
+      margin-block-end: 0;
+      margin-inline-start: 16px;
+      padding-inline: 8px;
+
+      background: var(--md-sys-color-background);
+    }
+
+    @media (prefers-contrast: more) {
+      opacity: 0.8;
+    }
+
+    @media (forced-colors: active) {
+      opacity: 1;
+      color: GrayText;
+    }
+  }
+
+  .search-row {
+    display: flex;
+    gap: 4px;
+    align-items: center;
+    margin-inline: 16px;
+  }
+
+  .content {
+    position: relative;
+    transform-origin: top left;
+
+    overflow: hidden;
+    display: flex;
+    flex-direction: column;
+
+    width: calc(min(30cm, 90%));
+    height: calc(min(100% - 128px, 90%));
+
+    color: var(--md-sys-color-on-background);
+
+    background: var(--md-sys-color-background);
+    border-radius: 16px;
+
+    @media (forced-colors: active) {
+      border: 1px solid CanvasText;
+    }
+  }
+
+  input[type="search"] {
+    width: 100%;
+    height: 64px;
+    margin-block-end: 8px;
+    padding-inline: 16px;
+
+    font-family: inherit;
+    font-size: 16px;
+    color: currentcolor;
+
+    background: none;
+    border: none;
+    border-bottom: 1px solid var(--md-sys-color-surface-variant);
+
+    transition: all 250ms ease;
+
+    &:focus {
+      border-bottom: 1px solid var(--md-sys-color-primary);
+      outline: none;
+    }
+  }
+
+  ul {
+    --scrollbar-color: var(--md-sys-color-surface-variant);
+
+    scrollbar-gutter: both-edges stable;
+
+    overflow-y: auto;
+
+    box-sizing: border-box;
+    height: 100%;
+    margin: 0;
+    padding: 0;
+    padding-inline: 4px;
+  }
+
+  li {
+    display: contents;
+  }
+
+  .exact {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+
+    width: 100%;
+    margin-block-start: 8px;
+
+    border: 1px solid var(--md-sys-color-primary);
+    border-radius: 8px;
+
+    > i {
+      display: flex;
+      gap: 4px;
+      align-items: center;
+      justify-content: center;
+
+      padding-inline: 6px;
+
+      color: var(--md-sys-color-on-primary);
+
+      background: var(--md-sys-color-primary);
+      border-radius: 0 0 8px 8px;
+    }
+
+    @media (forced-colors: active) {
+      background: Mark;
+    }
+  }
+</style>

src/lib/components/layout/GenericLayout.svelte

@@ -0,0 +1,222 @@
+<script lang="ts">
+  import { compileLayout } from "$lib/serialization/visual-layout";
+  import type {
+    VisualLayout,
+    CompiledLayoutKey,
+  } from "$lib/serialization/visual-layout";
+  import { deviceLayout } from "$lib/serial/connection";
+  import { dev } from "$app/environment";
+  import ActionSelector from "$lib/components/layout/ActionSelector.svelte";
+  import { get } from "svelte/store";
+  import type { Writable } from "svelte/store";
+  import KeyboardKey from "$lib/components/layout/KeyboardKey.svelte";
+  import { getContext } from "svelte";
+  import type { VisualLayoutConfig } from "./visual-layout.js";
+  import { changes, ChangeType, layout } from "$lib/undo-redo";
+  import { fly } from "svelte/transition";
+  import { expoOut } from "svelte/easing";
+
+  const { scale, margin, strokeWidth, fontSize, iconFontSize } =
+    getContext<VisualLayoutConfig>("visual-layout-config");
+  const activeLayer = getContext<Writable<number>>("active-layer");
+
+  if (dev) {
+    // you have absolutely no idea what a difference this makes for performance
+    console.assert(scale % 1 === 0, "Scale must be an integer");
+    console.assert((scale / 2) % 1 === 0, "Scale must be divisible by 2");
+    console.assert(strokeWidth % 1 === 0, "Stroke must be an integer");
+    console.assert(margin % 1 === 0, "Margin must be an integer");
+    console.assert(fontSize % 1 === 0, "Font size must be an integer");
+    console.assert(iconFontSize % 1 === 0, "Icon font size must be an integer");
+  }
+
+  export let visualLayout: VisualLayout;
+  $: layoutInfo = compileLayout(visualLayout);
+
+  function getCenter(key: CompiledLayoutKey): [x: number, y: number] {
+    return [key.pos[0] + key.size[0] / 2, key.pos[1] + key.size[1] / 2];
+  }
+
+  function getDistance(a: CompiledLayoutKey, b: CompiledLayoutKey) {
+    const x1 = a.pos[0] + margin;
+    const y1 = a.pos[1] + margin;
+    const x1b = x1 + a.size[0] - margin;
+    const y1b = y1 + a.size[1] - margin;
+    const x2 = b.pos[0] + margin;
+    const y2 = b.pos[1] + margin;
+    const x2b = x2 + b.size[0] - margin;
+    const y2b = y2 + b.size[1] - margin;
+
+    const left = x2b < x1;
+    const right = x1b < x2;
+    const bottom = y2b < y1;
+    const top = y1b < y2;
+
+    return top && left
+      ? Math.sqrt((x1 - x2b) ** 2 + (y1b - y2) ** 2)
+      : left && bottom
+        ? Math.sqrt((x1 - x2b) ** 2 + (y1 - y2b) ** 2)
+        : bottom && right
+          ? Math.sqrt((x1b - x2) ** 2 + (y1 - y2b) ** 2)
+          : right && top
+            ? Math.sqrt((x1b - x2) ** 2 + (y1b - y2) ** 2)
+            : left
+              ? x1 - x2b
+              : right
+                ? x2 - x1b
+                : bottom
+                  ? y1 - y2b
+                  : top
+                    ? y2 - y1b
+                    : 0;
+  }
+
+  function navigate(event: KeyboardEvent) {
+    if (event.altKey || event.ctrlKey || event.shiftKey || event.metaKey)
+      return;
+
+    let wantedAngle: number;
+    const angleThreshold = Math.PI;
+
+    if (event.key === "ArrowUp") wantedAngle = Math.PI;
+    else if (event.key === "ArrowDown") wantedAngle = 0;
+    else if (event.key === "ArrowRight") wantedAngle = Math.PI / 2;
+    else if (event.key === "ArrowLeft") wantedAngle = -Math.PI / 2;
+    else return;
+
+    event.preventDefault();
+    if (!focusKey) (groupParent.firstChild as SVGGElement).focus();
+    const [focusX, focusY] = getCenter(focusKey);
+
+    let bestDistance = Infinity;
+    let bestCandidate = 0;
+    let isOptimalAngle = false;
+
+    for (const [i, key] of layoutInfo.keys.entries()) {
+      if (key === focusKey) continue;
+      const [keyX, keyY] = getCenter(key);
+      const deltaX = keyX - focusX;
+      const deltaY = keyY - focusY;
+      const angle = Math.atan2(deltaX, deltaY);
+      const distance = getDistance(key, focusKey);
+
+      const angleDelta = Math.abs(wantedAngle - angle);
+
+      if (
+        isOptimalAngle
+          ? angleDelta > Number.EPSILON
+          : angleDelta >= angleThreshold
+      )
+        continue;
+      if (distance > bestDistance) continue;
+
+      bestDistance = distance;
+      bestCandidate = i;
+      isOptimalAngle = angleDelta <= Number.EPSILON;
+    }
+
+    const node = groupParent.children.item(bestCandidate);
+    if (node instanceof SVGGElement) {
+      node.focus();
+    }
+  }
+
+  function edit(index: number) {
+    const keyInfo = layoutInfo.keys[index];
+    if (!keyInfo) return;
+    const clickedGroup = groupParent.children.item(index) as SVGGElement;
+    const nextAction = get(layout)[get(activeLayer)]?.[keyInfo.id];
+    const currentAction = get(deviceLayout)[get(activeLayer)]?.[keyInfo.id];
+    const component = new ActionSelector({
+      target: document.body,
+      props: {
+        currentAction,
+        nextAction: nextAction?.isApplied ? undefined : nextAction?.action,
+      },
+    });
+    const dialog = document.querySelector("dialog > div") as HTMLDivElement;
+    const backdrop = document.querySelector("dialog") as HTMLDialogElement;
+    const dialogRect = dialog.getBoundingClientRect();
+    const groupRect = clickedGroup.getBoundingClientRect();
+
+    const scale = 0.5;
+    const dialogScale = `${1 - scale * (1 - groupRect.width / dialogRect.width)} ${
+      1 - scale * (1 - groupRect.height / dialogRect.height)
+    }`;
+    const dialogTranslate = `${scale * (groupRect.x - dialogRect.x)}px ${
+      scale * (groupRect.y - dialogRect.y)
+    }px`;
+
+    const duration = 150;
+    const options = { duration, easing: "ease" };
+    const dialogAnimation = dialog.animate(
+      [
+        { scale: dialogScale, translate: dialogTranslate },
+        { translate: "0 0", scale: "1" },
+      ],
+      options,
+    );
+    const backdropAnimation = backdrop.animate(
+      [{ opacity: 0 }, { opacity: 1 }],
+      options,
+    );
+
+    async function closed() {
+      dialogAnimation.reverse();
+      backdropAnimation.reverse();
+
+      await dialogAnimation.finished;
+
+      component.$destroy();
+    }
+
+    component.$on("close", closed);
+    component.$on("select", ({ detail }) => {
+      changes.update((changes) => {
+        changes.push({
+          type: ChangeType.Layout,
+          id: keyInfo.id,
+          layer: get(activeLayer),
+          action: detail,
+        });
+        return changes;
+      });
+      closed();
+    });
+  }
+
+  let focusKey: CompiledLayoutKey;
+  let groupParent: SVGElement;
+</script>
+
+<svelte:window on:keydown={navigate} />
+
+<svg
+  class="print"
+  viewBox="0 0 {layoutInfo.size[0] * scale} {layoutInfo.size[1] * scale}"
+  bind:this={groupParent}
+  transition:fly={{ y: 48, easing: expoOut }}
+>
+  {#each layoutInfo.keys as key, i}
+    <KeyboardKey
+      {i}
+      {key}
+      on:focusin={() => (focusKey = key)}
+      on:click={() => edit(i)}
+      on:keypress={({ key }) => {
+        if (key === "Enter") {
+          edit(i);
+        }
+      }}
+    />
+  {/each}
+</svg>
+
+<style lang="scss">
+  svg {
+    overflow: visible;
+    grid-area: "d";
+    width: calc(min(100%, 35cm));
+    max-height: calc(100% - 170px);
+  }
+</style>

src/lib/components/layout/KeyText.svelte

@@ -0,0 +1,92 @@
+<script lang="ts">
+  import { getContext } from "svelte";
+  import type { Writable } from "svelte/store";
+  import type { VisualLayoutConfig } from "$lib/components/layout/visual-layout";
+  import type { CompiledLayoutKey } from "$lib/serialization/visual-layout";
+  import { layout } from "$lib/undo-redo.js";
+  import { osLayout } from "$lib/os-layout.js";
+  import { KEYMAP_CODES } from "$lib/serial/keymap-codes";
+  import { action } from "$lib/title";
+
+  const { fontSize, margin, inactiveOpacity, inactiveScale, iconFontSize } =
+    getContext<VisualLayoutConfig>("visual-layout-config");
+  const activeLayer = getContext<Writable<number>>("active-layer");
+
+  export let key: CompiledLayoutKey;
+  export let fontSizeMultiplier = 1;
+
+  export let middle: [number, number];
+  export let pos: [number, number];
+  export let rotate: number;
+
+  export let positions: [[number, number], [number, number], [number, number]];
+</script>
+
+{#each positions as position, layer}
+  {@const { action: actionId, isApplied } = $layout[layer]?.[key.id] ?? {
+    action: 0,
+    isApplied: true,
+  }}
+  {@const { code, icon, id, display, title, keyCode, variant } =
+    KEYMAP_CODES.get(actionId) ?? { code: actionId }}
+  {@const dynamicMapping = keyCode && $osLayout.get(keyCode)}
+  {@const tooltip =
+    (title ?? id ?? `0x${code.toString(16)}`) +
+    (variant === "left" ? " (left)" : variant === "right" ? " (right)" : "")}
+  {@const isActive = layer === $activeLayer}
+  {@const direction = [
+    Math.sign(middle[0]) * (Math.abs(middle[0]) - margin * 3) * position[0],
+    Math.sign(middle[1]) * (Math.abs(middle[1]) - margin * 3) * position[1],
+  ]}
+  {@const hasIcon = !dynamicMapping && !!icon}
+  <text
+    fill={isApplied ? "currentcolor" : "var(--md-sys-color-primary)"}
+    font-weight={isApplied ? "" : "bold"}
+    text-anchor="middle"
+    alignment-baseline="central"
+    x={pos[0] + middle[0] + (isApplied ? 0 : fontSize / 3)}
+    y={pos[1] + middle[1]}
+    font-size={fontSizeMultiplier * (hasIcon ? iconFontSize : fontSize)}
+    font-family={hasIcon ? "Material Symbols Rounded" : undefined}
+    opacity={isActive ? 1 : `var(--inactive-opacity, ${inactiveOpacity})`}
+    style:scale={isActive ? 1 : `var(--inactive-scale, ${inactiveScale})`}
+    style:translate={isActive
+      ? "0 0 0"
+      : `${direction[0]?.toPrecision(2)}px ${direction[1]?.toPrecision(2)}px 0`}
+    style:rotate="{rotate}deg"
+    use:action={{ title: tooltip }}
+  >
+    {#if code !== 0}
+      {dynamicMapping || icon || display || id || `0x${code.toString(16)}`}
+    {/if}
+    {#if !isApplied}
+      <tspan>•</tspan>
+    {/if}
+  </text>
+{/each}
+
+<style lang="scss">
+  $focus-transition: 10ms;
+  $transition: 200ms;
+
+  text {
+    will-change: translate, scale;
+    user-select: none;
+    transform-origin: center;
+    transform-box: fill-box;
+    transition:
+      fill #{$focus-transition} ease,
+      opacity #{$transition} ease,
+      translate #{$transition} ease,
+      scale #{$transition} ease;
+
+    @media (prefers-contrast: more) {
+      --inactive-opacity: 0.8;
+      --inactive-scale: 0.7;
+    }
+  }
+
+  text:focus-within {
+    outline: none;
+  }
+</style>

src/lib/components/layout/KeyboardKey.svelte

@@ -0,0 +1,133 @@
+<script lang="ts">
+  import type { CompiledLayoutKey } from "$lib/serialization/visual-layout";
+  import { getContext } from "svelte";
+  import type { VisualLayoutConfig } from "./visual-layout.js";
+  import KeyText from "$lib/components/layout/KeyText.svelte";
+
+  const { scale, margin, strokeWidth } = getContext<VisualLayoutConfig>(
+    "visual-layout-config",
+  );
+  export let i: number;
+  export let key: CompiledLayoutKey;
+
+  $: posX = key.pos[0] * scale;
+  $: posY = key.pos[1] * scale;
+  $: sizeX = key.size[0] * scale;
+  $: sizeY = key.size[1] * scale;
+</script>
+
+<g
+  class="key-group"
+  on:click
+  on:keypress
+  on:focusin
+  role="button"
+  tabindex={i + 1}
+>
+  {#if key.shape === "square"}
+    <rect
+      x={posX + margin}
+      y={posY + margin}
+      rx={key.cornerRadius * scale}
+      width={sizeX - margin * 2}
+      height={sizeY - margin * 2}
+      stroke-width={strokeWidth}
+    />
+    <KeyText
+      {key}
+      middle={[sizeX / 2, sizeY / 2]}
+      pos={[posX, posY]}
+      rotate={-key.rotate}
+      positions={[
+        [-1, 1],
+        [-1, -1],
+        [1, -1],
+      ]}
+    />
+  {:else if key.shape === "quarter-circle"}
+    {@const innerMargin = margin / 2}
+    {@const r1 = sizeX / 2 - margin}
+    {@const p1 = r1 - innerMargin}
+    {@const r2 = r1 - sizeY + innerMargin * 2}
+    {@const p2 = r2 - innerMargin}
+    {@const multiplier = 1.25}
+
+    {@const rotateRad = (key.rotate + 45) * (Math.PI / 180)}
+    {@const rotX =
+      Math.round(
+        (Math.abs(Math.cos(rotateRad - Math.PI / 2)) + Number.EPSILON) * 100,
+      ) / 100}
+    {@const rotY =
+      Math.round(
+        (Math.abs(Math.sin(rotateRad - Math.PI / 2)) + Number.EPSILON) * 100,
+      ) / 100}
+
+    {@const rc = r1 - (r1 - r2) / 2}
+    {@const middleX = Math.cos(rotateRad) * rc}
+    {@const middleY = Math.sin(rotateRad) * rc}
+    <path
+      style:transform="rotateZ({key.rotate}deg) translate({innerMargin}px, {innerMargin}px)"
+      d="M{posX + p1},{posY} a{r1},{r1} 0 0,1 {-p1},{p1} l0,{-(
+        p1 - p2
+      )} a{r2},{r2} 0 0,0 {p2},{-p2}z"
+    />
+    <KeyText
+      {key}
+      middle={[middleX, middleY]}
+      pos={[posX, posY]}
+      rotate={0}
+      fontSizeMultiplier={multiplier}
+      positions={[
+        [-rotY, -rotX],
+        [-rotX, -rotY],
+        [rotX, rotY],
+      ]}
+    />
+  {/if}
+</g>
+
+<style lang="scss">
+  $focus-transition: 10ms;
+  $transition: 200ms;
+
+  rect {
+    transform-origin: center;
+    transform-box: fill-box;
+  }
+
+  path,
+  g {
+    transform-origin: top left;
+    transform-box: fill-box;
+  }
+
+  path,
+  rect {
+    fill: var(--md-sys-color-background);
+    fill-opacity: 0;
+    stroke: currentcolor;
+  }
+
+  path {
+    fill: currentcolor;
+    fill-opacity: 0;
+    stroke-opacity: 0.3;
+  }
+
+  g:hover {
+    cursor: default;
+    opacity: 0.6;
+    transition: opacity #{$transition} ease;
+  }
+
+  g:focus-within {
+    color: var(--md-sys-color-primary);
+    outline: none;
+
+    > path,
+    > rect {
+      fill: currentcolor;
+      fill-opacity: 0.2;
+    }
+  }
+</style>

src/lib/components/layout/Layout.svelte

@@ -0,0 +1,131 @@
+<script lang="ts">
+  import { serialPort } from "$lib/serial/connection";
+  import { action } from "$lib/title";
+  import GenericLayout from "$lib/components/layout/GenericLayout.svelte";
+  import { getContext } from "svelte";
+  import type { Writable } from "svelte/store";
+  import type { VisualLayout } from "$lib/serialization/visual-layout";
+  import { fade } from "svelte/transition";
+
+  $: device = $serialPort?.device;
+  const activeLayer = getContext<Writable<number>>("active-layer");
+
+  const layers = [
+    ["Numeric Layer", "123", 1],
+    ["Primary Layer", "abc", 0],
+    ["Function Layer", "function", 2],
+  ] as const;
+
+  const layouts = {
+    ONE: () =>
+      import("$lib/assets/layouts/one.yml").then(
+        (it) => it.default as VisualLayout,
+      ),
+    TWO: () =>
+      import("$lib/assets/layouts/one.yml").then(
+        (it) => it.default as VisualLayout,
+      ),
+    LITE: () =>
+      import("$lib/assets/layouts/lite.yml").then(
+        (it) => it.default as VisualLayout,
+      ),
+    X: () =>
+      import("$lib/assets/layouts/generic/103-key.yml").then(
+        (it) => it.default as VisualLayout,
+      ),
+  };
+</script>
+
+<div class="container">
+  {#if device}
+    {#await layouts[device]() then visualLayout}
+      <fieldset transition:fade>
+        {#each layers as [title, icon, value]}
+          <button
+            class="icon"
+            use:action={{ title, shortcut: `alt+${value + 1}` }}
+            on:click={() => ($activeLayer = value)}
+            class:active={$activeLayer === value}
+          >
+            {icon}
+          </button>
+        {/each}
+      </fieldset>
+
+      <GenericLayout {visualLayout} />
+    {/await}
+  {/if}
+</div>
+
+<style lang="scss">
+  .container {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+
+    width: 100%;
+    height: 100%;
+    margin-bottom: 96px;
+  }
+
+  fieldset {
+    position: relative;
+
+    display: flex;
+    align-items: center;
+    justify-content: center;
+
+    padding: 8px;
+
+    border: none;
+  }
+
+  button.icon {
+    cursor: pointer;
+
+    z-index: 1;
+
+    font-size: 24px;
+    color: var(--md-sys-color-on-surface-variant);
+
+    background: var(--md-sys-color-surface-variant);
+    border: none;
+
+    transition: all 250ms ease;
+
+    &:nth-child(2) {
+      z-index: 2;
+
+      aspect-ratio: 1;
+
+      font-size: 32px;
+
+      border-radius: 50%;
+    }
+
+    &:first-child,
+    &:last-child {
+      aspect-ratio: unset;
+      height: unset;
+    }
+
+    &:first-child {
+      margin-inline-end: -8px;
+      padding-inline: 4px 24px;
+      border-radius: 16px 0 0 16px;
+    }
+
+    &:last-child {
+      margin-inline-start: -8px;
+      padding-inline: 24px 4px;
+      border-radius: 0 16px 16px 0;
+    }
+
+    &.active {
+      font-weight: 900;
+      color: var(--md-sys-color-on-tertiary);
+      background: var(--md-sys-color-tertiary);
+    }
+  }
+</style>

src/lib/components/layout/visual-layout.ts

@@ -0,0 +1,9 @@
+export interface VisualLayoutConfig {
+  scale: number;
+  inactiveScale: number;
+  inactiveOpacity: number;
+  strokeWidth: number;
+  margin: number;
+  fontSize: number;
+  iconFontSize: number;
+}

src/lib/dialogs/ConfirmDialog.svelte

@@ -0,0 +1,41 @@
+<script lang="ts">
+  import { createEventDispatcher } from "svelte";
+  import Dialog from "$lib/dialogs/Dialog.svelte";
+  import ActionString from "$lib/components/ActionString.svelte";
+
+  export let title: string;
+  export let message: string | undefined;
+  export let abortTitle: string;
+  export let confirmTitle: string;
+
+  export let actions: number[] = [];
+
+  const dispatch = createEventDispatcher();
+</script>
+
+<Dialog>
+  <h1>{@html title}</h1>
+  {#if message}
+    <p>{@html message}</p>
+  {/if}
+  <p><ActionString {actions} /></p>
+  <div class="buttons">
+    <button on:click={() => dispatch("abort")}>{abortTitle}</button>
+    <button class="primary" on:click={() => dispatch("confirm")}
+      >{confirmTitle}</button
+    >
+  </div>
+</Dialog>
+
+<style lang="scss">
+  h1 {
+    font-size: 2em;
+    text-align: center;
+  }
+
+  .buttons {
+    display: flex;
+    justify-content: flex-end;
+    width: 100%;
+  }
+</style>

src/lib/dialogs/Dialog.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+  import { onMount } from "svelte";
+
+  onMount(() => {
+    modal.showModal();
+  });
+
+  let modal: HTMLDialogElement;
+</script>
+
+<dialog bind:this={modal}>
+  <slot />
+</dialog>
+
+<style lang="scss">
+  dialog {
+    min-width: 300px;
+    max-width: 512px;
+
+    color: var(--md-sys-color-on-background);
+
+    background: var(--md-sys-color-background);
+    border: none;
+    border-radius: 38px;
+    box-shadow: 0 0 48px rgba(0 0 0 / 60%);
+  }
+
+  dialog::backdrop {
+    opacity: 0.5;
+    background: black;
+  }
+</style>

src/lib/dialogs/PickChangesDialog.svelte

@@ -0,0 +1,217 @@
+<script lang="ts">
+  import Dialog from "$lib/dialogs/Dialog.svelte";
+  import type {
+    Change,
+    ChordChange,
+    LayoutChange,
+    SettingChange,
+  } from "$lib/undo-redo";
+  import { ChangeType, chords } from "$lib/undo-redo";
+  import ActionString from "$lib/components/ActionString.svelte";
+  import LL from "$i18n/i18n-svelte";
+  import { KEYMAP_IDS } from "$lib/serial/keymap-codes";
+
+  export let changes: Change[] = [
+    { type: ChangeType.Layout, layer: 0, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Layout, layer: 1, id: 1, action: 1 },
+    { type: ChangeType.Setting, id: 0, setting: 2 },
+    { type: ChangeType.Setting, id: 0, setting: 2 },
+    { type: ChangeType.Setting, id: 0, setting: 2 },
+    { type: ChangeType.Setting, id: 0, setting: 2 },
+    {
+      type: ChangeType.Chord,
+      id: [1],
+      actions: [55],
+      phrase: [55, 63, 37, 36],
+    },
+    {
+      type: ChangeType.Chord,
+      id: [
+        KEYMAP_IDS.get("y")!.code,
+        KEYMAP_IDS.get("r")!.code,
+        KEYMAP_IDS.get("t")!.code,
+      ],
+      actions: [
+        KEYMAP_IDS.get("y")!.code,
+        KEYMAP_IDS.get("r")!.code,
+        KEYMAP_IDS.get("t")!.code,
+      ],
+      phrase: [55, 63, 37, 36],
+    },
+    {
+      type: ChangeType.Chord,
+      id: [
+        KEYMAP_IDS.get("y")!.code,
+        KEYMAP_IDS.get("r")!.code,
+        KEYMAP_IDS.get("t")!.code,
+      ],
+      actions: [
+        KEYMAP_IDS.get("y")!.code,
+        KEYMAP_IDS.get("r")!.code,
+        KEYMAP_IDS.get("t")!.code,
+      ],
+      phrase: [],
+    },
+  ];
+
+  $: existingChords = new Set($chords.map((it) => JSON.stringify(it.id)));
+
+  $: layoutChanges = Array.from(
+    { length: 3 },
+    (_, i) =>
+      changes.filter(
+        (it) => it.type === ChangeType.Layout && it.layer === i,
+      ) as LayoutChange[],
+  );
+  $: settingChanges = changes.filter(
+    (it) => it.type === ChangeType.Setting,
+  ) as SettingChange[];
+  $: chordChanges = {
+    added: changes.filter(
+      (it) =>
+        it.type === ChangeType.Chord &&
+        it.phrase.length > 0 &&
+        !existingChords.has(JSON.stringify(it.id)),
+    ) as ChordChange[],
+    changed: changes.filter(
+      (it) =>
+        it.type === ChangeType.Chord &&
+        it.phrase.length > 0 &&
+        existingChords.has(JSON.stringify(it.id)),
+    ) as ChordChange[],
+    deleted: changes.filter(
+      (it) => it.type === ChangeType.Chord && it.phrase.length === 0,
+    ) as ChordChange[],
+  };
+  $: totalChordChanges = Object.values(chordChanges).reduce(
+    (acc, curr) => acc + curr.length,
+    0,
+  );
+</script>
+
+<Dialog>
+  <h1>{$LL.changes.TITLE()}</h1>
+  <h2>
+    <label
+      ><input
+        type="checkbox"
+        class="checkbox"
+      />{$LL.changes.ALL_CHANGES()}</label
+    >
+  </h2>
+  <ul>
+    {#if layoutChanges.some((it) => it.length > 0)}
+      <li>
+        <h3>
+          <label>
+            <input type="checkbox" class="checkbox" />
+            {$LL.changes.layout.TITLE(
+              layoutChanges.reduce((acc, curr) => acc + curr.length, 0),
+            )}
+          </label>
+        </h3>
+        <ul>
+          {#each layoutChanges as changes, i}
+            {@const layer = i + 1}
+            {#if changes.length > 0}
+              <li>
+                <h4>
+                  <label>
+                    <input type="checkbox" class="checkbox" />
+                    {$LL.changes.layout.LAYER({
+                      changes: changes.length,
+                      layer,
+                    })}
+                  </label>
+                </h4>
+              </li>
+            {/if}
+          {/each}
+        </ul>
+      </li>
+    {/if}
+    {#if settingChanges.length > 0}
+      <li>
+        <h3>
+          <label
+            ><input
+              type="checkbox"
+              class="checkbox"
+            />{$LL.changes.settings.TITLE(settingChanges.length)}</label
+          >
+        </h3>
+      </li>
+    {/if}
+    {#if totalChordChanges > 0}
+      <li>
+        <h3>
+          <label
+            ><input
+              type="checkbox"
+              class="checkbox"
+            />{$LL.changes.chords.TITLE(totalChordChanges)}</label
+          >
+        </h3>
+        <ul>
+          {#each Object.entries(chordChanges) as [category, changes]}
+            {#if changes.length > 0}
+              <li>
+                <h4>
+                  <label
+                    ><input type="checkbox" class="checkbox" />
+                    {#if category === "added"}
+                      {$LL.changes.chords.NEW_CHORDS(changes.length)}
+                    {:else if category === "changed"}
+                      {$LL.changes.chords.CHANGED_CHORDS(changes.length)}
+                    {:else if category === "deleted"}
+                      {$LL.changes.chords.DELETED_CHORDS(changes.length)}
+                    {/if}
+                  </label>
+                </h4>
+                <ul>
+                  {#each changes as change}
+                    <li>
+                      <label>
+                        <input type="checkbox" class="checkbox" />
+                        <ActionString display="keys" actions={change.actions} />
+                        <ActionString actions={change.phrase} />
+                      </label>
+                    </li>
+                  {/each}
+                </ul>
+              </li>
+            {/if}
+          {/each}
+        </ul>
+      </li>
+    {/if}
+  </ul>
+</Dialog>
+
+<style lang="scss">
+  h1 {
+    font-size: 2em;
+    text-align: center;
+  }
+
+  h2 {
+    font-size: 1.5em;
+  }
+
+  ul {
+    padding-inline-start: 0;
+    list-style: none;
+  }
+
+  li {
+    margin-inline-start: 24px;
+  }
+</style>

src/lib/dialogs/confirm-dialog.ts

@@ -0,0 +1,33 @@
+import ConfirmDialog from "$lib/dialogs/ConfirmDialog.svelte";
+
+export async function askForConfirmation(
+  title: string,
+  message: string,
+  confirmTitle: string,
+  abortTitle: string,
+  actions: number[],
+): Promise<boolean> {
+  const dialog = new ConfirmDialog({
+    target: document.body,
+    props: {
+      title,
+      message,
+      confirmTitle,
+      abortTitle,
+      actions,
+    },
+  });
+
+  let resolvePromise: (value: boolean) => void;
+  const resultPromise = new Promise<boolean>((resolve) => {
+    resolvePromise = resolve;
+  });
+
+  dialog.$on("abort", () => resolvePromise(false));
+  dialog.$on("confirm", () => resolvePromise(true));
+
+  const result = await resultPromise;
+  dialog.$destroy();
+
+  return result;
+}

src/lib/fonts/material-symbols-rounded.scss

@@ -15,8 +15,10 @@
   font-family: "Material Symbols Rounded";
   font-size: 24px;
   font-feature-settings: "liga";
-  font-variation-settings: "FILL" var(--icon-fill, 0), "wght" var(--icon-weigth, 400), "GRAD"
+  font-variation-settings:
-    var(--icon-grade, 0);
+    "FILL" var(--icon-fill, 0),
+    "wght" var(--icon-weigth, 400),
+    "GRAD" var(--icon-grade, 0);
   font-weight: normal;
   font-style: normal;
   line-height: 1;

src/lib/fonts/noto-sans-mono.scss

@@ -73,8 +73,9 @@
   font-stretch: 62.5% 100%;
   src: url("@fontsource-variable/noto-sans-mono/files/noto-sans-mono-latin-ext-wght-normal.woff2")
     format("woff2-variations");
-  unicode-range: U+0100-02AF, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1E00-1EFF, U+2020,
+  unicode-range: U+0100-02AF, U+0300-0301, U+0303-0304, U+0308-0309, U+0323,
-    U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+    U+0329, U+1E00-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F,
+    U+A720-A7FF;
 }
 
 /* noto-sans-mono-latin-wght-normal */
@@ -86,7 +87,7 @@
   font-stretch: 62.5% 100%;
   src: url("@fontsource-variable/noto-sans-mono/files/noto-sans-mono-latin-wght-normal.woff2")
     format("woff2-variations");
-  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0300-0301,
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
-    U+0303-0304, U+0308-0309, U+0323, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212,
+    U+02DC, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+2000-206F,
-    U+2215, U+FEFF, U+FFFD;
+    U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
 }

src/lib/os-layout.ts

@@ -0,0 +1,27 @@
+import { get, writable } from "svelte/store";
+
+export const osLayout = writable<Map<string, string>>(new Map());
+
+async function updateLayout() {
+  const layout: Map<string, string> = await (
+    navigator as any
+  ).keyboard.getLayoutMap();
+  const currentLayout = get(osLayout);
+  if (
+    layout.size !== currentLayout.size ||
+    [...layout.keys()].some((key) => layout.get(key) !== currentLayout.get(key))
+  ) {
+    osLayout.set(layout);
+  }
+}
+
+export function runLayoutDetection(): () => void {
+  if ("keyboard" in navigator) {
+    updateLayout();
+    const timer = setInterval(updateLayout, 5000);
+    return () => clearInterval(timer);
+  } else {
+    console.warn("Keyboard API not supported");
+    return () => {};
+  }
+}

src/lib/popup.ts

@@ -0,0 +1,31 @@
+import tippy from "tippy.js";
+import type { Action } from "svelte/action";
+import type { ComponentType, SvelteComponent } from "svelte";
+
+export const popup: Action<HTMLButtonElement, ComponentType> = (
+  node,
+  Component,
+) => {
+  let component: SvelteComponent | undefined;
+  let target: HTMLElement | undefined;
+  const edit = tippy(node, {
+    interactive: true,
+    trigger: "click",
+    onShow(instance) {
+      target = instance.popper.querySelector(".tippy-content") as HTMLElement;
+      target.classList.add("active");
+      component ??= new Component({ target });
+    },
+    onHidden() {
+      component?.$destroy();
+      target?.classList.remove("active");
+      component = undefined;
+    },
+  });
+
+  return {
+    destroy() {
+      edit.destroy();
+    },
+  };
+};

src/lib/preferences.ts

@@ -0,0 +1,43 @@
+import type { Action } from "svelte/action";
+import { persistentWritable } from "$lib/storage";
+
+export interface UserPreferences {
+  backup: boolean;
+  autoConnect: boolean;
+}
+
+export const theme = persistentWritable("user-theme", {
+  color: "#6D81C7",
+  mode: "dark" as "light" | "dark" | "auto",
+});
+
+export const userPreferences = persistentWritable<UserPreferences>(
+  "user-preferences",
+  {
+    backup: false,
+    autoConnect: false,
+  },
+);
+
+export const preference: Action<HTMLInputElement, keyof UserPreferences> = (
+  node,
+  key,
+) => {
+  const unsubscribe = userPreferences.subscribe((it) => {
+    node.checked = it[key];
+  });
+  function update() {
+    userPreferences.update((value) => {
+      value[key] = node.checked;
+      return value;
+    });
+  }
+  node.addEventListener("input", update);
+
+  return {
+    destroy() {
+      unsubscribe();
+      node.removeEventListener("input", update);
+    },
+  };
+};

src/lib/profile.ts

@@ -1,8 +0,0 @@
-import type {CharaLayout} from "$lib/serial/connection"
-import type {Chord} from "$lib/serial/chord"
-
-export interface Profile {
-  name: string
-  layout: CharaLayout
-  chords: Chord[]
-}

src/lib/serial/TauriSerialDialog.svelte

@@ -0,0 +1,30 @@
+<script lang="ts">
+  import { createEventDispatcher } from "svelte";
+
+  export let ports: SerialPort[];
+  const dispatch = createEventDispatcher<{ confirm: SerialPort | undefined }>();
+  let selected = ports[0]?.getInfo().name;
+</script>
+
+<dialog>
+  {#each ports as port}
+    {@const info = port.getInfo()}
+    <label
+      >{info.product}<input
+        type="radio"
+        name="port"
+        value={info.name}
+        bind:group={selected}
+      /></label
+    >
+  {/each}
+
+  <button on:click={() => dispatch("confirm", undefined)}>Cancel</button>
+  <button
+    on:click={() =>
+      dispatch(
+        "confirm",
+        ports.find((it) => it.getInfo().name === selected),
+      )}>Ok</button
+  >
+</dialog>

src/lib/serial/chord.spec.ts

@@ -1,42 +1,60 @@
-import {describe, it, expect} from "vitest"
+import { describe, it, expect } from "vitest";
 import {
-  chordAsCommandCompatible,
-  chordFromCommandCompatible,
   deserializeActions,
+  parseChordActions,
+  parsePhrase,
   serializeActions,
-} from "./chord"
+  stringifyChordActions,
-import type {Chord} from "./chord"
+  stringifyPhrase,
+} from "./chord";
 
 describe("chords", function () {
   describe("actions", function () {
     it("should serialize actions", function () {
-      expect(serializeActions([32, 51]).toString(16)).toEqual(0xcc200000000000000000000000000n.toString(16))
+      expect(serializeActions([32, 51]).toString(16)).toEqual(
-    })
+        0xcc200000000000000000000000000n.toString(16),
+      );
+    });
 
     it("should deserialize actions", function () {
-      expect(deserializeActions(0xcc200000000000000000000000000n)).toEqual([32, 51])
+      expect(deserializeActions(0xcc200000000000000000000000000n)).toEqual([
-    })
+        32, 51,
+      ]);
+    });
 
     for (let i = 0; i < 12; i++) {
       it(`should serialize back-forth ${i} actions`, function () {
-        const actions = Array.from({length: i}).map((_, i) => i + 1)
+        const actions = Array.from({ length: i }).map((_, i) => i + 1);
-        expect(deserializeActions(serializeActions(actions))).toEqual(actions)
+        expect(deserializeActions(serializeActions(actions))).toEqual(actions);
-      })
+      });
     }
-  })
+  });
 
-  describe("commands", function () {
+  describe("phrase", function () {
-    it("should convert to a command", function () {
+    it("should stringify", function () {
-      expect(chordAsCommandCompatible({actions: [32, 51], phrase: [0x01, 0x68, 0x72, 0xd4, 0x65]})).toEqual(
+      expect(stringifyPhrase([0x20, 0x68, 0x72, 0xd4, 0x65, 0x1fff])).toEqual(
-        "000CC200000000000000000000000000 016872D465",
+        "206872D4651FFF",
-      )
+      );
-    })
+    });
 
-    it("should parse a command", function () {
+    it("should parse", function () {
-      expect(chordFromCommandCompatible("000CC200000000000000000000000000 016872D465")).toEqual({
+      expect(parsePhrase("206872D4651FFF")).toEqual([
-        actions: [32, 51],
+        0x20, 0x68, 0x72, 0xd4, 0x65, 0x1fff,
-        phrase: [0x01, 0x68, 0x72, 0xd4, 0x65],
+      ]);
-      })
+    });
-    })
+  });
-  })
+
-})
+  describe("chord actions", function () {
+    it("should stringify", function () {
+      expect(stringifyChordActions([32, 51])).toEqual(
+        "000CC200000000000000000000000000",
+      );
+    });
+
+    it("should parse", function () {
+      expect(parseChordActions("000CC200000000000000000000000000")).toEqual([
+        32, 51,
+      ]);
+    });
+  });
+});

src/lib/serial/chord.ts

@@ -1,32 +1,31 @@
+import { compressActions, decompressActions } from "../serialization/actions";
+
 export interface Chord {
-  actions: number[]
+  actions: number[];
-  phrase: number[]
+  phrase: number[];
 }
 
-/**
+export function parsePhrase(phrase: string): number[] {
- * Turns a chord into a serial-command-compatible string
+  return decompressActions(
- *
+    Uint8Array.from({ length: phrase.length / 2 }).map((_, i) =>
- * @example "000CC200000000000000000000000000 7468726565"
- */
-export function chordAsCommandCompatible(chord: Chord): string {
-  return `${serializeActions(chord.actions).toString(16).padStart(32, "0")} ${chord.phrase
-    .map(it => it.toString(16).padStart(2, "0"))
-    .join("")}`.toUpperCase()
-}
-
-/**
- * Turns a command response into a chord
- *
- * @see {chordAsCommandCompatible}
- */
-export function chordFromCommandCompatible(command: string): Chord {
-  const [actions, phrase] = command.split(" ")
-  return {
-    actions: deserializeActions(BigInt(`0x${actions}`)),
-    phrase: Array.from({length: phrase.length / 2}).map((_, i) =>
       Number.parseInt(phrase.slice(i * 2, i * 2 + 2), 16),
     ),
-  }
+  );
+}
+
+export function stringifyPhrase(phrase: number[]): string {
+  return [...compressActions(phrase)]
+    .map((it) => it.toString(16).padStart(2, "0"))
+    .join("")
+    .toUpperCase();
+}
+
+export function parseChordActions(actions: string): number[] {
+  return deserializeActions(BigInt(`0x${actions}`));
+}
+
+export function stringifyChordActions(actions: number[]): string {
+  return serializeActions(actions).toString(16).padStart(32, "0").toUpperCase();
 }
 
 /**
@@ -35,25 +34,24 @@ export function chordFromCommandCompatible(command: string): Chord {
  * Actions are represented as 10-bit codes, for a maximum of 12 actions
  */
 export function serializeActions(actions: number[]): bigint {
-  let native = 0n
+  let native = 0n;
   for (let i = 1; i <= actions.length; i++) {
-    native |= BigInt(actions[actions.length - i] & 0x3ff) << BigInt((12 - i) * 10)
+    native |=
+      BigInt(actions[actions.length - i]! & 0x3ff) << BigInt((12 - i) * 10);
   }
-  return native
+  return native;
 }
 
 /**
  * @see {serializeActions}
  */
 export function deserializeActions(native: bigint): number[] {
-  const actions = []
+  const actions = [];
   for (let i = 0; i < 12; i++) {
-    const action = Number(native & 0x3ffn)
+    const action = Number(native & 0x3ffn);
-    if (action !== 0) {
+    actions.push(action);
-      actions.push(action)
+    native >>= 10n;
-    }
-    native >>= 10n
   }
 
-  return actions
+  return actions;
 }

src/lib/serial/connection.ts

@@ -1,47 +1,108 @@
-import {writable} from "svelte/store"
+import { get, writable } from "svelte/store";
-import {CharaDevice} from "$lib/serial/device"
+import { CharaDevice } from "$lib/serial/device";
-import type {Chord} from "$lib/serial/chord"
+import type { Chord } from "$lib/serial/chord";
-import type {Writable} from "svelte/store"
+import type { Writable } from "svelte/store";
+import type { CharaLayout } from "$lib/serialization/layout";
+import { persistentWritable } from "$lib/storage";
+import { userPreferences } from "$lib/preferences";
+import settingInfo from "$lib/assets/settings.yml";
 
-export const serialPort = writable<CharaDevice>()
+export const serialPort = writable<CharaDevice | undefined>();
 
 export interface SerialLogEntry {
-  type: "input" | "output" | "system"
+  type: "input" | "output" | "system";
-  value: string
+  value: string;
 }
 
-export const serialLog = writable<SerialLogEntry[]>([])
+export const serialLog = writable<SerialLogEntry[]>([]);
 
-export const chords = writable<Chord[]>([])
+/**
+ * Chords as read from the device
+ */
+export const deviceChords = persistentWritable<Chord[]>(
+  "chord-library",
+  [],
+  () => get(userPreferences).backup,
+);
 
-export type CharaLayout = [number[], number[], number[]]
+/**
+ * Layout as read from the device
+ */
+export const deviceLayout = persistentWritable<CharaLayout>(
+  "layout",
+  [[], [], []],
+  () => get(userPreferences).backup,
+);
 
-export const layout = writable<CharaLayout>([[], [], []])
+/**
+ * Settings as read from the device
+ */
+export const deviceSettings = persistentWritable<number[]>(
+  "device-settings",
+  [],
+  () => get(userPreferences).backup,
+);
 
-export const unsavedChanges = writable(0)
+export const syncStatus: Writable<
+  "done" | "error" | "downloading" | "uploading"
+> = writable("done");
 
-export const syncStatus: Writable<"done" | "error" | "downloading" | "uploading"> = writable("done")
+export interface ProgressInfo {
+  max: number;
+  current: number;
+}
+export const syncProgress = writable<ProgressInfo | undefined>(undefined);
 
-let device: CharaDevice // @hmr:keep
+export async function initSerial(manual = false) {
+  const device = get(serialPort) ?? new CharaDevice();
+  await device.init(manual);
+  serialPort.set(device);
+  await sync();
+}
 
-export async function initSerial() {
+export async function sync() {
-  syncStatus.set("downloading")
+  const device = get(serialPort);
-  device ??= new CharaDevice()
+  if (!device) return;
-  serialPort.set(device)
+  const chordCount = await device.getChordCount();
+  syncStatus.set("downloading");
 
-  const parsedLayout: CharaLayout = [[], [], []]
+  const max =
+    Object.keys(settingInfo["settings"]).length +
+    device.keyCount * 3 +
+    chordCount;
+  let current = 0;
+  syncProgress.set({ max, current });
+  function progressTick() {
+    current++;
+    syncProgress.set({ max, current });
+  }
+
+  const parsedSettings: number[] = [];
+  for (const key in settingInfo["settings"]) {
+    try {
+      parsedSettings[Number.parseInt(key)] = await device.getSetting(
+        Number.parseInt(key),
+      );
+    } catch {}
+    progressTick();
+  }
+  deviceSettings.set(parsedSettings);
+
+  const parsedLayout: CharaLayout = [[], [], []];
   for (let layer = 1; layer <= 3; layer++) {
-    for (let i = 0; i < 90; i++) {
+    for (let i = 0; i < device.keyCount; i++) {
-      parsedLayout[layer - 1][i] = await device.getLayoutKey(layer, i)
+      parsedLayout[layer - 1]![i] = await device.getLayoutKey(layer, i);
+      progressTick();
     }
   }
-  layout.set(parsedLayout)
+  deviceLayout.set(parsedLayout);
 
-  const chordCount = await device.getChordCount()
+  const chordInfo = [];
-  const chordInfo = []
   for (let i = 0; i < chordCount; i++) {
-    chordInfo.push(await device.getChord(i))
+    chordInfo.push(await device.getChord(i));
+    progressTick();
   }
-  chords.set(chordInfo)
+  deviceChords.set(chordInfo);
-  syncStatus.set("done")
+  syncStatus.set("done");
+  syncProgress.set(undefined);
 }

src/lib/serial/device.ts

@@ -1,142 +1,440 @@
-import {LineBreakTransformer} from "$lib/serial/line-break-transformer"
+import { LineBreakTransformer } from "$lib/serial/line-break-transformer";
-import {serialLog} from "$lib/serial/connection"
+import { serialLog } from "$lib/serial/connection";
-import type {Chord} from "$lib/serial/chord"
+import type { Chord } from "$lib/serial/chord";
-import {chordFromCommandCompatible} from "$lib/serial/chord"
+import { SemVer } from "$lib/serial/sem-ver";
+import {
+  parseChordActions,
+  parsePhrase,
+  stringifyChordActions,
+  stringifyPhrase,
+} from "$lib/serial/chord";
+import { browser } from "$app/environment";
 
-export const VENDOR_ID = 0x239a
+const PORT_FILTERS: Map<string, SerialPortFilter> = new Map([
+  ["ONE M0", { usbProductId: 32783, usbVendorId: 9114 }],
+  ["TWO S3", { usbProductId: 0x0056, usbVendorId: 0x2886 }],
+  ["LITE S2", { usbProductId: 33070, usbVendorId: 12346 }],
+  ["LITE M0", { usbProductId: 32796, usbVendorId: 9114 }],
+  ["X", { usbProductId: 33163, usbVendorId: 12346 }],
+]);
 
-export async function hasSerialPermission() {
+const KEY_COUNTS = {
-  return navigator.serial.getPorts().then(it => it.length > 0)
+  ONE: 90,
+  TWO: 90,
+  LITE: 67,
+  X: 256,
+} as const;
+
+if (
+  browser &&
+  navigator.serial === undefined &&
+  import.meta.env.TAURI_FAMILY !== undefined
+) {
+  await import("./tauri-serial");
+}
+
+export async function getViablePorts(): Promise<SerialPort[]> {
+  return navigator.serial.getPorts().then((ports) =>
+    ports.filter((it) => {
+      const { usbProductId, usbVendorId } = it.getInfo();
+      for (const filter of PORT_FILTERS.values()) {
+        if (
+          filter.usbProductId === usbProductId &&
+          filter.usbVendorId === usbVendorId
+        ) {
+          return true;
+        }
+      }
+      return false;
+    }),
+  );
+}
+
+type LengthArray<T, N extends number, R extends T[] = []> = number extends N
+  ? T[]
+  : R["length"] extends N
+    ? R
+    : LengthArray<T, N, [T, ...R]>;
+
+export async function canAutoConnect() {
+  return getViablePorts().then((it) => it.length === 1);
+}
+
+async function timeout<T>(promise: Promise<T>, ms: number): Promise<T> {
+  let timer: number;
+  return Promise.race([
+    promise,
+    new Promise<T>((_, reject) => {
+      timer = setTimeout(
+        () => reject(new Error("Timeout")),
+        ms,
+      ) as unknown as number;
+    }),
+  ]).finally(() => clearTimeout(timer));
 }
 
 export class CharaDevice {
-  private readonly port: Promise<SerialPort>
+  private port!: SerialPort;
-  private readonly reader: Promise<ReadableStreamDefaultReader<string>>
+  private reader!: ReadableStreamDefaultReader<string>;
 
-  private readonly abortController1 = new AbortController()
+  private readonly abortController1 = new AbortController();
-  private readonly abortController2 = new AbortController()
+  private readonly abortController2 = new AbortController();
 
-  private lock?: Promise<true>
+  private streamClosed!: Promise<void>;
 
-  version: Promise<string>
+  private lock?: Promise<true>;
-  deviceId: Promise<string>
 
-  constructor(baudRate = 115200) {
+  private readonly suspendDebounce = 100;
-    this.port = navigator.serial.getPorts().then(async ports => {
+  private suspendDebounceId?: number;
-      const port =
+
-        ports.find(it => it.getInfo().usbVendorId === VENDOR_ID) ??
+  version!: SemVer;
-        (await navigator.serial.requestPort({filters: [{usbVendorId: VENDOR_ID}]}))
+  company!: "CHARACHORDER";
-      await port.open({baudRate})
+  device!: "ONE" | "TWO" | "LITE" | "X";
-      const info = port.getInfo()
+  chipset!: "M0" | "S2" | "S3";
-      serialLog.update(it => {
+  keyCount!: 90 | 67 | 256;
+
+  get portInfo() {
+    return this.port.getInfo();
+  }
+
+  constructor(private readonly baudRate = 115200) {}
+
+  async init(manual = false) {
+    try {
+      const ports = await getViablePorts();
+      this.port =
+        !manual && ports.length === 1
+          ? ports[0]!
+          : await navigator.serial.requestPort({
+              filters: [...PORT_FILTERS.values()],
+            });
+
+      await this.port.open({ baudRate: this.baudRate });
+      const info = this.port.getInfo();
+      serialLog.update((it) => {
         it.push({
           type: "system",
-          value: `Connected; ID: 0x${info.usbProductId?.toString(16)}; Vendor: 0x${info.usbVendorId?.toString(
+          value: `Connected; ID: 0x${info.usbProductId?.toString(
             16,
-          )}`,
+          )}; Vendor: 0x${info.usbVendorId?.toString(16)}`,
-        })
+        });
-        return it
+        return it;
-      })
+      });
-      return port
+      await this.port.close();
-    })
-    this.reader = this.port.then(async port => {
-      const decoderStream = new TextDecoderStream()
-      void port.readable!.pipeTo(decoderStream.writable, {signal: this.abortController1.signal})
 
-      return decoderStream
+      this.version = new SemVer(
-        .readable!.pipeThrough(new TransformStream(new LineBreakTransformer()), {
+        await this.send(1, "VERSION").then(([version]) => version),
-          signal: this.abortController2.signal,
+      );
-        })
+      const [company, device, chipset] = await this.send(3, "ID");
-        .getReader()
+      this.company = company as "CHARACHORDER";
-    })
+      this.device = device as "ONE" | "TWO" | "LITE" | "X";
-    this.lock = this.reader.then(() => {
+      this.chipset = chipset as "M0" | "S2" | "S3";
-      delete this.lock
+      this.keyCount = KEY_COUNTS[this.device];
-      return true
+    } catch (e) {
-    })
+      alert(e);
-    this.version = this.send("VERSION")
+      console.error(e);
-    this.deviceId = this.send("ID")
+      throw e;
+    }
+  }
+
+  private async suspend() {
+    await this.reader.cancel();
+    await this.streamClosed.catch(() => {
+      /** noop */
+    });
+    this.reader.releaseLock();
+    await this.port.close();
+    serialLog.update((it) => {
+      it.push({
+        type: "system",
+        value: "Connection suspended",
+      });
+      return it;
+    });
+  }
+
+  private async wake() {
+    await this.port.open({ baudRate: this.baudRate });
+    const decoderStream = new TextDecoderStream();
+    this.streamClosed = this.port.readable!.pipeTo(decoderStream.writable, {
+      signal: this.abortController1.signal,
+    });
+
+    this.reader = decoderStream
+      .readable!.pipeThrough(new TransformStream(new LineBreakTransformer()), {
+        signal: this.abortController2.signal,
+      })
+      .getReader();
+    serialLog.update((it) => {
+      it.push({
+        type: "system",
+        value: "Connection resumed",
+      });
+      return it;
+    });
   }
 
   private async internalRead() {
-    return this.reader.then(async it => {
+    try {
-      const result: string = await it.read().then(({value}) => value!)
+      const { value } = await timeout(this.reader.read(), 5000);
-      serialLog.update(it => {
+      serialLog.update((it) => {
         it.push({
           type: "output",
-          value: result,
+          value: value!,
-        })
+        });
-        return it
+        return it;
-      })
+      });
-      return result
+      return value!;
-    })
+    } catch (e) {
+      serialLog.update((it) => {
+        it.push({
+          type: "output",
+          value: `${e}`,
+        });
+        return it;
+      });
+    }
+    return undefined;
   }
 
   /**
    * Send a command to the device
    */
   private async internalSend(...command: string[]) {
-    const port = await this.port
+    const writer = this.port.writable!.getWriter();
-    const writer = port.writable!.getWriter()
     try {
-      serialLog.update(it => {
+      serialLog.update((it) => {
         it.push({
           type: "input",
           value: command.join(" "),
-        })
+        });
-        return it
+        return it;
-      })
+      });
-      await writer.write(new TextEncoder().encode(`${command.join(" ")}\r\n`))
+      await writer.write(new TextEncoder().encode(`${command.join(" ")}\r\n`));
     } finally {
-      writer.releaseLock()
+      writer.releaseLock();
     }
   }
 
+  async forget() {
+    await this.port.forget();
+  }
+
   /**
    * Read/write to serial port
    */
   async runWith<T>(
-    callback: (send: typeof this.internalSend, read: typeof this.internalRead) => T | Promise<T>,
+    callback: (
+      send: typeof this.internalSend,
+      read: typeof this.internalRead,
+    ) => T | Promise<T>,
   ): Promise<T> {
     while (this.lock) {
-      await this.lock
+      await this.lock;
     }
-    const send = this.internalSend.bind(this)
+    const send = this.internalSend.bind(this);
-    const read = this.internalRead.bind(this)
+    const read = this.internalRead.bind(this);
-    const exec = new Promise<T>(async resolve => {
+    let resolveLock: (result: true) => void;
-      let result!: T
+    this.lock = new Promise<true>((resolve) => {
-      try {
+      resolveLock = resolve;
-        result = await callback(send, read)
+    });
-      } finally {
+    let result!: T;
-        this.lock = undefined
+    try {
-        resolve(result)
+      if (this.suspendDebounceId) {
+        clearTimeout(this.suspendDebounceId);
+      } else {
+        await this.wake();
       }
-    })
+      result = await callback(send, read);
-    this.lock = exec.then(() => true)
+    } finally {
-    return exec
+      delete this.lock;
+      this.suspendDebounceId = setTimeout(() => {
+        // cannot be locked here as all the code until clearTimeout is sync
+        console.assert(this.lock === undefined);
+        this.lock = this.suspend().then(() => {
+          delete this.lock;
+          delete this.suspendDebounceId;
+          return true;
+        });
+      }, this.suspendDebounce) as any;
+      resolveLock!(true);
+      return result;
+    }
   }
 
   /**
    * Send to serial port
    */
-  async send(...command: string[]) {
+  async send<T extends number>(
+    expectedLength: T,
+    ...command: string[]
+  ): Promise<LengthArray<string, T>> {
     return this.runWith(async (send, read) => {
-      await send(...command)
+      await send(...command);
-      const commandString = command.join(" ").replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&")
+      const commandString = command
-      return read().then(it => it.replace(new RegExp(`^${commandString} `), ""))
+        .join(" ")
-    })
+        .replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
+      const readResult = await read();
+      if (readResult === undefined) {
+        console.error("No response");
+        return Array(expectedLength).fill("NO_RESPONSE") as LengthArray<
+          string,
+          T
+        >;
+      }
+      const array = readResult
+        .replace(new RegExp(`^${commandString} `), "")
+        .split(" ");
+      if (array.length < expectedLength) {
+        console.error("Response too short");
+        return array.concat(
+          Array(expectedLength - array.length).fill("TOO_SHORT"),
+        ) as LengthArray<string, T>;
+      }
+      return array as LengthArray<string, T>;
+    });
   }
 
   async getChordCount(): Promise<number> {
-    return Number.parseInt(await this.send("CML C0"))
+    const [count] = await this.send(1, "CML C0");
+    return Number.parseInt(count);
   }
 
-  async getChord(index: number): Promise<Chord> {
+  /**
-    return chordFromCommandCompatible(await this.send(`CML C1 ${index}`))
+   * Retrieves a chord by index
+   */
+  async getChord(index: number | number[]): Promise<Chord> {
+    const [actions, phrase] = await this.send(2, `CML C1 ${index}`);
+    return {
+      actions: parseChordActions(actions),
+      phrase: parsePhrase(phrase),
+    };
   }
 
+  /**
+   * Retrieves the phrase for a set of actions
+   */
+  async getChordPhrase(actions: number[]): Promise<number[] | undefined> {
+    const [phrase] = await this.send(
+      1,
+      `CML C2 ${stringifyChordActions(actions)}`,
+    );
+    return phrase === "2" ? undefined : parsePhrase(phrase);
+  }
+
+  async setChord(chord: Chord) {
+    const [status] = await this.send(
+      1,
+      "CML",
+      "C3",
+      stringifyChordActions(chord.actions),
+      stringifyPhrase(chord.phrase),
+    );
+    if (status !== "0") console.error(`Failed with status ${status}`);
+  }
+
+  async deleteChord(chord: Pick<Chord, "actions">) {
+    const status = await this.send(
+      1,
+      `CML C4 ${stringifyChordActions(chord.actions)}`,
+    );
+    if (status?.at(-1) !== "2" && status?.at(-1) !== "0")
+      throw new Error(`Failed with status ${status}`);
+  }
+
+  /**
+   * Sets an action to the layout
+   * @param layer the layer (usually 1-3)
+   * @param id id of the key, refer to the individual device for where each key is
+   * @param action the assigned action id
+   */
+  async setLayoutKey(layer: number, id: number, action: number) {
+    const [status] = await this.send(1, `VAR B4 A${layer} ${id} ${action}`);
+    if (status !== "0") throw new Error(`Failed with status ${status}`);
+  }
+
+  /**
+   * Gets the assigned action from the layout
+   * @param layer the layer (usually 1-3)
+   * @param id id of the key, refer to the individual device for where each key is
+   * @returns the assigned action id
+   */
   async getLayoutKey(layer: number, id: number) {
-    const layout = await this.send(`VAR B3 A${layer} ${id}`)
+    const [position, status] = await this.send(2, `VAR B3 A${layer} ${id}`);
-    const [position] = layout.split(" ").map(Number)
+    if (status !== "0") throw new Error(`Failed with status ${status}`);
-    return position
+    return Number(position);
+  }
+
+  /**
+   * Permanently stores settings and layout to the device.
+   *
+   * CAUTION: Device may degrade prematurely above 10,000-25,000 commits.
+   *
+   * **This does not need to be called for chords**
+   */
+  async commit() {
+    const [status] = await this.send(1, "VAR B0");
+    if (status !== "0") throw new Error(`Failed with status ${status}`);
+  }
+
+  /**
+   * Sets a setting on the device.
+   *
+   * Settings are applied until the next reboot or loss of power.
+   * To permanently store the settings, you *must* call commit.
+   */
+  async setSetting(id: number, value: number) {
+    const [status] = await this.send(
+      1,
+      `VAR B2 ${id.toString(16).toUpperCase()} ${value}`,
+    );
+    if (status !== "0") throw new Error(`Failed with status ${status}`);
+  }
+
+  /**
+   * Retrieves a setting from the device
+   */
+  async getSetting(id: number): Promise<number> {
+    const [value, status] = await this.send(
+      2,
+      `VAR B1 ${id.toString(16).toUpperCase()}`,
+    );
+    if (status !== "0")
+      throw new Error(
+        `Setting "0x${id.toString(16)}" doesn't exist (Status code ${status})`,
+      );
+    return Number(value);
+  }
+
+  /**
+   * Reboots the device
+   */
+  async reboot() {
+    await this.send(0, "RST");
+  }
+
+  /**
+   * Reboots the device to the bootloader
+   */
+  async bootloader() {
+    await this.send(0, "RST BOOTLOADER");
+  }
+
+  /**
+   * Resets the device
+   */
+  async reset(
+    type: "FACTORY" | "PARAMS" | "KEYMAPS" | "STARTER" | "CLEARCML" | "FUNC",
+  ) {
+    await this.send(0, `RST ${type}`);
+  }
+
+  /**
+   * Returns the current number of bytes available in SRAM.
+   *
+   * This is useful for debugging when there is a suspected heap or stack issue.
+   */
+  async getRamBytesAvailable(): Promise<number> {
+    return Number(await this.send(1, "RAM").then(([bytes]) => bytes));
   }
 }

src/lib/serial/keymap-codes.ts

@@ -1,21 +1,38 @@
-import type {ActionInfo, KeymapCategory} from "$lib/assets/keymaps/keymap"
+import type { ActionInfo, KeymapCategory } from "$lib/assets/keymaps/keymap";
 
 export interface KeyInfo extends Partial<ActionInfo> {
-  code: number
+  code: number;
-  category: KeymapCategory
+  category?: KeymapCategory;
 }
 
-const keymaps = (await Promise.all(
+export const KEYMAP_CATEGORIES = (await Promise.all(
-  Object.values(import.meta.glob("$lib/assets/keymaps/*.yml")).map(async load =>
+  Object.values(import.meta.glob("$lib/assets/keymaps/*.yml")).map(
-    load().then(it => (it as any).default),
+    async (load) => load().then((it) => (it as any).default),
   ),
-)) as KeymapCategory[]
+)) as KeymapCategory[];
 
-export const KEYMAP_CODES: Record<number, KeyInfo> = Object.fromEntries(
+export const KEYMAP_CODES = new Map<number, KeyInfo>(
-  keymaps.flatMap(category =>
+  KEYMAP_CATEGORIES.flatMap((category) =>
     Object.entries(category.actions).map(([code, action]) => [
       Number(code),
-      {...action, code: Number(code), category},
+      { ...action, code: Number(code), category },
     ]),
   ),
-)
+);
+
+export const KEYMAP_KEYCODES = new Map<string, number>(
+  KEYMAP_CATEGORIES.flatMap((category) =>
+    Object.entries(category.actions).map(
+      ([code, action]) => [action.keyCode!, Number(code)] as const,
+    ),
+  ).filter(([keyCode]) => keyCode !== undefined),
+);
+
+export const KEYMAP_IDS = new Map<string, KeyInfo>(
+  KEYMAP_CATEGORIES.flatMap((category) =>
+    Object.entries(category.actions).map(
+      ([code, action]) =>
+        [action.id!, { ...action, code: Number(code), category }] as const,
+    ),
+  ).filter(([id]) => id !== undefined),
+);