Import icons

.eslintrc.cjs

@@ -0,0 +1,20 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    es2024: true,
+  },
+  extends: ["eslint:recommended", "plugin:prettier/recommended"],
+  parserOptions: {
+    ecmaVersion: 2024,
+    sourceType: "module",
+  },
+  rules: {
+    // disabled rules that enforce comment/empty-line requirements per request
+    'padding-line-between-statements': 'off',
+    'no-multiple-empty-lines': 'off',
+    'lines-between-class-members': 'off',
+    'line-comment-position': 'off',
+    'no-inline-comments': 'off'
+  },
+};

.github/actions/node_env_setup/action.yml

@@ -0,0 +1,44 @@
+name: Set up Node.js environment
+description: Install pnpm, configure Node from .nvmrc, enable cache and install dependencies.
+
+inputs:
+  node-version-file:
+    description: Path to .nvmrc-like file
+    required: false
+    default: .nvmrc
+  pnpm-version:
+    description: pnpm version to use
+    required: false
+    default: "10"
+  install-dependencies:
+    description: Whether to run pnpm install --frozen-lockfile
+    required: false
+    default: "true"
+
+runs:
+  using: composite
+  steps:
+    - name: Setup pnpm (via Corepack)
+      shell: bash
+      run: |
+        corepack enable
+        if [ -n "${{ inputs.pnpm-version }}" ]; then
+          corepack prepare pnpm@${{ inputs.pnpm-version }} --activate || corepack prepare pnpm@latest --activate
+        else
+          corepack prepare pnpm@latest --activate
+        fi
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version-file: ${{ inputs.node-version-file }}
+        cache: pnpm
+
+    - name: Enable corepack
+      shell: bash
+      run: corepack enable
+
+    - name: Install dependencies
+      if: ${{ inputs.install-dependencies == 'true' }}
+      shell: bash
+      run: pnpm install --frozen-lockfile

.github/workflows/lint.yml

@@ -0,0 +1,43 @@
+name: Lint
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: lint-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Enable Corepack and prepare pnpm
+        run: corepack enable && corepack prepare pnpm@10 --activate
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Format check
+        run: pnpm run format:check
+
+      - name: Lint HTML
+        run: pnpm run lint:html
+
+      - name: Lint JS
+        run: pnpm run lint:js
+
+      - name: Lint CSS
+        run: pnpm run lint:css

.github/workflows/pages.yml

@@ -0,0 +1,56 @@
+name: Deploy to GitHub Pages
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Enable Corepack and prepare pnpm
+        run: corepack enable && corepack prepare pnpm@10 --activate
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/preview.yml

@@ -0,0 +1,115 @@
+name: Preview
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: preview-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Deploy preview on open / push ─────────────────────────────────────────
+  deploy:
+    if: github.event.action != 'closed'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Enable Corepack and prepare pnpm
+        run: corepack enable && corepack prepare pnpm@10 --activate
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Publish preview to gh-pages
+        env:
+          BRANCH: ${{ github.head_ref }}
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+
+          # stash the build output outside the working tree
+          DIST=$(mktemp -d)
+          cp -r dist/. "$DIST/"
+
+          # switch to gh-pages (create orphan if it doesn't exist yet)
+          git fetch origin gh-pages 2>/dev/null && git checkout gh-pages || \
+            git checkout --orphan gh-pages && git rm -rf . --quiet
+
+          # sync the preview subfolder
+          rm -rf "previews/${BRANCH}"
+          mkdir -p "previews/${BRANCH}"
+          cp -r "$DIST/." "previews/${BRANCH}/"
+
+          # ensure GitHub Pages doesn't skip underscore/dot folders
+          touch .nojekyll
+
+          git add .nojekyll "previews/${BRANCH}"
+          git diff --cached --quiet || \
+            git commit -m "ci(preview): update ${BRANCH}"
+          git push origin gh-pages
+
+      - name: Comment preview URL on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = context.repo.owner;
+            const repo  = context.repo.repo;
+            const branch = '${{ github.head_ref }}';
+            const url = `https://${owner}.github.io/${repo}/previews/${branch}/`;
+            const marker = '<!-- preview-bot -->';
+            const body = `${marker}\n🔍 **Preview:** [${url}](${url})`;
+
+            const comments = await github.rest.issues.listComments({
+              owner, repo, issue_number: context.issue.number,
+            });
+            const existing = comments.data.find(c => c.body.includes(marker));
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner, repo, comment_id: existing.id, body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner, repo, issue_number: context.issue.number, body,
+              });
+            }
+
+  # ── Cleanup preview when PR is closed / merged ────────────────────────────
+  cleanup:
+    if: github.event.action == 'closed'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout gh-pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+
+      - name: Remove preview folder
+        run: |
+          if [ -d "previews/${{ github.head_ref }}" ]; then
+            git config user.name "${{ github.actor }}"
+            git config user.email "${{ github.actor }}@users.noreply.github.com"
+            git rm -rf "previews/${{ github.head_ref }}"
+            git commit -m "ci(preview): remove ${{ github.head_ref }}"
+            git push
+          else
+            echo "No preview to remove for ${{ github.head_ref }}"
+          fi

.github/workflows/update_docs.yml

@@ -1,27 +1,41 @@
 name: Update documentation
+
 on:
   workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: update-docs
+  cancel-in-progress: true
+
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
           ref: main
-      - name: Use Node.js 14.x 🪢
-        uses: actions/setup-node@v1
+
+      - name: Set up Node.js environment
+        uses: ./.github/actions/node_env_setup
         with:
-          node-version: 14.x
+          node-version-file: .nvmrc
+          pnpm-version: "10"
+          install-dependencies: "true"
+
       - name: git config
         run: |
           git config user.name "${GITHUB_ACTOR}"
           git config user.email "${GITHUB_ACTOR}@users.noreply.github.com"
+
       - run: sudo apt-get update && sudo apt-get install -y zip
-      - run: npm ci
+
       - name: Publish on gh-pages
         run: |
           git remote set-url origin https://git:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
-          npm run documentation-deploy-to-gh-pages
+          pnpm run documentation-deploy-to-gh-pages
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,4 +1,3 @@
+node_modules/
+dist/
 .DS_Store
-node_modules
-src/index.html
-dist

.htmlvalidate.json

@@ -0,0 +1,6 @@
+{
+  "extends": ["html-validate:recommended"],
+  "rules": {
+    "void-style": ["error", { "style": "selfclosing" }]
+  }
+}

.husky/pre-commit

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/_/husky.sh"
+#
+#!/usr/bin/env sh
+. "$(dirname "$0")/_/husky.sh"
+
+# Use pnpm to run lint-staged without attempting a global exec install
+# `pnpm -s lint-staged` runs the script silently and works across pnpm versions
+pnpm -s lint-staged