Changed .gitignore to include build outputs

Signed-off-by: Alexander Lyall <alex@adcm.uk>

.gitea/workflows/pre-release.yaml

@@ -0,0 +1,194 @@
+name: Pre-release on non-main branches
+
+on:
+  push:
+    branches-ignore: [ main ]
+  workflow_dispatch:
+
+jobs:
+  prerelease:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout (full history + tags)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Stop if this is the bot changelog commit
+        shell: bash
+        run: |
+          set -e
+          msg="$(git log -1 --pretty=%B)"
+          echo "$msg" | tr -d '\r' | grep -qi "\[skip ci\]" && {
+            echo "Skipping (bot commit with [skip ci])"
+            exit 0
+          } || true
+
+      - name: Install git-cliff
+        shell: bash
+        run: |
+          set -e
+          GIT_CLIFF_VERSION="2.11.0"
+          URL="https://github.com/orhun/git-cliff/releases/download/v${GIT_CLIFF_VERSION}/git-cliff-${GIT_CLIFF_VERSION}-x86_64-unknown-linux-gnu.tar.gz"
+          curl -L "$URL" -o /tmp/git-cliff.tar.gz
+          tar -xzf /tmp/git-cliff.tar.gz -C /tmp
+          sudo install /tmp/git-cliff-*/git-cliff /usr/local/bin/git-cliff
+          git-cliff --version
+
+      - name: Generate CHANGELOG.md (in runner only)
+        shell: bash
+        run: |
+          set -e
+          git-cliff --config cliff.toml --output CHANGELOG.md
+          test -s CHANGELOG.md
+
+      - name: Extract newest changelog section for pre-release body
+        shell: bash
+        run: |
+          set -e
+          awk '
+            /^## / { if (seen) exit; seen=1 }
+            seen { print }
+          ' CHANGELOG.md > RELEASE_NOTES.md
+
+          sed -i 's/[[:space:]]*$//' RELEASE_NOTES.md
+          test -s RELEASE_NOTES.md
+
+      - name: Create export zip (Computing:Box Website.zip)
+        shell: bash
+        run: |
+          set -e
+          if [ ! -d "dist" ]; then
+            echo "❌ dist/ folder not found in repo root"
+            ls -la
+            exit 1
+          fi
+
+          rm -f "Computing:Box Website.zip"
+          (cd dist && zip -r "../Computing:Box Website.zip" .)
+          test -s "Computing:Box Website.zip"
+          ls -lh "Computing:Box Website.zip"
+
+      - name: Prepare pre-release tag + name
+        shell: bash
+        run: |
+          set -e
+
+          # Get branch name from ref: refs/heads/feature/x -> feature/x
+          ref="${GITHUB_REF#refs/heads/}"
+          # Make it tag-safe: lowercase, / -> -, remove invalid chars, collapse repeats
+          safe_branch="$(echo "$ref" | tr '[:upper:]' '[:lower:]' | sed -E 's#[^a-z0-9._-]+#-#g; s#-+#-#g; s#(^-|-$)##g')"
+
+          VERSION="$(date -u +'%y.%m.%d')"
+          SHORT_SHA="$(git rev-parse --short HEAD)"
+
+          # Pre-release tag format:
+          # vYY.MM.DD-pre.<branch>.<sha>
+          TAG="v${VERSION}-pre.${safe_branch}.${SHORT_SHA}"
+
+          # Release name shown in UI
+          RELEASE_NAME="Computing:Box pre-release (${ref}) v${VERSION}"
+
+          echo "TAG=$TAG" >> "$GITHUB_ENV"
+          echo "RELEASE_NAME=$RELEASE_NAME" >> "$GITHUB_ENV"
+          echo "ZIP_PATH=Computing:Box Website.zip" >> "$GITHUB_ENV"
+          echo "BRANCH_NAME=$ref" >> "$GITHUB_ENV"
+
+          echo "Using tag: $TAG"
+          echo "Release name: $RELEASE_NAME"
+
+      - name: Create and push tag (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          git tag -f "$TAG"
+
+          origin_url="$(git remote get-url origin)"
+
+          # Convert SSH origin to HTTPS if needed
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+          git push "$authed_url" "refs/tags/$TAG" --force
+
+      - name: Create Gitea pre-release + upload asset (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          origin_url="$(git remote get-url origin)"
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          base="$(echo "$origin_url" | sed -E 's#(https?://[^/]+)/.*#\1#')"
+          repo_path="$(echo "$origin_url" | sed -E 's#https?://[^/]+/##')"
+          repo_path="$(echo "$repo_path" | sed -E 's/\.git$//')"
+
+          owner="$(echo "$repo_path" | cut -d/ -f1)"
+          repo="$(echo "$repo_path" | cut -d/ -f2-)"
+
+          api="$base/api/v1"
+
+          python3 - <<'PY'
+          import json, os
+          tag = os.environ["TAG"]
+          name = os.environ["RELEASE_NAME"]
+          branch = os.environ.get("BRANCH_NAME", "")
+
+          with open("RELEASE_NOTES.md", "r", encoding="utf-8") as f:
+              body = f.read()
+
+          # Add a small pre-release banner at the top
+          banner = f"⚠️ Pre-release build from branch `{branch}`\n\n"
+          payload = {
+              "tag_name": tag,
+              "target_commitish": branch if branch else "main",
+              "name": name,
+              "body": banner + body,
+              "draft": False,
+              "prerelease": True,
+          }
+
+          with open("release.json", "w", encoding="utf-8") as f:
+              json.dump(payload, f)
+          PY
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            -H "Content-Type: application/json" \
+            "${api}/repos/${owner}/${repo}/releases" \
+            --data-binary @release.json \
+            -o release_response.json
+
+          release_id="$(python3 - <<'PY'
+          import json
+          with open("release_response.json","r",encoding="utf-8") as f:
+              data=json.load(f)
+          rid=data.get("id")
+          if not rid:
+              raise SystemExit("No release id returned. Response:\n" + json.dumps(data, indent=2))
+          print(rid)
+          PY
+          )"
+          echo "Created pre-release id: $release_id"
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            "${api}/repos/${owner}/${repo}/releases/${release_id}/assets?name=Computing%3ABox%20Website.zip" \
+            -F "attachment=@${ZIP_PATH}" \
+            >/dev/null
+
+          echo "✅ Pre-release created: ${RELEASE_NAME} (tag: ${TAG}) with asset uploaded"

.gitea/workflows/release.yaml

@@ -0,0 +1,235 @@
+name: Changelog + Release on main
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  changelog_and_release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout (full history + tags)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Stop if this is the bot changelog commit
+        shell: bash
+        run: |
+          set -e
+          msg="$(git log -1 --pretty=%B)"
+          echo "$msg" | tr -d '\r' | grep -qi "\[skip ci\]" && {
+            echo "Skipping (bot commit with [skip ci])"
+            exit 0
+          } || true
+
+      - name: Install git-cliff
+        shell: bash
+        run: |
+          set -e
+          GIT_CLIFF_VERSION="2.11.0"
+          URL="https://github.com/orhun/git-cliff/releases/download/v${GIT_CLIFF_VERSION}/git-cliff-${GIT_CLIFF_VERSION}-x86_64-unknown-linux-gnu.tar.gz"
+          curl -L "$URL" -o /tmp/git-cliff.tar.gz
+          tar -xzf /tmp/git-cliff.tar.gz -C /tmp
+          sudo install /tmp/git-cliff-*/git-cliff /usr/local/bin/git-cliff
+          git-cliff --version
+
+      - name: Generate CHANGELOG.md (Keep a Changelog)
+        shell: bash
+        run: |
+          set -e
+          git-cliff --config cliff.toml --output CHANGELOG.md
+          test -s CHANGELOG.md
+
+      - name: Commit and push CHANGELOG.md if changed (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          if git diff --quiet -- CHANGELOG.md; then
+            echo "No changelog changes."
+          else
+            git config user.name "changelog-bot"
+            git config user.email "changelog-bot@users.noreply.local"
+
+            git add CHANGELOG.md
+            git commit -m "docs(changelog): update changelog [skip ci]"
+
+            origin_url="$(git remote get-url origin)"
+
+            # Convert SSH origin to HTTPS if needed
+            if echo "$origin_url" | grep -q "^git@"; then
+              host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+              path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+              origin_url="https://$host/$path"
+            fi
+
+            authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+            git push "$authed_url" HEAD:main
+          fi
+
+      - name: Extract newest changelog section for release body
+        shell: bash
+        run: |
+          set -e
+          # Extract the first "## ..." section (newest section) from CHANGELOG.md
+          # Includes the "## ..." heading and everything until the next "## ..." heading.
+          awk '
+            /^## / { if (seen) exit; seen=1 }
+            seen { print }
+          ' CHANGELOG.md > RELEASE_NOTES.md
+
+          # Clean trailing whitespace/newlines a bit
+          sed -i 's/[[:space:]]*$//' RELEASE_NOTES.md
+
+          test -s RELEASE_NOTES.md
+          echo "---- RELEASE_NOTES.md ----"
+          head -n 60 RELEASE_NOTES.md
+          echo "--------------------------"
+
+      - name: Create export zip (Computing:Box Website.zip)
+        shell: bash
+        run: |
+          set -e
+          if [ ! -d "export" ]; then
+            echo "❌ export/ folder not found in repo root"
+            ls -la
+            exit 1
+          fi
+
+          rm -f "Computing:Box Website.zip"
+          (cd export && zip -r "../Computing:Box Website.zip" .)
+          test -s "Computing:Box Website.zip"
+          ls -lh "Computing:Box Website.zip"
+
+      - name: Prepare YY.MM.DD letter-suffix tag + release name
+        shell: bash
+        run: |
+          set -e
+
+          # Version: YY.MM.DD (UTC). Swap to `date +...` if you prefer UK-local runner time.
+          VERSION="$(date -u +'%y.%m.%d')"
+          PREFIX="v${VERSION}."
+
+          last_letter="$(
+            git tag --list "${PREFIX}[a-z]" \
+              | sed -E "s/^${PREFIX}([a-z])$/\1/" \
+              | sort \
+              | tail -n 1
+          )"
+
+          if [ -z "$last_letter" ]; then
+            next_letter="a"
+          else
+            if [ "$last_letter" = "z" ]; then
+              echo "❌ Already have v${VERSION}.z today. Refusing to create more than 26 releases/day."
+              exit 1
+            fi
+            next_letter="$(printf "%b" "$(printf '\\%03o' "$(( $(printf '%d' "'$last_letter") + 1 ))")")"
+          fi
+
+          TAG="${PREFIX}${next_letter}"
+          RELEASE_NAME="Computing:Box v${VERSION}.${next_letter}"
+
+          echo "TAG=$TAG" >> "$GITHUB_ENV"
+          echo "RELEASE_NAME=$RELEASE_NAME" >> "$GITHUB_ENV"
+          echo "ZIP_PATH=Computing:Box Website.zip" >> "$GITHUB_ENV"
+
+          echo "Using tag: $TAG"
+          echo "Release name: $RELEASE_NAME"
+
+      - name: Create and push tag (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          git tag -f "$TAG"
+
+          origin_url="$(git remote get-url origin)"
+
+          # Convert SSH origin to HTTPS if needed
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+          git push "$authed_url" "refs/tags/$TAG" --force
+
+      - name: Create Gitea release + upload asset (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          origin_url="$(git remote get-url origin)"
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          base="$(echo "$origin_url" | sed -E 's#(https?://[^/]+)/.*#\1#')"
+          repo_path="$(echo "$origin_url" | sed -E 's#https?://[^/]+/##')"
+          repo_path="$(echo "$repo_path" | sed -E 's/\.git$//')"
+
+          owner="$(echo "$repo_path" | cut -d/ -f1)"
+          repo="$(echo "$repo_path" | cut -d/ -f2-)"
+
+          api="$base/api/v1"
+
+          python3 - <<'PY'
+          import json, os
+          tag = os.environ["TAG"]
+          name = os.environ["RELEASE_NAME"]
+
+          with open("RELEASE_NOTES.md", "r", encoding="utf-8") as f:
+              body = f.read()
+
+          payload = {
+              "tag_name": tag,
+              "target_commitish": "main",
+              "name": name,
+              "body": body,   # newest section only
+              "draft": False,
+              "prerelease": False,
+          }
+
+          with open("release.json", "w", encoding="utf-8") as f:
+              json.dump(payload, f)
+          PY
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            -H "Content-Type: application/json" \
+            "${api}/repos/${owner}/${repo}/releases" \
+            --data-binary @release.json \
+            -o release_response.json
+
+          release_id="$(python3 - <<'PY'
+          import json
+          with open("release_response.json","r",encoding="utf-8") as f:
+              data=json.load(f)
+          rid=data.get("id")
+          if not rid:
+              raise SystemExit("No release id returned. Response:\n" + json.dumps(data, indent=2))
+          print(rid)
+          PY
+          )"
+          echo "Created release id: $release_id"
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            "${api}/repos/${owner}/${repo}/releases/${release_id}/assets?name=Computing%3ABox%20Website.zip" \
+            -F "attachment=@${ZIP_PATH}" \
+            >/dev/null
+
+          echo "✅ Release created: ${RELEASE_NAME} (tag: ${TAG}) with asset uploaded"

.gitea/workflows/release.yml

@@ -0,0 +1,235 @@
+name: Changelog + Release on main
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  changelog_and_release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout (full history + tags)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Stop if this is the bot changelog commit
+        shell: bash
+        run: |
+          set -e
+          msg="$(git log -1 --pretty=%B)"
+          echo "$msg" | tr -d '\r' | grep -qi "\[skip ci\]" && {
+            echo "Skipping (bot commit with [skip ci])"
+            exit 0
+          } || true
+
+      - name: Install git-cliff
+        shell: bash
+        run: |
+          set -e
+          GIT_CLIFF_VERSION="2.11.0"
+          URL="https://github.com/orhun/git-cliff/releases/download/v${GIT_CLIFF_VERSION}/git-cliff-${GIT_CLIFF_VERSION}-x86_64-unknown-linux-gnu.tar.gz"
+          curl -L "$URL" -o /tmp/git-cliff.tar.gz
+          tar -xzf /tmp/git-cliff.tar.gz -C /tmp
+          sudo install /tmp/git-cliff-*/git-cliff /usr/local/bin/git-cliff
+          git-cliff --version
+
+      - name: Generate CHANGELOG.md (Keep a Changelog)
+        shell: bash
+        run: |
+          set -e
+          git-cliff --config cliff.toml --output CHANGELOG.md
+          test -s CHANGELOG.md
+
+      - name: Commit and push CHANGELOG.md if changed (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          if git diff --quiet -- CHANGELOG.md; then
+            echo "No changelog changes."
+          else
+            git config user.name "changelog-bot"
+            git config user.email "changelog-bot@users.noreply.local"
+
+            git add CHANGELOG.md
+            git commit -m "docs(changelog): update changelog [skip ci]"
+
+            origin_url="$(git remote get-url origin)"
+
+            # Convert SSH origin to HTTPS if needed
+            if echo "$origin_url" | grep -q "^git@"; then
+              host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+              path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+              origin_url="https://$host/$path"
+            fi
+
+            authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+            git push "$authed_url" HEAD:main
+          fi
+
+      - name: Extract newest changelog section for release body
+        shell: bash
+        run: |
+          set -e
+          # Extract the first "## ..." section (newest section) from CHANGELOG.md
+          # Includes the "## ..." heading and everything until the next "## ..." heading.
+          awk '
+            /^## / { if (seen) exit; seen=1 }
+            seen { print }
+          ' CHANGELOG.md > RELEASE_NOTES.md
+
+          # Clean trailing whitespace/newlines a bit
+          sed -i 's/[[:space:]]*$//' RELEASE_NOTES.md
+
+          test -s RELEASE_NOTES.md
+          echo "---- RELEASE_NOTES.md ----"
+          head -n 60 RELEASE_NOTES.md
+          echo "--------------------------"
+
+      - name: Create export zip (Computing:Box Website.zip)
+        shell: bash
+        run: |
+          set -e
+          if [ ! -d "export" ]; then
+            echo "❌ export/ folder not found in repo root"
+            ls -la
+            exit 1
+          fi
+
+          rm -f "Computing:Box Website.zip"
+          (cd export && zip -r "../Computing:Box Website.zip" .)
+          test -s "Computing:Box Website.zip"
+          ls -lh "Computing:Box Website.zip"
+
+      - name: Prepare YY.MM.DD letter-suffix tag + release name
+        shell: bash
+        run: |
+          set -e
+
+          # Version: YY.MM.DD (UTC). Swap to `date +...` if you prefer UK-local runner time.
+          VERSION="$(date -u +'%y.%m.%d')"
+          PREFIX="v${VERSION}."
+
+          last_letter="$(
+            git tag --list "${PREFIX}[a-z]" \
+              | sed -E "s/^${PREFIX}([a-z])$/\1/" \
+              | sort \
+              | tail -n 1
+          )"
+
+          if [ -z "$last_letter" ]; then
+            next_letter="a"
+          else
+            if [ "$last_letter" = "z" ]; then
+              echo "❌ Already have v${VERSION}.z today. Refusing to create more than 26 releases/day."
+              exit 1
+            fi
+            next_letter="$(printf "%b" "$(printf '\\%03o' "$(( $(printf '%d' "'$last_letter") + 1 ))")")"
+          fi
+
+          TAG="${PREFIX}${next_letter}"
+          RELEASE_NAME="Computing:Box v${VERSION}.${next_letter}"
+
+          echo "TAG=$TAG" >> "$GITHUB_ENV"
+          echo "RELEASE_NAME=$RELEASE_NAME" >> "$GITHUB_ENV"
+          echo "ZIP_PATH=Computing:Box Website.zip" >> "$GITHUB_ENV"
+
+          echo "Using tag: $TAG"
+          echo "Release name: $RELEASE_NAME"
+
+      - name: Create and push tag (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          git tag -f "$TAG"
+
+          origin_url="$(git remote get-url origin)"
+
+          # Convert SSH origin to HTTPS if needed
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+          git push "$authed_url" "refs/tags/$TAG" --force
+
+      - name: Create Gitea release + upload asset (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          origin_url="$(git remote get-url origin)"
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          base="$(echo "$origin_url" | sed -E 's#(https?://[^/]+)/.*#\1#')"
+          repo_path="$(echo "$origin_url" | sed -E 's#https?://[^/]+/##')"
+          repo_path="$(echo "$repo_path" | sed -E 's/\.git$//')"
+
+          owner="$(echo "$repo_path" | cut -d/ -f1)"
+          repo="$(echo "$repo_path" | cut -d/ -f2-)"
+
+          api="$base/api/v1"
+
+          python3 - <<'PY'
+          import json, os
+          tag = os.environ["TAG"]
+          name = os.environ["RELEASE_NAME"]
+
+          with open("RELEASE_NOTES.md", "r", encoding="utf-8") as f:
+              body = f.read()
+
+          payload = {
+              "tag_name": tag,
+              "target_commitish": "main",
+              "name": name,
+              "body": body,   # newest section only
+              "draft": False,
+              "prerelease": False,
+          }
+
+          with open("release.json", "w", encoding="utf-8") as f:
+              json.dump(payload, f)
+          PY
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            -H "Content-Type: application/json" \
+            "${api}/repos/${owner}/${repo}/releases" \
+            --data-binary @release.json \
+            -o release_response.json
+
+          release_id="$(python3 - <<'PY'
+          import json
+          with open("release_response.json","r",encoding="utf-8") as f:
+              data=json.load(f)
+          rid=data.get("id")
+          if not rid:
+              raise SystemExit("No release id returned. Response:\n" + json.dumps(data, indent=2))
+          print(rid)
+          PY
+          )"
+          echo "Created release id: $release_id"
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
+            "${api}/repos/${owner}/${repo}/releases/${release_id}/assets?name=Computing%3ABox%20Website.zip" \
+            -F "attachment=@${ZIP_PATH}" \
+            >/dev/null
+
+          echo "✅ Release created: ${RELEASE_NAME} (tag: ${TAG}) with asset uploaded"

.gitignore

@@ -1,5 +1,5 @@
 # build output
-dist/
+# dist/
 
 # generated types
 .astro/

LICENSE

@@ -1,121 +1,437 @@
-Creative Commons Legal Code
+Attribution-NonCommercial-ShareAlike 4.0 International
 
-CC0 1.0 Universal
+=======================================================================
 
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+Creative Commons Corporation ("Creative Commons") is not a law firm and
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+does not provide legal services or legal advice. Distribution of
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+Creative Commons public licenses does not create a lawyer-client or
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+other relationship. Creative Commons makes its licenses and related
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+information available on an "as-is" basis. Creative Commons gives no
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+warranties regarding its licenses, any material licensed under their
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+terms and conditions, or any related information. Creative Commons
-    HEREUNDER.
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
 
-Statement of Purpose
+Using Creative Commons Public Licenses
 
-The laws of most jurisdictions throughout the world automatically confer
+Creative Commons public licenses provide a standard set of terms and
-exclusive Copyright and Related Rights (defined below) upon the creator
+conditions that creators and other rights holders may use to share
-and subsequent owner(s) (each and all, an "owner") of an original work of
+original works of authorship and other material subject to copyright
-authorship and/or a database (each, a "Work").
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
 
-Certain owners wish to permanently relinquish those rights to a Work for
+     Considerations for licensors: Our public licenses are
-the purpose of contributing to a commons of creative, cultural and
+     intended for use by those authorized to give the public
-scientific works ("Commons") that the public can reliably and without fear
+     permission to use material in ways otherwise restricted by
-of later claims of infringement build upon, modify, incorporate in other
+     copyright and certain other rights. Our licenses are
-works, reuse and redistribute as freely as possible in any form whatsoever
+     irrevocable. Licensors should read and understand the terms
-and for any purposes, including without limitation commercial purposes.
+     and conditions of the license they choose before applying it.
-These owners may contribute to the Commons to promote the ideal of a free
+     Licensors should also secure all rights necessary before
-culture and the further production of creative, cultural and scientific
+     applying our licenses so that the public can reuse the
-works, or to gain reputation or greater distribution for their Work in
+     material as expected. Licensors should clearly mark any
-part through the use and efforts of others.
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
 
-For these and/or other purposes and motivations, and without any
+     Considerations for the public: By using one of our public
-expectation of additional consideration or compensation, the person
+     licenses, a licensor grants the public permission to use the
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+     licensed material under specified terms and conditions. If
-is an owner of Copyright and Related Rights in the Work, voluntarily
+     the licensor's permission is not necessary for any reason--for
-elects to apply CC0 to the Work and publicly distribute the Work under its
+     example, because of any applicable exception or limitation to
-terms, with knowledge of his or her Copyright and Related Rights in the
+     copyright--then that use is not regulated by the license. Our
-Work and the meaning and intended legal effect of CC0 on those rights.
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
 
-1. Copyright and Related Rights. A Work made available under CC0 may be
+=======================================================================
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
 
-  i. the right to reproduce, adapt, distribute, perform, display,
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
-     communicate, and translate a Work;
+Public License
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
 
-2. Waiver. To the greatest extent permitted by, but not in contravention
+By exercising the Licensed Rights (defined below), You accept and agree
-of, applicable law, Affirmer hereby overtly, fully, permanently,
+to be bound by the terms and conditions of this Creative Commons
-irrevocably and unconditionally waives, abandons, and surrenders all of
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
-Affirmer's Copyright and Related Rights and associated claims and causes
+("Public License"). To the extent this Public License may be
-of action, whether now known or unknown (including existing as well as
+interpreted as a contract, You are granted the Licensed Rights in
-future claims and causes of action), in the Work (i) in all territories
+consideration of Your acceptance of these terms and conditions, and the
-worldwide, (ii) for the maximum duration provided by applicable law or
+Licensor grants You such rights in consideration of benefits the
-treaty (including future time extensions), (iii) in any current or future
+Licensor receives from making the Licensed Material available under
-medium and for any number of copies, and (iv) for any purpose whatsoever,
+these terms and conditions.
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
 
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
 
-4. Limitations and Disclaimers.
+Section 1 -- Definitions.
 
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  a. Adapted Material means material subject to Copyright and Similar
-    surrendered, licensed or otherwise affected by this document.
+     Rights that is derived from or based upon the Licensed Material
- b. Affirmer offers the Work as-is and makes no representations or
+     and in which the Licensed Material is translated, altered,
-    warranties of any kind concerning the Work, express, implied,
+     arranged, transformed, or otherwise modified in a manner requiring
-    statutory or otherwise, including without limitation warranties of
+     permission under the Copyright and Similar Rights held by the
-    title, merchantability, fitness for a particular purpose, non
+     Licensor. For purposes of this Public License, where the Licensed
-    infringement, or the absence of latent or other defects, accuracy, or
+     Material is a musical work, performance, or sound recording,
-    the present or absence of errors, whether or not discoverable, all to
+     Adapted Material is always produced where the Licensed Material is
-    the greatest extent permissible under applicable law.
+     synched in timed relation with a moving image.
- c. Affirmer disclaims responsibility for clearing rights of other persons
+
-    that may apply to the Work or any use thereof, including without
+  b. Adapter's License means the license You apply to Your Copyright
-    limitation any person's Copyright and Related Rights in the Work.
+     and Similar Rights in Your contributions to Adapted Material in
-    Further, Affirmer disclaims responsibility for obtaining any necessary
+     accordance with the terms and conditions of this Public License.
-    consents, permissions or other rights required for any use of the
+
-    Work.
+  c. BY-NC-SA Compatible License means a license listed at
- d. Affirmer understands and acknowledges that Creative Commons is not a
+     creativecommons.org/compatiblelicenses, approved by Creative
-    party to this document and has no duty or obligation with respect to
+     Commons as essentially the equivalent of this Public License.
-    this CC0 or use of the Work.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  e. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution, NonCommercial, and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  i. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  j. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  k. NonCommercial means not primarily intended for or directed towards
+     commercial advantage or monetary compensation. For purposes of
+     this Public License, the exchange of the Licensed Material for
+     other material subject to Copyright and Similar Rights by digital
+     file-sharing or similar means is NonCommercial provided there is
+     no payment of monetary compensation in connection with the
+     exchange.
+
+  l. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  m. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  n. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part, for NonCommercial purposes only; and
+
+            b. produce, reproduce, and Share Adapted Material for
+               NonCommercial purposes only.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties, including when
+          the Licensed Material is used other than for NonCommercial
+          purposes.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-NC-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database for NonCommercial purposes
+     only;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material,
+     including for purposes of Section 3(b); and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.

README.md

@@ -1,7 +1,13 @@
 # Computing:Box
 An evolution of Bit:Box & CS:Box to incorporate different elements of the UK Computing Curriculum
 
-![Computing:Box Logo](/assets/img/ComputingBox-Logo.png "Computing:Box Logo")
+### Available at:
+- [Personal Gitea Instance](https://git.adcmnetworks.co.uk/alexander.lyall/computing-box),
+- [GitHub](https://github.com/MrLyallCSIT/Computing-Box)
+- [The Official Computing:Box Website](https://www.computingbox.co.uk)
+
+
+<img src="/assets/img/ComputingBox-Logo.png" alt="Computing:Box Logo" width="250px" height="250px"/>
 
 ## Upcoming Features
 ### Original Bit:Box Features (October 2024)
@@ -30,4 +36,15 @@ An evolution of Bit:Box & CS:Box to incorporate different elements of the UK Com
 - [ ] Computer Components Simulator
 
 ## Version 1.0 Release Date: 1<sup>st</sup> September 2025
-## Version 2.0 Release Date (Goal): 1<sup>st</sup> February 2025
+## Version 2.0 Release Date (Goal): 1<sup>st</sup> April 2026
+
+Shield: [![CC BY-NC-SA 4.0][cc-by-nc-sa-shield]][cc-by-nc-sa]
+
+This work is licensed under a
+[Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa].
+
+[![CC BY-NC-SA 4.0][cc-by-nc-sa-image]][cc-by-nc-sa]
+
+[cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/
+[cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png
+[cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg

dist/_astro/astro.CXuftnGC.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" width="115" height="48"><path fill="#17191E" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="url(#a)" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="#17191E" d="M.02 30.31s4.02-1.95 8.05-1.95l3.04-9.4c.11-.45.44-.76.82-.76.37 0 .7.31.82.76l3.04 9.4c4.77 0 8.05 1.95 8.05 1.95L17 11.71c-.2-.56-.53-.91-.98-.91H7.83c-.44 0-.76.35-.97.9L.02 30.31Zm42.37-5.97c0 1.64-2.05 2.62-4.88 2.62-1.85 0-2.5-.45-2.5-1.41 0-1 .8-1.49 2.65-1.49 1.67 0 3.09.03 4.73.23v.05Zm.03-2.04a21.37 21.37 0 0 0-4.37-.36c-5.32 0-7.82 1.25-7.82 4.18 0 3.04 1.71 4.2 5.68 4.2 3.35 0 5.63-.84 6.46-2.92h.14c-.03.5-.05 1-.05 1.4 0 1.07.18 1.16 1.06 1.16h4.15a16.9 16.9 0 0 1-.36-4c0-1.67.06-2.93.06-4.62 0-3.45-2.07-5.64-8.56-5.64-2.8 0-5.9.48-8.26 1.19.22.93.54 2.83.7 4.06 2.04-.96 4.95-1.37 7.2-1.37 3.11 0 3.97.71 3.97 2.15v.57Zm11.37 3c-.56.07-1.33.07-2.12.07-.83 0-1.6-.03-2.12-.1l-.02.58c0 2.85 1.87 4.52 8.45 4.52 6.2 0 8.2-1.64 8.2-4.55 0-2.74-1.33-4.09-7.2-4.39-4.58-.2-4.99-.7-4.99-1.28 0-.66.59-1 3.65-1 3.18 0 4.03.43 4.03 1.35v.2a46.13 46.13 0 0 1 4.24.03l.02-.55c0-3.36-2.8-4.46-8.2-4.46-6.08 0-8.13 1.49-8.13 4.39 0 2.6 1.64 4.23 7.48 4.48 4.3.14 4.77.62 4.77 1.28 0 .7-.7 1.03-3.71 1.03-3.47 0-4.35-.48-4.35-1.47v-.13Zm19.82-12.05a17.5 17.5 0 0 1-6.24 3.48c.03.84.03 2.4.03 3.24l1.5.02c-.02 1.63-.04 3.6-.04 4.9 0 3.04 1.6 5.32 6.58 5.32 2.1 0 3.5-.23 5.23-.6a43.77 43.77 0 0 1-.46-4.13c-1.03.34-2.34.53-3.78.53-2 0-2.82-.55-2.82-2.13 0-1.37 0-2.65.03-3.84 2.57.02 5.13.07 6.64.11-.02-1.18.03-2.9.1-4.04-2.2.04-4.65.07-6.68.07l.07-2.93h-.16Zm13.46 6.04a767.33 767.33 0 0 1 .07-3.18H82.6c.07 1.96.07 3.98.07 6.92 0 2.95-.03 4.99-.07 6.93h5.18c-.09-1.37-.11-3.68-.11-5.65 0-3.1 1.26-4 4.12-4 1.33 0 2.28.16 3.1.46.03-1.16.26-3.43.4-4.43-.86-.25-1.81-.41-2.96-.41-2.46-.03-4.26.98-5.1 3.38l-.17-.02Zm22.55 3.65c0 2.5-1.8 3.66-4.64 3.66-2.81 0-4.61-1.1-4.61-3.66s1.82-3.52 4.61-3.52c2.82 0 4.64 1.03 4.64 3.52Zm4.71-.11c0-4.96-3.87-7.18-9.35-7.18-5.5 0-9.23 2.22-9.23 7.18 0 4.94 3.49 7.59 9.21 7.59 5.77 0 9.37-2.65 9.37-7.6Z"/><defs><linearGradient id="a" x1="6.33" x2="19.43" y1="40.8" y2="34.6" gradientUnits="userSpaceOnUse"><stop stop-color="#D83333"/><stop offset="1" stop-color="#F041FF"/></linearGradient></defs></svg>

dist/_astro/background.Mahwsfbs.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1440" height="1024" fill="none"><path fill="url(#a)" fill-rule="evenodd" d="M-217.58 475.75c91.82-72.02 225.52-29.38 341.2-44.74C240 415.56 372.33 315.14 466.77 384.9c102.9 76.02 44.74 246.76 90.31 366.31 29.83 78.24 90.48 136.14 129.48 210.23 57.92 109.99 169.67 208.23 155.9 331.77-13.52 121.26-103.42 264.33-224.23 281.37-141.96 20.03-232.72-220.96-374.06-196.99-151.7 25.73-172.68 330.24-325.85 315.72-128.6-12.2-110.9-230.73-128.15-358.76-12.16-90.14 65.87-176.25 44.1-264.57-26.42-107.2-167.12-163.46-176.72-273.45-10.15-116.29 33.01-248.75 124.87-320.79Z" clip-rule="evenodd" style="opacity:.154"/><path fill="url(#b)" fill-rule="evenodd" d="M1103.43 115.43c146.42-19.45 275.33-155.84 413.5-103.59 188.09 71.13 409 212.64 407.06 413.88-1.94 201.25-259.28 278.6-414.96 405.96-130 106.35-240.24 294.39-405.6 265.3-163.7-28.8-161.93-274.12-284.34-386.66-134.95-124.06-436-101.46-445.82-284.6-9.68-180.38 247.41-246.3 413.54-316.9 101.01-42.93 207.83 21.06 316.62 6.61Z" clip-rule="evenodd" style="opacity:.154"/><defs><linearGradient id="b" x1="373" x2="1995.44" y1="1100" y2="118.03" gradientUnits="userSpaceOnUse"><stop stop-color="#D83333"/><stop offset="1" stop-color="#F041FF"/></linearGradient><linearGradient id="a" x1="107.37" x2="1130.66" y1="1993.35" y2="1026.31" gradientUnits="userSpaceOnUse"><stop stop-color="#3245FF"/><stop offset="1" stop-color="#BC52EE"/></linearGradient></defs></svg>

dist/binary/index.html

@@ -0,0 +1,7 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-37fxchfa> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Binary Simulator</title><style>:root{--nav-h: 108px;--bg: #1f2027;--text: #e8e8ee;--muted: #a9acb8;--line: rgba(255,255,255,.1)}body{margin:0;background:var(--bg);color:var(--text)}.siteNav[data-astro-cid-37fxchfa]{position:sticky;top:0;z-index:50;height:var(--nav-h);background:#0000001a;border-bottom:1px solid var(--line);backdrop-filter:blur(8px)}.navInner[data-astro-cid-37fxchfa]{height:100%;max-width:1400px;margin:0 auto;padding:0 20px;display:flex;align-items:center;justify-content:space-between;gap:24px}.brand[data-astro-cid-37fxchfa]{display:flex;align-items:center;gap:12px;text-decoration:none;color:var(--text)}.brandLogo[data-astro-cid-37fxchfa]{width:2em;height:2em;image-rendering:pixelated}.brandName[data-astro-cid-37fxchfa]{letter-spacing:.12em;font-weight:900;text-transform:uppercase;font-size:18px}.navLinks[data-astro-cid-37fxchfa]{display:flex;align-items:center;gap:18px;flex-wrap:wrap}.navLinks[data-astro-cid-37fxchfa] a[data-astro-cid-37fxchfa]{color:var(--muted);text-decoration:none;font-weight:800;letter-spacing:.12em;font-size:16px;text-transform:uppercase}.navLinks[data-astro-cid-37fxchfa] a[data-astro-cid-37fxchfa]:hover{color:var(--text)}.pageWrap[data-astro-cid-37fxchfa]{max-width:1400px;margin:0 auto}
+:root{--panel-w: 360px;--gap: 22px}.wrap{max-width:1400px;margin:0 auto;padding:26px 20px 48px;position:relative}.topGrid{display:grid;grid-template-columns:1fr var(--panel-w);gap:var(--gap);align-items:start}body.toolboxClosed .topGrid{grid-template-columns:1fr}body.toolboxClosed #toolboxPanel{display:none}.mainCol{min-width:0}.readout{text-align:center;margin-top:8px}.label{opacity:.8;letter-spacing:.12em;text-transform:uppercase;font-size:12px}.num{display:inline-block;width:fit-content;max-width:100%;white-space:pre-line;letter-spacing:2px}.denaryValue{font-size:54px;margin:6px 0 10px}.binaryValue{font-size:56px;margin:4px 0 18px}.divider{height:1px;background:#ffffff1a;margin:14px auto 24px;max-width:900px}.bitsWrap{padding-top:6px}.bitsGrid{display:grid;gap:24px;justify-content:center}.bitsGrid{grid-template-columns:repeat(auto-fit,minmax(110px,1fr));max-width:1200px;margin:0 auto}.bitsGrid.bitsFew{justify-content:center}.bit{display:grid;justify-items:center;gap:8px}.bulb{font-size:32px;line-height:1;opacity:.45}.bitVal{font-size:22px;line-height:1.05;text-align:center;white-space:nowrap}.switch{position:relative;display:inline-block;width:52px;height:28px}.switch input{display:none}.slider{position:absolute;inset:0;border-radius:999px;background:#ffffff2e;border:1px solid rgba(255,255,255,.14)}.slider:before{content:"";position:absolute;height:22px;width:22px;left:3px;top:2.5px;border-radius:999px;background:#fff;transition:transform .18s ease}.switch input:checked+.slider:before{transform:translate(22px)}.toolboxToggle{position:absolute;right:20px;top:18px;z-index:20;display:inline-flex;align-items:center;gap:10px;padding:10px 14px;border-radius:12px;border:1px solid rgba(255,255,255,.14);background:#ffffff0f;color:#ffffffeb;cursor:pointer}.toolboxText{letter-spacing:.12em;font-weight:900}.panelCol{position:sticky;top:calc(var(--nav-h, 72px) + 18px);align-self:start;display:grid;gap:16px}.card{border:1px solid rgba(255,255,255,.12);border-radius:16px;background:#ffffff0d;padding:14px}.cardTitle{opacity:.8;letter-spacing:.14em;text-transform:uppercase;font-size:12px;margin-bottom:10px}.hint{opacity:.7;font-size:11px;margin-top:10px;line-height:1.35}.toggleRow{display:grid;grid-template-columns:1fr auto 1fr;gap:10px;align-items:center}.toggleLabel{font-size:12px;font-weight:800;letter-spacing:.12em;text-transform:uppercase;white-space:nowrap}.subCard{margin-top:12px;border:1px solid rgba(255,255,255,.1);border-radius:14px;background:#0000001f;padding:12px}.subTitle{opacity:.8;letter-spacing:.14em;text-transform:uppercase;font-size:11px;margin-bottom:10px}.bitWidthRow{display:grid;grid-template-columns:44px 1fr 44px;gap:10px;align-items:center}.bitInputWrap{display:grid;grid-template-columns:auto 1fr;gap:10px;align-items:center;padding:10px 12px;border:1px solid rgba(255,255,255,.1);border-radius:12px;background:#ffffff0a}.bitInputLabel{opacity:.75;letter-spacing:.14em;text-transform:uppercase;font-size:11px;white-space:nowrap}.bitInput{width:100%;min-width:0;background:transparent;border:none;outline:none;color:inherit;font-size:20px;text-align:right}.miniBtn{height:44px;border-radius:12px;border:1px solid rgba(255,255,255,.12);background:#ffffff0f;color:#ffffffe6;font-size:18px;cursor:pointer}.controlsRow{display:grid;grid-template-columns:1fr 1fr;gap:10px;margin-bottom:10px}.btn{border-radius:12px;border:1px solid rgba(255,255,255,.12);background:#ffffff0f;color:#ffffffeb;padding:12px;font-weight:800;letter-spacing:.1em;text-transform:uppercase;cursor:pointer}.btnWide{width:100%}.btnAccent{background:#00ff8c1f;border-color:#00ff8c38}.toolRowCentered{display:flex;justify-content:center;gap:12px;margin:10px 0 12px}.toolBtn{width:56px;height:56px;border-radius:14px;border:1px solid rgba(255,255,255,.12);background:#ffffff0f;color:#ffffffeb;font-size:18px;cursor:pointer}.toolDec{background:#ff000024;border-color:#f003}.toolInc{background:#00ff8c24;border-color:#00ff8c33}.toolRow2{display:grid;grid-template-columns:1fr 1fr;gap:10px;margin-bottom:12px}.btnReset{color:#ffffffeb}
+</style></head> <body data-astro-cid-37fxchfa> <header class="siteNav" data-astro-cid-37fxchfa> <div class="navInner" data-astro-cid-37fxchfa> <a class="brand" href="/" data-astro-cid-37fxchfa> <img class="brandLogo" src="/images/computing-box-logo.svg" alt="Computing:Box logo" data-astro-cid-37fxchfa> <span class="brandName" data-astro-cid-37fxchfa>COMPUTING:BOX</span> </a> <nav class="navLinks" aria-label="Site navigation" data-astro-cid-37fxchfa> <a href="/about" data-astro-cid-37fxchfa>ABOUT</a> <a href="/binary" data-astro-cid-37fxchfa>BINARY</a> <a href="/hexadecimal" data-astro-cid-37fxchfa>HEXADECIMAL</a> <a href="/hex-colours" data-astro-cid-37fxchfa>HEX COLOURS</a> <a href="/logic-gates" data-astro-cid-37fxchfa>LOGIC GATES</a> </nav> </div> </header> <main class="pageWrap" data-astro-cid-37fxchfa>  <button id="toolboxToggle" class="toolboxToggle" type="button" aria-expanded="true"> <span class="toolboxIcon" aria-hidden="true">🧰</span> <span class="toolboxLabel">TOOLBOX</span> </button> <main class="wrap"> <section class="topGrid"> <!-- LEFT --> <div> <div class="readout"> <div class="label">Denary</div> <div id="denaryNumber" class="num denaryValue">0</div> <div class="label">Binary</div> <div id="binaryNumber" class="num binaryValue">0000 0000</div> </div> <div class="divider"></div> <section class="bitsWrap" aria-label="Bit switches"> <div class="bitsGrid" id="bitsGrid"></div> </section> </div> <!-- RIGHT TOOLBOX --> <aside id="toolbox" class="panelCol" aria-label="Toolbox"> <!-- SETTINGS --> <div class="card"> <div class="cardTitle">Settings</div> <div class="toggleRow"> <div class="toggleLabel" id="lblUnsigned">Unsigned</div> <label class="switch" aria-label="Toggle mode"> <input id="modeToggle" type="checkbox"> <span class="slider"></span> </label> <div class="toggleLabel" id="lblTwos">Two&rsquo;s complement</div> </div> <div class="hint" id="modeHint">
+Tip: In unsigned binary, all bits represent positive values.
+</div> <div class="subCard"> <div class="subTitle">Bit width</div> <div class="bitWidthRow"> <button class="miniBtn" id="btnBitsDown" type="button" aria-label="Decrease bits">−</button> <div class="bitInputWrap"> <div class="bitInputLabel">Bits</div> <input id="bitsInput" class="bitInput" type="number" inputmode="numeric" min="1" max="64" step="1" value="8" aria-label="Number of bits"> </div> <button class="miniBtn" id="btnBitsUp" type="button" aria-label="Increase bits">+</button> </div> </div> </div> <!-- CUSTOM --> <div class="card"> <div class="cardTitle">Custom</div> <div class="twoBtnRow"> <button class="btn btnAccent" id="btnCustomBinary" type="button">Custom Binary</button> <button class="btn btnAccent" id="btnCustomDenary" type="button">Custom Denary</button> </div> <button class="toolBtn toolWide toolRandom" id="btnRandom" type="button">
+Random
+</button> <div class="hint">Random runs briefly then stops automatically.</div> </div> <!-- TOOLS --> <div class="card"> <div class="cardTitle">Tools</div> <div class="toolsTopRow"> <button class="toolBtn toolArrow toolDown" id="btnDec" type="button" aria-label="Decrement">▼</button> <button class="toolBtn toolArrow toolUp" id="btnInc" type="button" aria-label="Increment">▲</button> </div> <div class="twoBtnRow"> <button class="btn" id="btnShiftLeft" type="button">Left Shift</button> <button class="btn" id="btnShiftRight" type="button">Right Shift</button> </div> <button class="toolBtn toolWide toolReset" id="btnClear" type="button">Reset</button> </div> </aside> </section> </main> <script type="module" src="/src/scripts/binary.js"></script>  </main> </body></html>

dist/hexadecimal/index.html

@@ -0,0 +1,5 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-37fxchfa> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Hexadecimal | Computing:Box</title><style>:root{--nav-h: 108px;--bg: #1f2027;--text: #e8e8ee;--muted: #a9acb8;--line: rgba(255,255,255,.1)}body{margin:0;background:var(--bg);color:var(--text)}.siteNav[data-astro-cid-37fxchfa]{position:sticky;top:0;z-index:50;height:var(--nav-h);background:#0000001a;border-bottom:1px solid var(--line);backdrop-filter:blur(8px)}.navInner[data-astro-cid-37fxchfa]{height:100%;max-width:1400px;margin:0 auto;padding:0 20px;display:flex;align-items:center;justify-content:space-between;gap:24px}.brand[data-astro-cid-37fxchfa]{display:flex;align-items:center;gap:12px;text-decoration:none;color:var(--text)}.brandLogo[data-astro-cid-37fxchfa]{width:2em;height:2em;image-rendering:pixelated}.brandName[data-astro-cid-37fxchfa]{letter-spacing:.12em;font-weight:900;text-transform:uppercase;font-size:18px}.navLinks[data-astro-cid-37fxchfa]{display:flex;align-items:center;gap:18px;flex-wrap:wrap}.navLinks[data-astro-cid-37fxchfa] a[data-astro-cid-37fxchfa]{color:var(--muted);text-decoration:none;font-weight:800;letter-spacing:.12em;font-size:16px;text-transform:uppercase}.navLinks[data-astro-cid-37fxchfa] a[data-astro-cid-37fxchfa]:hover{color:var(--text)}.pageWrap[data-astro-cid-37fxchfa]{max-width:1400px;margin:0 auto}
+</style>
+<link rel="stylesheet" href="/_astro/hexadecimal.C_Opoo6d.css"></head> <body data-astro-cid-37fxchfa> <header class="siteNav" data-astro-cid-37fxchfa> <div class="navInner" data-astro-cid-37fxchfa> <a class="brand" href="/" data-astro-cid-37fxchfa> <img class="brandLogo" src="/images/computing-box-logo.svg" alt="Computing:Box logo" data-astro-cid-37fxchfa> <span class="brandName" data-astro-cid-37fxchfa>COMPUTING:BOX</span> </a> <nav class="navLinks" aria-label="Site navigation" data-astro-cid-37fxchfa> <a href="/about" data-astro-cid-37fxchfa>ABOUT</a> <a href="/binary" data-astro-cid-37fxchfa>BINARY</a> <a href="/hexadecimal" data-astro-cid-37fxchfa>HEXADECIMAL</a> <a href="/hex-colours" data-astro-cid-37fxchfa>HEX COLOURS</a> <a href="/logic-gates" data-astro-cid-37fxchfa>LOGIC GATES</a> </nav> </div> </header> <main class="pageWrap" data-astro-cid-37fxchfa>  <section class="hex-sim" data-hex-sim> <div class="hex-main"> <div class="hex-readout"> <div class="hex-label">DENARY</div> <div class="hex-number" data-out="denary">0</div> <div class="hex-label hex-mt">HEXADECIMAL</div> <div class="hex-number hex-number--small" data-out="hex">00</div> <div class="hex-label hex-mt">BINARY</div> <div class="hex-number hex-number--tiny" data-out="bin">0000 0000</div> </div> <div class="hex-divider"></div> <div class="hex-digits" data-out="digitsRow"></div> </div> <!-- Toolbox button --> <button class="hex-toolbox-btn" type="button" data-action="toggleToolbox" aria-controls="hex-toolbox" aria-expanded="true"> <span class="hex-toolbox-icon" aria-hidden="true"> <!-- toolbox icon --> <svg viewBox="0 0 24 24" width="18" height="18" fill="none"> <path d="M9 7V6a3 3 0 0 1 6 0v1" stroke="currentColor" stroke-width="2" stroke-linecap="round"></path> <path d="M4 9h16l-1.3 10.4A2 2 0 0 1 16.7 21H7.3a2 2 0 0 1-1.98-1.6L4 9Z" stroke="currentColor" stroke-width="2" stroke-linejoin="round"></path> <path d="M10 13h4" stroke="currentColor" stroke-width="2" stroke-linecap="round"></path> </svg> </span>
+TOOLBOX
+</button> <!-- Toolbox panel --> <aside class="hex-toolbox is-open" id="hex-toolbox" data-out="toolbox"> <div class="hex-panel"> <div class="hex-panel-title">SETTINGS</div> <div class="hex-setting-title">HEX DIGIT WIDTH</div> <div class="hex-width"> <button class="hex-btn hex-btn--square" type="button" data-action="digitsMinus">−</button> <div class="hex-width-readout"> <div class="hex-width-label">DIGITS</div> <div class="hex-width-number" data-out="digitsCount">2</div> </div> <button class="hex-btn hex-btn--square" type="button" data-action="digitsPlus">+</button> </div> <div class="hex-hint" data-out="bitsHint">= 8 bits</div> </div> <div class="hex-panel"> <div class="hex-panel-title">CUSTOM NUMBER</div> <div class="hex-grid-2"> <button class="hex-btn hex-btn--green" type="button" data-action="customHex">Custom Hexadecimal</button> <button class="hex-btn hex-btn--green" type="button" data-action="customDenary">Custom Denary</button> </div> <!-- Custom Binary + Random on SAME row, same size --> <div class="hex-grid-2 hex-mt-sm"> <button class="hex-btn hex-btn--green" type="button" data-action="customBinary">Custom Binary</button> <button class="hex-btn hex-btn--wide hex-btn--random" type="button" data-action="random" data-random>Random</button> </div> <div class="hex-tiny-note">RANDOM RUNS BRIEFLY THEN STOPS AUTOMATICALLY.</div> </div> <div class="hex-panel"> <div class="hex-panel-title">TOOLS</div> <div class="hex-tools-top"> <button class="hex-btn hex-btn--square hex-btn--red" type="button" data-action="decrement" title="Decrement">▼</button> <button class="hex-btn hex-btn--square hex-btn--green2" type="button" data-action="increment" title="Increment">▲</button> </div> <button class="hex-btn hex-btn--wide hex-btn--reset" type="button" data-action="reset">Reset</button> </div> </aside> <!-- Custom number dialog --> <dialog class="hex-dialog" data-out="dialog"> <div class="hex-dialog-card"> <div class="hex-dialog-title" data-out="dialogTitle">Custom</div> <input class="hex-dialog-input hex-font-mono" data-out="dialogInput"> <div class="hex-dialog-hint" data-out="dialogHint"></div> <div class="hex-dialog-error" data-out="dialogError" aria-live="polite"></div> <div class="hex-dialog-actions"> <button class="hex-btn" type="button" data-action="dialogCancel">Cancel</button> <button class="hex-btn hex-btn--green" type="button" data-action="dialogApply">Apply</button> </div> </div> </dialog> <script type="module" src="/src/components/simulators/hex/hex-simulator.ts"></script> </section>  </main> </body></html>

dist/index.html

@@ -0,0 +1,7 @@
+<!DOCTYPE html><html lang="en" data-astro-cid-sckkx6r4> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width"><link rel="icon" type="image/svg+xml" href="/favicon.svg"><meta name="generator" content="Astro v5.16.6"><title>Astro Basics</title><style>#background[data-astro-cid-mmc7otgs]{position:fixed;top:0;left:0;width:100%;height:100%;z-index:-1;filter:blur(100px)}#container[data-astro-cid-mmc7otgs]{font-family:Inter,Roboto,Helvetica Neue,Arial Nova,Nimbus Sans,Arial,sans-serif;height:100%}main[data-astro-cid-mmc7otgs]{height:100%;display:flex;justify-content:center}#hero[data-astro-cid-mmc7otgs]{display:flex;align-items:start;flex-direction:column;justify-content:center;padding:16px}h1[data-astro-cid-mmc7otgs]{font-size:22px;margin-top:.25em}#links[data-astro-cid-mmc7otgs]{display:flex;gap:16px}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs]{display:flex;align-items:center;padding:10px 12px;color:#111827;text-decoration:none;transition:color .2s}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs]:hover{color:#4e5056}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs] svg[data-astro-cid-mmc7otgs]{height:1em;margin-left:8px}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs].button{color:#fff;background:linear-gradient(83.21deg,#3245ff,#bc52ee);box-shadow:inset 0 0 0 1px #ffffff1f,inset 0 -2px #0000003d;border-radius:10px}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs].button:hover{color:#e6e6e6;box-shadow:none}pre[data-astro-cid-mmc7otgs]{font-family:ui-monospace,Cascadia Code,Source Code Pro,Menlo,Consolas,DejaVu Sans Mono,monospace;font-weight:400;background:linear-gradient(14deg,#d83333,#f041ff);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text;margin:0}h2[data-astro-cid-mmc7otgs]{margin:0 0 1em;font-weight:400;color:#111827;font-size:20px}p[data-astro-cid-mmc7otgs]{color:#4b5563;font-size:16px;line-height:24px;letter-spacing:-.006em;margin:0}code[data-astro-cid-mmc7otgs]{display:inline-block;background:linear-gradient(66.77deg,#f3cddd,#f5cee7) padding-box,linear-gradient(155deg,#d83333,#f041ff 18%,#f5cee7 45%) border-box;border-radius:8px;border:1px solid transparent;padding:6px 8px}.box[data-astro-cid-mmc7otgs]{padding:16px;background:#fff;border-radius:16px;border:1px solid white}#news[data-astro-cid-mmc7otgs]{position:absolute;bottom:16px;right:16px;max-width:300px;text-decoration:none;transition:background .2s;backdrop-filter:blur(50px)}#news[data-astro-cid-mmc7otgs]:hover{background:#ffffff8c}@media screen and (max-height:368px){#news[data-astro-cid-mmc7otgs]{display:none}}@media screen and (max-width:768px){#container[data-astro-cid-mmc7otgs]{display:flex;flex-direction:column}#hero[data-astro-cid-mmc7otgs]{display:block;padding-top:10%}#links[data-astro-cid-mmc7otgs]{flex-wrap:wrap}#links[data-astro-cid-mmc7otgs] a[data-astro-cid-mmc7otgs].button{padding:14px 18px}#news[data-astro-cid-mmc7otgs]{right:16px;left:16px;bottom:2.5rem;max-width:100%}h1[data-astro-cid-mmc7otgs]{line-height:1.5}}html,body{margin:0;width:100%;height:100%}
+</style></head> <body data-astro-cid-sckkx6r4>  <div id="container" data-astro-cid-mmc7otgs> <img id="background" src="/_astro/background.Mahwsfbs.svg" alt="" fetchpriority="high" data-astro-cid-mmc7otgs> <main data-astro-cid-mmc7otgs> <section id="hero" data-astro-cid-mmc7otgs> <a href="https://astro.build" data-astro-cid-mmc7otgs><img src="/_astro/astro.CXuftnGC.svg" width="115" height="48" alt="Astro Homepage" data-astro-cid-mmc7otgs></a> <h1 data-astro-cid-mmc7otgs>
+To get started, open the <code data-astro-cid-mmc7otgs><pre data-astro-cid-mmc7otgs>src/pages</pre></code> directory in your project.
+</h1> <section id="links" data-astro-cid-mmc7otgs> <a class="button" href="https://docs.astro.build" data-astro-cid-mmc7otgs>Read our docs</a> <a href="https://astro.build/chat" data-astro-cid-mmc7otgs>Join our Discord <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 127.14 96.36" data-astro-cid-mmc7otgs><path fill="currentColor" d="M107.7 8.07A105.15 105.15 0 0 0 81.47 0a72.06 72.06 0 0 0-3.36 6.83 97.68 97.68 0 0 0-29.11 0A72.37 72.37 0 0 0 45.64 0a105.89 105.89 0 0 0-26.25 8.09C2.79 32.65-1.71 56.6.54 80.21a105.73 105.73 0 0 0 32.17 16.15 77.7 77.7 0 0 0 6.89-11.11 68.42 68.42 0 0 1-10.85-5.18c.91-.66 1.8-1.34 2.66-2a75.57 75.57 0 0 0 64.32 0c.87.71 1.76 1.39 2.66 2a68.68 68.68 0 0 1-10.87 5.19 77 77 0 0 0 6.89 11.1 105.25 105.25 0 0 0 32.19-16.14c2.64-27.38-4.51-51.11-18.9-72.15ZM42.45 65.69C36.18 65.69 31 60 31 53s5-12.74 11.43-12.74S54 46 53.89 53s-5.05 12.69-11.44 12.69Zm42.24 0C78.41 65.69 73.25 60 73.25 53s5-12.74 11.44-12.74S96.23 46 96.12 53s-5.04 12.69-11.43 12.69Z" data-astro-cid-mmc7otgs></path></svg> </a> </section> </section> </main> <a href="https://astro.build/blog/astro-5/" id="news" class="box" data-astro-cid-mmc7otgs> <svg width="32" height="32" fill="none" xmlns="http://www.w3.org/2000/svg" data-astro-cid-mmc7otgs><path d="M24.667 12c1.333 1.414 2 3.192 2 5.334 0 4.62-4.934 5.7-7.334 12C18.444 28.567 18 27.456 18 26c0-4.642 6.667-7.053 6.667-14Zm-5.334-5.333c1.6 1.65 2.4 3.43 2.4 5.333 0 6.602-8.06 7.59-6.4 17.334C13.111 27.787 12 25.564 12 22.666c0-4.434 7.333-8 7.333-16Zm-6-5.333C15.111 3.555 16 5.556 16 7.333c0 8.333-11.333 10.962-5.333 22-3.488-.774-6-4-6-8 0-8.667 8.666-10 8.666-20Z" fill="#111827" data-astro-cid-mmc7otgs></path></svg> <h2 data-astro-cid-mmc7otgs>What's New in Astro 5.0?</h2> <p data-astro-cid-mmc7otgs>
+From content layers to server islands, click to learn more about the new features and
+			improvements in Astro 5.0
+</p> </a> </div>   </body></html>

package-lock.json

@@ -8,7 +8,7 @@
       "name": "computing-box",
       "version": "0.0.1",
       "dependencies": {
-        "astro": "^5.16.5"
+        "astro": "^5.16.6"
       }
     },
     "node_modules/@astrojs/compiler": {
@@ -1496,6 +1496,7 @@
       "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.2.tgz",
       "integrity": "sha512-gWEkeiyYE4vqjON/+Obqcoeffmk0NF15WSBwSs7zwVA2bAbTaE0SJ7P0WNGoJn8uE7fiaV5a7dKYIJriEqOrmA==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "undici-types": "~7.16.0"
       }
@@ -1649,9 +1650,9 @@
       }
     },
     "node_modules/astro": {
-      "version": "5.16.5",
+      "version": "5.16.6",
-      "resolved": "https://registry.npmjs.org/astro/-/astro-5.16.5.tgz",
+      "resolved": "https://registry.npmjs.org/astro/-/astro-5.16.6.tgz",
-      "integrity": "sha512-QeuM4xzTR0QuXFDNlGVW0BW7rcquKFIkylaPeM4ufii0/RRiPTYtwxDYVZ3KfiMRuuc+nbLD0214kMKTvz/yvQ==",
+      "integrity": "sha512-6mF/YrvwwRxLTu+aMEa5pwzKUNl5ZetWbTyZCs9Um0F12HUmxUiF5UHiZPy4rifzU3gtpM3xP2DfdmkNX9eZRg==",
       "license": "MIT",
       "dependencies": {
         "@astrojs/compiler": "^2.13.0",
@@ -4170,7 +4171,6 @@
       "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.53.3.tgz",
       "integrity": "sha512-w8GmOxZfBmKknvdXU1sdM9NHcoQejwF/4mNgj2JuEEdRaHwwF12K7e9eXn1nLZ07ad+du76mkVsyeb2rKGllsA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/estree": "1.0.8"
       },

package.json

@@ -9,6 +9,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^5.16.5"
+    "astro": "^5.16.6"
   }
 }

src/components/simulators/HexSimulator.astro

@@ -0,0 +1,104 @@
+---
+import "./hex/hex-simulator.css";
+---
+
+<section class="hex-sim" data-hex-sim>
+  <div class="hex-main">
+    <div class="hex-readout">
+      <div class="hex-label">DENARY</div>
+      <div class="hex-number" data-out="denary">0</div>
+
+      <div class="hex-label hex-mt">HEXADECIMAL</div>
+      <div class="hex-number hex-number--small" data-out="hex">00</div>
+
+      <div class="hex-label hex-mt">BINARY</div>
+      <div class="hex-number hex-number--tiny" data-out="bin">0000 0000</div>
+    </div>
+
+    <div class="hex-divider"></div>
+
+    <div class="hex-digits" data-out="digitsRow"></div>
+  </div>
+
+  <!-- Toolbox button -->
+  <button class="hex-toolbox-btn" type="button" data-action="toggleToolbox" aria-controls="hex-toolbox" aria-expanded="true">
+    <span class="hex-toolbox-icon" aria-hidden="true">
+      <!-- toolbox icon -->
+      <svg viewBox="0 0 24 24" width="18" height="18" fill="none">
+        <path d="M9 7V6a3 3 0 0 1 6 0v1" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+        <path d="M4 9h16l-1.3 10.4A2 2 0 0 1 16.7 21H7.3a2 2 0 0 1-1.98-1.6L4 9Z" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>
+        <path d="M10 13h4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+      </svg>
+    </span>
+    TOOLBOX
+  </button>
+
+  <!-- Toolbox panel -->
+  <aside class="hex-toolbox is-open" id="hex-toolbox" data-out="toolbox">
+    <div class="hex-panel">
+      <div class="hex-panel-title">SETTINGS</div>
+
+      <div class="hex-setting-title">HEX DIGIT WIDTH</div>
+
+      <div class="hex-width">
+        <button class="hex-btn hex-btn--square" type="button" data-action="digitsMinus">−</button>
+
+        <div class="hex-width-readout">
+          <div class="hex-width-label">DIGITS</div>
+          <div class="hex-width-number" data-out="digitsCount">2</div>
+        </div>
+
+        <button class="hex-btn hex-btn--square" type="button" data-action="digitsPlus">+</button>
+      </div>
+
+      <div class="hex-hint" data-out="bitsHint">= 8 bits</div>
+    </div>
+
+    <div class="hex-panel">
+      <div class="hex-panel-title">CUSTOM NUMBER</div>
+
+      <div class="hex-grid-2">
+        <button class="hex-btn hex-btn--green" type="button" data-action="customHex">Custom Hexadecimal</button>
+        <button class="hex-btn hex-btn--green" type="button" data-action="customDenary">Custom Denary</button>
+      </div>
+
+      <!-- Custom Binary + Random on SAME row, same size -->
+      <div class="hex-grid-2 hex-mt-sm">
+        <button class="hex-btn hex-btn--green" type="button" data-action="customBinary">Custom Binary</button>
+        <button class="hex-btn hex-btn--wide hex-btn--random" type="button" data-action="random" data-random>Random</button>
+      </div>
+
+      <div class="hex-tiny-note">RANDOM RUNS BRIEFLY THEN STOPS AUTOMATICALLY.</div>
+    </div>
+
+    <div class="hex-panel">
+      <div class="hex-panel-title">TOOLS</div>
+
+      <div class="hex-tools-top">
+        <button class="hex-btn hex-btn--square hex-btn--red" type="button" data-action="decrement" title="Decrement">▼</button>
+        <button class="hex-btn hex-btn--square hex-btn--green2" type="button" data-action="increment" title="Increment">▲</button>
+      </div>
+
+      <button class="hex-btn hex-btn--wide hex-btn--reset" type="button" data-action="reset">Reset</button>
+    </div>
+  </aside>
+
+  <!-- Custom number dialog -->
+  <dialog class="hex-dialog" data-out="dialog">
+    <div class="hex-dialog-card">
+      <div class="hex-dialog-title" data-out="dialogTitle">Custom</div>
+
+      <input class="hex-dialog-input hex-font-mono" data-out="dialogInput" />
+
+      <div class="hex-dialog-hint" data-out="dialogHint"></div>
+      <div class="hex-dialog-error" data-out="dialogError" aria-live="polite"></div>
+
+      <div class="hex-dialog-actions">
+        <button class="hex-btn" type="button" data-action="dialogCancel">Cancel</button>
+        <button class="hex-btn hex-btn--green" type="button" data-action="dialogApply">Apply</button>
+      </div>
+    </div>
+  </dialog>
+
+  <script type="module" src="/src/components/simulators/hex/hex-simulator.ts"></script>
+</section>

src/components/simulators/hex/hex-simulator.css

@@ -0,0 +1,346 @@
+/* ================= Fonts to match Binary ================= */
+/* Adjust paths to wherever you store fonts (commonly /public/fonts/...) */
+@font-face {
+  font-family: "DSEG7Classic";
+  src: url("/fonts/DSEG7Classic-Regular.woff") format("woff"),
+       url("/fonts/DSEG7Classic-Regular.ttf") format("truetype");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: "SevenSegment";
+  src: url("/fonts/Seven-Segment.woff2") format("woff2"),
+       url("/fonts/Seven-Segment.woff") format("woff");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+.hex-sim {
+  min-height: 100vh;
+  background: #14151c;
+  color: #e7e8ee;
+  padding: 28px;
+}
+
+.hex-font-number { font-family: "DSEG7Classic", ui-monospace, monospace; }
+.hex-font-mono   { font-family: "SevenSegment", ui-monospace, monospace; }
+
+.hex-main { max-width: 1200px; margin: 0 auto; width: 100%; padding-top: 40px; }
+
+.hex-readout { text-align: center; }
+.hex-label {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  font-size: 12px;
+  letter-spacing: 2px;
+  opacity: 0.7;
+}
+.hex-mt { margin-top: 12px; }
+
+.hex-number {
+  font-family: "DSEG7Classic", ui-monospace, monospace;
+  font-size: 76px;
+  line-height: 1;
+  font-weight: 400;
+  color: #46ff8a;
+  text-shadow: 0 0 18px rgba(70,255,138,0.18);
+}
+.hex-number--small { font-size: 64px; }
+.hex-number--tiny  { font-size: 54px; letter-spacing: 6px; }
+
+.hex-divider {
+  margin: 26px auto 18px;
+  height: 1px;
+  width: min(760px, 90%);
+  background: rgba(255,255,255,0.10);
+}
+
+/* ================= Main digit columns ================= */
+.hex-digits {
+  margin-top: 18px;
+  display: flex;
+  justify-content: center;
+  gap: 18px;
+  flex-wrap: wrap;
+}
+
+.hex-digit-col {
+  width: 160px;
+  border-radius: 18px;
+  background: rgba(255,255,255,0.03);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 12px;
+  display: grid;
+  gap: 10px;
+  justify-items: center;
+}
+
+.hex-digit-controls {
+  width: 100%;
+  display: flex;
+  justify-content: center;
+  gap: 10px;
+}
+
+.hex-digit-char {
+  font-size: 64px;
+  line-height: 1;
+  color: #46ff8a;
+  text-shadow: 0 0 18px rgba(70,255,138,0.18);
+}
+
+.hex-digit-place {
+  font-family: "SevenSegment", ui-monospace, monospace;
+  opacity: 0.65;
+  font-size: 14px;
+  letter-spacing: 1px;
+}
+
+/* ================= Bulbs (brightness changes) ================= */
+.hex-bulbs {
+  width: 100%;
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 10px;
+  align-items: end;
+}
+
+.hex-bulb {
+  display: grid;
+  justify-items: center;
+  gap: 6px;
+  opacity: 0.35;
+  filter: grayscale(30%);
+  transition: opacity 160ms ease, filter 160ms ease;
+}
+
+.hex-bulb .hex-bulb-cap {
+  width: 18px;
+  height: 18px;
+  border-radius: 999px;
+  background: rgba(255,255,255,0.22);
+  border: 1px solid rgba(255,255,255,0.14);
+}
+
+.hex-bulb .hex-bulb-glow {
+  width: 18px;
+  height: 10px;
+  border-radius: 999px;
+  background: rgba(70,255,138,0.0);
+  box-shadow: 0 0 0 rgba(70,255,138,0.0);
+  transition: background 160ms ease, box-shadow 160ms ease;
+}
+
+.hex-bulb .hex-bulb-label {
+  font-family: "SevenSegment", ui-monospace, monospace;
+  font-size: 12px;
+  opacity: 0.8;
+}
+
+.hex-bulb.is-on {
+  opacity: 1;
+  filter: none;
+}
+.hex-bulb.is-on .hex-bulb-cap {
+  background: rgba(255,255,255,0.35);
+}
+.hex-bulb.is-on .hex-bulb-glow {
+  background: rgba(70,255,138,0.25);
+  box-shadow: 0 0 18px rgba(70,255,138,0.35);
+}
+
+/* ================= Buttons (toolbox style reused everywhere) ================= */
+.hex-btn {
+  padding: 10px 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(255,255,255,0.06);
+  color: #e7e8ee;
+  font-weight: 800;
+  cursor: pointer;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+}
+.hex-btn:hover { background: rgba(255,255,255,0.10); }
+
+.hex-btn--square {
+  width: 48px;
+  height: 48px;
+  padding: 0;
+  display: grid;
+  place-items: center;
+  font-size: 18px;
+}
+
+.hex-btn--wide { width: 100%; }
+
+.hex-btn--green {
+  background: rgba(46, 200, 120, 0.18);
+  border-color: rgba(46,200,120,0.35);
+}
+.hex-btn--green:hover { background: rgba(46, 200, 120, 0.26); }
+
+.hex-btn--green2 {
+  background: rgba(46, 200, 120, 0.18);
+  border-color: rgba(46,200,120,0.35);
+}
+
+.hex-btn--red {
+  background: rgba(220, 60, 70, 0.18);
+  border-color: rgba(220,60,70,0.35);
+}
+
+/* Random = green pulse while running */
+.hex-btn--random.is-running {
+  border-color: rgba(80, 255, 160, 0.55);
+  background: rgba(46, 200, 120, 0.22);
+  box-shadow: 0 0 18px rgba(80, 255, 160, 0.35);
+  animation: hexPulseGreen 900ms ease-in-out infinite;
+}
+@keyframes hexPulseGreen {
+  0%, 100% { box-shadow: 0 0 14px rgba(80, 255, 160, 0.25); }
+  50% { box-shadow: 0 0 26px rgba(80, 255, 160, 0.45); }
+}
+
+/* Reset = red background + pulse on hover */
+.hex-btn--reset:hover {
+  background: rgba(220, 60, 70, 0.28);
+  border-color: rgba(255, 80, 90, 0.55);
+  animation: hexPulseRed 900ms ease-in-out infinite;
+}
+@keyframes hexPulseRed {
+  0%, 100% { box-shadow: 0 0 12px rgba(255, 80, 90, 0.20); }
+  50% { box-shadow: 0 0 22px rgba(255, 80, 90, 0.38); }
+}
+
+/* ================= Toolbox button + panel (slide) ================= */
+.hex-toolbox-btn {
+  position: fixed;
+  top: 88px;
+  right: 28px;
+  z-index: 30;
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px 16px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(255,255,255,0.06);
+  color: #e7e8ee;
+  font-weight: 800;
+  letter-spacing: 1px;
+  cursor: pointer;
+}
+
+.hex-toolbox-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 18px;
+  height: 18px;
+  color: #ff4fa6;
+  filter: drop-shadow(0 0 10px rgba(255,79,166,0.35));
+}
+
+.hex-toolbox {
+  position: fixed;
+  top: 140px;
+  right: 28px;
+  width: 340px;
+  display: grid;
+  gap: 14px;
+  z-index: 25;
+
+  transform: translateX(0);
+  opacity: 1;
+  transition: transform 220ms ease, opacity 220ms ease;
+}
+.hex-toolbox:not(.is-open) {
+  transform: translateX(380px);
+  opacity: 0;
+  pointer-events: none;
+}
+
+.hex-panel {
+  border-radius: 16px;
+  background: rgba(255,255,255,0.04);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 14px;
+}
+.hex-panel-title {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  font-size: 12px;
+  letter-spacing: 2px;
+  opacity: 0.7;
+  margin-bottom: 10px;
+}
+
+.hex-setting-title { font-weight: 900; opacity: 0.9; margin-bottom: 10px; }
+
+.hex-width {
+  display: grid;
+  grid-template-columns: 48px 1fr 48px;
+  gap: 10px;
+  align-items: center;
+}
+.hex-width-readout {
+  border-radius: 14px;
+  background: rgba(0,0,0,0.22);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 10px 12px;
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+}
+.hex-width-label {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  opacity: 0.7;
+  font-weight: 800;
+  letter-spacing: 1px;
+  font-size: 12px;
+}
+.hex-width-number { font-size: 30px; font-weight: 900; color: #46ff8a; }
+
+.hex-hint { margin-top: 8px; opacity: 0.65; font-size: 12px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+.hex-grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
+.hex-mt-sm { margin-top: 10px; }
+
+.hex-tools-top { display: flex; gap: 10px; justify-content: center; margin-bottom: 10px; }
+.hex-tiny-note { margin-top: 8px; font-size: 11px; opacity: 0.6; letter-spacing: 1px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+/* ================= Dialog ================= */
+.hex-dialog { border: none; padding: 0; background: transparent; }
+.hex-dialog::backdrop { background: rgba(0,0,0,0.55); }
+
+.hex-dialog-card {
+  width: min(560px, 92vw);
+  border-radius: 18px;
+  background: #1a1b24;
+  border: 1px solid rgba(255,255,255,0.12);
+  padding: 16px;
+  color: #e7e8ee;
+}
+
+.hex-dialog-title { font-weight: 900; letter-spacing: 1px; margin-bottom: 10px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+.hex-dialog-input {
+  width: 100%;
+  padding: 12px 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(0,0,0,0.25);
+  color: #e7e8ee;
+  font-size: 18px;
+}
+
+.hex-dialog-hint { margin-top: 10px; opacity: 0.7; font-size: 13px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+.hex-dialog-error { margin-top: 8px; font-size: 13px; color: #ff6b6b; min-height: 18px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+.hex-dialog-actions { margin-top: 14px; display: flex; gap: 10px; justify-content: flex-end; }
+
+@media (max-width: 900px) {
+  .hex-toolbox { width: min(360px, 92vw); right: 16px; }
+  .hex-toolbox-btn { right: 16px; }
+  .hex-number { font-size: 60px; }
+  .hex-number--tiny { font-size: 40px; letter-spacing: 4px; }
+}

src/components/simulators/hex/hex-simulator.ts

@@ -0,0 +1,232 @@
+type DialogMode = "hex" | "den" | "bin";
+
+const root = document.querySelector<HTMLElement>("[data-hex-sim]");
+if (!root) throw new Error("Hex simulator root not found");
+
+const outDen = root.querySelector<HTMLElement>('[data-out="denary"]')!;
+const outHex = root.querySelector<HTMLElement>('[data-out="hex"]')!;
+const outBin = root.querySelector<HTMLElement>('[data-out="bin"]')!;
+const outDigitsRow = root.querySelector<HTMLElement>('[data-out="digitsRow"]')!;
+
+const toolbox = root.querySelector<HTMLElement>('[data-out="toolbox"]')!;
+const toolboxBtn = root.querySelector<HTMLButtonElement>('[data-action="toggleToolbox"]')!;
+const digitsCount = root.querySelector<HTMLElement>('[data-out="digitsCount"]')!;
+const bitsHint = root.querySelector<HTMLElement>('[data-out="bitsHint"]')!;
+const randomBtn = root.querySelector<HTMLButtonElement>("[data-random]")!;
+
+const dialog = root.querySelector<HTMLDialogElement>('[data-out="dialog"]')!;
+const dialogTitle = root.querySelector<HTMLElement>('[data-out="dialogTitle"]')!;
+const dialogInput = root.querySelector<HTMLInputElement>('[data-out="dialogInput"]')!;
+const dialogHint = root.querySelector<HTMLElement>('[data-out="dialogHint"]')!;
+const dialogError = root.querySelector<HTMLElement>('[data-out="dialogError"]')!;
+
+let digits = 2;        // 1..8
+let value = 0;         // unsigned denary
+let randomTimer: number | null = null;
+let dialogMode: DialogMode | null = null;
+
+const clamp = (n: number, min: number, max: number) => Math.min(max, Math.max(min, n));
+const maxForDigits = (d: number) => (16 ** d) - 1;
+
+const padHex = (n: number, d: number) => n.toString(16).toUpperCase().padStart(d, "0");
+const padBin = (n: number, b: number) => n.toString(2).padStart(b, "0");
+const groupBin = (b: string) => b.replace(/(.{4})/g, "$1 ").trim();
+
+function stopRandom(): void {
+  if (randomTimer !== null) window.clearInterval(randomTimer);
+  randomTimer = null;
+  randomBtn.classList.remove("is-running");
+}
+
+function startRandom(): void {
+  stopRandom();
+  const max = maxForDigits(digits);
+  const start = Date.now();
+
+  randomBtn.classList.add("is-running");
+
+  randomTimer = window.setInterval(() => {
+    value = Math.floor(Math.random() * (max + 1));
+    render();
+    if (Date.now() - start > 1600) stopRandom();
+  }, 90);
+}
+
+function render(): void {
+  const bits = digits * 4;
+
+  digitsCount.textContent = String(digits);
+  bitsHint.textContent = `= ${bits} bits`;
+
+  outDen.textContent = String(value);
+  outHex.textContent = padHex(value, digits);
+  outBin.textContent = groupBin(padBin(value, bits));
+
+  renderDigitsRow();
+}
+
+function renderDigitsRow(): void {
+  const hex = padHex(value, digits);
+  outDigitsRow.innerHTML = "";
+
+  for (let i = 0; i < digits; i++) {
+    const pow = digits - 1 - i;
+    const placeValue = 16 ** pow;
+
+    const digitChar = hex[i];
+    const digitVal = parseInt(digitChar, 16);
+    const nibbleBits = [(digitVal >> 3) & 1, (digitVal >> 2) & 1, (digitVal >> 1) & 1, digitVal & 1]; // 8 4 2 1
+
+    const col = document.createElement("div");
+    col.className = "hex-digit-col";
+    col.innerHTML = `
+      <div class="hex-digit-controls">
+        <button class="hex-btn hex-btn--square hex-btn--green2" type="button" data-action="digitUp" data-i="${i}" title="Increase">▲</button>
+        <button class="hex-btn hex-btn--square hex-btn--red" type="button" data-action="digitDown" data-i="${i}" title="Decrease">▼</button>
+      </div>
+
+      <div class="hex-digit-char hex-font-number">${digitChar}</div>
+
+      <!-- bulbs: brightness changes based on nibble bits -->
+      <div class="hex-bulbs" aria-label="Nibble bits">
+        ${[8,4,2,1].map((w, idx) => {
+          const on = nibbleBits[idx] === 1;
+          return `
+            <div class="hex-bulb ${on ? "is-on" : ""}">
+              <div class="hex-bulb-cap"></div>
+              <div class="hex-bulb-glow"></div>
+              <div class="hex-bulb-label">${w}</div>
+            </div>
+          `;
+        }).join("")}
+      </div>
+
+      <div class="hex-digit-place">${placeValue}</div>
+    `;
+    outDigitsRow.appendChild(col);
+  }
+}
+
+function openDialog(mode: DialogMode): void {
+  stopRandom();
+  dialogMode = mode;
+
+  dialogError.textContent = "";
+  dialogInput.value = "";
+
+  if (mode === "hex") {
+    dialogTitle.textContent = "Custom Hexadecimal";
+    dialogHint.textContent = `Enter 1–${digits} hex digit(s) (0–9, A–F).`;
+    dialogInput.placeholder = "A1";
+    dialogInput.inputMode = "text";
+  } else if (mode === "den") {
+    dialogTitle.textContent = "Custom Denary";
+    dialogHint.textContent = `Enter a whole number from 0 to ${maxForDigits(digits)}.`;
+    dialogInput.placeholder = "42";
+    dialogInput.inputMode = "numeric";
+  } else {
+    dialogTitle.textContent = "Custom Binary";
+    dialogHint.textContent = `Enter up to ${digits * 4} bit(s) using 0 and 1.`;
+    dialogInput.placeholder = "00101010";
+    dialogInput.inputMode = "text";
+  }
+
+  dialog.showModal();
+  window.setTimeout(() => dialogInput.focus(), 0);
+}
+
+function closeDialog(): void {
+  dialogMode = null;
+  dialogError.textContent = "";
+  if (dialog.open) dialog.close();
+}
+
+function applyDialog(): void {
+  const raw = (dialogInput.value || "").trim();
+  if (!dialogMode) return closeDialog();
+  if (raw.length === 0) return closeDialog();
+
+  const max = maxForDigits(digits);
+  const bits = digits * 4;
+
+  if (dialogMode === "hex") {
+    const v = raw.toUpperCase();
+    if (!/^[0-9A-F]+$/.test(v)) { dialogError.textContent = "Hex must use 0–9 and A–F only."; return; }
+    if (v.length > digits) { dialogError.textContent = `Max length is ${digits} hex digit(s).`; return; }
+    value = clamp(parseInt(v, 16), 0, max);
+    render();
+    return closeDialog();
+  }
+
+  if (dialogMode === "den") {
+    if (!/^\d+$/.test(raw)) { dialogError.textContent = "Denary must be whole numbers only."; return; }
+    const n = Number(raw);
+    if (!Number.isFinite(n)) { dialogError.textContent = "Invalid number."; return; }
+    value = clamp(n, 0, max);
+    render();
+    return closeDialog();
+  }
+
+  // bin
+  if (!/^[01]+$/.test(raw)) { dialogError.textContent = "Binary must use 0 and 1 only."; return; }
+  if (raw.length > bits) { dialogError.textContent = `Max length is ${bits} bit(s).`; return; }
+  value = clamp(parseInt(raw, 2), 0, max);
+  render();
+  return closeDialog();
+}
+
+function applyDigitDelta(i: number, delta: number): void {
+  stopRandom();
+  const hexArr = padHex(value, digits).split("");
+  let v = parseInt(hexArr[i], 16);
+  v = (v + delta) % 16;
+  if (v < 0) v += 16;
+  hexArr[i] = v.toString(16).toUpperCase();
+  value = clamp(parseInt(hexArr.join(""), 16), 0, maxForDigits(digits));
+  render();
+}
+
+// dialog cancel / backdrop
+dialog.addEventListener("cancel", (e) => { e.preventDefault(); closeDialog(); });
+dialog.addEventListener("click", (e) => {
+  const card = dialog.querySelector(".hex-dialog-card");
+  if (card && !card.contains(e.target as Node)) closeDialog();
+});
+dialogInput.addEventListener("keydown", (e) => {
+  if (e.key === "Enter") applyDialog();
+  if (e.key === "Escape") closeDialog();
+});
+
+// main click handler
+root.addEventListener("click", (e) => {
+  const btn = (e.target as HTMLElement).closest<HTMLElement>("[data-action]");
+  if (!btn) return;
+  const action = btn.getAttribute("data-action")!;
+
+  if (action === "toggleToolbox") {
+    toolbox.classList.toggle("is-open");
+    toolboxBtn.setAttribute("aria-expanded", toolbox.classList.contains("is-open") ? "true" : "false");
+    return;
+  }
+
+  if (action === "digitsMinus") { digits = clamp(digits - 1, 1, 8); value = clamp(value, 0, maxForDigits(digits)); return render(); }
+  if (action === "digitsPlus")  { digits = clamp(digits + 1, 1, 8); value = clamp(value, 0, maxForDigits(digits)); return render(); }
+
+  if (action === "increment") { stopRandom(); value = clamp(value + 1, 0, maxForDigits(digits)); return render(); }
+  if (action === "decrement") { stopRandom(); value = clamp(value - 1, 0, maxForDigits(digits)); return render(); }
+
+  if (action === "reset")     { stopRandom(); value = 0; return render(); }
+  if (action === "random")    { return startRandom(); }
+
+  if (action === "customHex")    return openDialog("hex");
+  if (action === "customDenary") return openDialog("den");
+  if (action === "customBinary") return openDialog("bin");
+
+  if (action === "dialogCancel") return closeDialog();
+  if (action === "dialogApply")  return applyDialog();
+
+  if (action === "digitUp")   return applyDigitDelta(Number(btn.getAttribute("data-i")), +1);
+  if (action === "digitDown") return applyDigitDelta(Number(btn.getAttribute("data-i")), -1);
+});
+
+render();

src/components/site-footer.astro

@@ -0,0 +1,8 @@
+<footer class="site-footer">
+  <div class="site-footer__inner">
+    <div class="site-footer__text">
+      COMPUTER SCIENCE CONCEPT SIMULATORS<br />
+      © 2025 COMPUTING:BOX • CREATED WITH ♥ BY MR LYALL
+    </div>
+  </div>
+</footer>

src/components/site-header.astro

@@ -0,0 +1,25 @@
+---
+const nav = [
+  { href: "/about", label: "About" },
+  { href: "/binary", label: "Binary" },
+  { href: "/hexadecimal", label: "Hexadecimal" },
+  { href: "/hex-colours", label: "Hex Colours" },
+  { href: "/logic-gates", label: "Logic Gates" },
+];
+---
+<header class="site-header">
+  <div class="site-header__inner">
+    <a class="site-header__brand" href="/" aria-label="Computing:Box home">
+      <img class="site-header__logo" src="/img/logo.png" alt="" width="26" height="26" />
+      <span class="site-header__name">COMPUTING:BOX</span>
+    </a>
+
+    <nav class="site-header__nav" aria-label="Primary">
+      {nav.map((i) => (
+        <a class="site-header__link" href={i.href}>
+          {i.label.toUpperCase()}
+        </a>
+      ))}
+    </nav>
+  </div>
+</header>

src/layouts/BaseLayout.astro

@@ -8,34 +8,111 @@ const { title = "Computing:Box" } = Astro.props;
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>{title}</title>
-    <link rel="stylesheet" href="/src/styles/site.css" />
+
+    <style>
+      :root{
+        --nav-h: 108px; /* 3x-ish height */
+        --bg: #1f2027;
+        --text: #e8e8ee;
+        --muted: #a9acb8;
+        --line: rgba(255,255,255,.10);
+      }
+
+      body{
+        margin:0;
+        background:var(--bg);
+        color:var(--text);
+      }
+
+      .siteNav{
+        position: sticky;
+        top: 0;
+        z-index: 50;
+        height: var(--nav-h);
+        background: rgba(0,0,0,.10);
+        border-bottom: 1px solid var(--line);
+        backdrop-filter: blur(8px);
+      }
+
+      .navInner{
+        height: 100%;
+        max-width: 1400px;
+        margin: 0 auto;
+        padding: 0 20px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 24px;
+      }
+
+      .brand{
+        display:flex;
+        align-items:center;
+        gap:12px;
+        text-decoration:none;
+        color:var(--text);
+      }
+
+      .brandLogo{
+        width: 2em;
+        height: 2em;
+        image-rendering: pixelated;
+      }
+
+      .brandName{
+        letter-spacing: .12em;
+        font-weight: 900;
+        text-transform: uppercase;
+        font-size: 18px;
+      }
+
+      .navLinks{
+        display:flex;
+        align-items:center;
+        gap:18px;
+        flex-wrap:wrap;
+      }
+
+      .navLinks a{
+        color: var(--muted);
+        text-decoration: none;
+        font-weight: 800;
+        letter-spacing: .12em;
+        font-size: 16px;
+        text-transform: uppercase;
+      }
+
+      .navLinks a:hover{
+        color: var(--text);
+      }
+
+      .pageWrap{
+        max-width: 1400px;
+        margin: 0 auto;
+      }
+    </style>
   </head>
 
   <body>
-    <header class="site-header">
+    <header class="siteNav">
-      <div class="site-header__inner">
+      <div class="navInner">
-        <div class="brand">Computing:Box</div>
+        <a class="brand" href="/">
+          <img class="brandLogo" src="/images/computing-box-logo.svg" alt="Computing:Box logo" />
+          <span class="brandName">COMPUTING:BOX</span>
+        </a>
 
-        <nav class="nav">
+        <nav class="navLinks" aria-label="Site navigation">
-          <a class="nav__link" href="/binary">Binary</a>
+          <a href="/about">ABOUT</a>
-          <a class="nav__link" href="/hexadecimal">Hexadecimal</a>
+          <a href="/binary">BINARY</a>
-          <a class="nav__link" href="/hex-colours">Hex Colours</a>
+          <a href="/hexadecimal">HEXADECIMAL</a>
-          <a class="nav__link" href="/logic-gates">Logic Gates</a>
+          <a href="/hex-colours">HEX COLOURS</a>
-          <a class="nav__link" href="/about">About</a>
+          <a href="/logic-gates">LOGIC GATES</a>
         </nav>
       </div>
     </header>
 
-    <main class="site-main">
+    <main class="pageWrap">
       <slot />
     </main>
-
-    <footer class="site-footer">
-      <div class="site-footer__inner">
-        <div>Computer Science Concept Simulators</div>
-        <div>© 2025 Computing:Box · Created with 💜 by Mr Lyall</div>
-        <div>Powered by ADCM Networks</div>
-      </div>
-    </footer>
   </body>
 </html>

src/pages/binary.astro

@@ -1,104 +1,54 @@
 ---
+import BaseLayout from "../layouts/BaseLayout.astro";
 import "../styles/binary.css";
-
-// ✅ Vite-bundled JS URL (works in dev + build + preview)
-import binaryScriptUrl from "../scripts/binary.js?url";
-
-// If you already have a site-wide Layout that adds header/footer,
-// wrap the page with it here.
-// Example (uncomment and adjust if you have it):
-// import Layout from "../layouts/Layout.astro";
 ---
 
-<!doctype html>
+<BaseLayout title="Binary Simulator">
-<html lang="en">
+  <button id="toolboxToggle" class="toolboxToggle" type="button" aria-expanded="true">
-  <head>
+    <span class="toolboxIcon" aria-hidden="true">🧰</span>
-    <meta charset="utf-8" />
+    <span class="toolboxLabel">TOOLBOX</span>
-    <meta name="viewport" content="width=device-width,initial-scale=1" />
+  </button>
-    <title>Binary | Computing:Box</title>
-  </head>
 
-  <body>
+  <main class="wrap">
-    <!-- If using Layout, do:
+    <section class="topGrid">
-    <Layout title="Binary | Computing:Box">
+      <!-- LEFT -->
-      ...everything inside <main>...
+      <div>
-    </Layout>
+        <div class="readout">
-    -->
+          <div class="label">Denary</div>
+          <div id="denaryNumber" class="num denaryValue">0</div>
 
-    <main class="wrap">
+          <div class="label">Binary</div>
-      <section class="topGrid">
+          <div id="binaryNumber" class="num binaryValue">0000 0000</div>
-        <!-- LEFT -->
-        <div>
-          <div class="readout">
-            <div class="label">Denary</div>
-            <div id="denaryNumber" class="num denaryValue">0</div>
-
-            <div class="label">Binary</div>
-            <div id="binaryNumber" class="num binaryValue">0</div>
-
-            <!-- Custom buttons on one line -->
-            <div class="controlsStack">
-              <div class="controlsRow">
-                <button class="btn btnAccent" id="btnCustomBinary" type="button">Custom Binary</button>
-                <button class="btn btnAccent" id="btnCustomDenary" type="button">Custom Denary</button>
-              </div>
-
-              <!-- Shift buttons on another line -->
-              <div class="controlsRow">
-                <button class="btn" id="btnShiftLeft" type="button">Left Shift</button>
-                <button class="btn" id="btnShiftRight" type="button">Right Shift</button>
-              </div>
-            </div>
-          </div>
-
-          <div class="divider"></div>
-
-          <section class="bitsWrap" aria-label="Bit switches">
-            <div class="bitsGrid" id="bitsGrid"></div>
-          </section>
         </div>
 
-        <!-- RIGHT -->
+        <div class="divider"></div>
-        <aside class="panelCol">
-          <div class="card">
-            <div class="cardTitle">Mode</div>
 
-            <div class="toggleRow">
+        <section class="bitsWrap" aria-label="Bit switches">
-              <div class="toggleLabel" id="lblUnsigned">Unsigned</div>
+          <div class="bitsGrid" id="bitsGrid"></div>
+        </section>
+      </div>
 
-              <label class="switch" aria-label="Toggle mode">
+      <!-- RIGHT TOOLBOX -->
-                <input id="modeToggle" type="checkbox" />
+      <aside id="toolbox" class="panelCol" aria-label="Toolbox">
-                <span class="slider"></span>
+        <!-- SETTINGS -->
-              </label>
+        <div class="card">
+          <div class="cardTitle">Settings</div>
 
-              <div class="toggleLabel" id="lblTwos">Two&rsquo;s complement</div>
+          <div class="toggleRow">
-            </div>
+            <div class="toggleLabel" id="lblUnsigned">Unsigned</div>
-
+            <label class="switch" aria-label="Toggle mode">
-            <div class="hint" id="modeHint">
+              <input id="modeToggle" type="checkbox" />
-              Tip: In unsigned binary, all bits represent positive values.
+              <span class="slider"></span>
-            </div>
+            </label>
+            <div class="toggleLabel" id="lblTwos">Two&rsquo;s complement</div>
           </div>
 
-          <!-- Tools: arrows on one row, Reset+Random on one row -->
+          <div class="hint" id="modeHint">
-          <div class="card">
+            Tip: In unsigned binary, all bits represent positive values.
-            <div class="cardTitle">Tools</div>
-
-            <div class="toolRow">
-              <button class="toolBtn toolSpin" id="btnDec" type="button" aria-label="Decrement">▼</button>
-              <button class="toolBtn toolSpin" id="btnInc" type="button" aria-label="Increment">▲</button>
-            </div>
-
-            <div class="toolRow2">
-              <button class="toolBtn" id="btnClear" type="button">Reset</button>
-              <button class="toolBtn" id="btnRandom" type="button">Random</button>
-            </div>
-
-            <div class="hint">Random runs briefly then stops automatically.</div>
           </div>
 
-          <div class="card">
+          <div class="subCard">
-            <div class="cardTitle">Bit width</div>
+            <div class="subTitle">Bit width</div>
-
             <div class="bitWidthRow">
               <button class="miniBtn" id="btnBitsDown" type="button" aria-label="Decrease bits">−</button>
 
@@ -119,14 +69,44 @@ import binaryScriptUrl from "../scripts/binary.js?url";
 
               <button class="miniBtn" id="btnBitsUp" type="button" aria-label="Increase bits">+</button>
             </div>
-
-            <div class="hint">Minimum 1 bit, maximum 64 bits.</div>
           </div>
-        </aside>
+        </div>
-      </section>
-    </main>
 
-    <!-- ✅ correct bundled JS reference -->
+        <!-- CUSTOM -->
-    <script type="module" src={binaryScriptUrl}></script>
+        <div class="card">
-  </body>
+          <div class="cardTitle">Custom</div>
-</html>
+
+          <div class="twoBtnRow">
+            <button class="btn btnAccent" id="btnCustomBinary" type="button">Custom Binary</button>
+            <button class="btn btnAccent" id="btnCustomDenary" type="button">Custom Denary</button>
+          </div>
+
+          <button class="toolBtn toolWide toolRandom" id="btnRandom" type="button">
+            Random
+          </button>
+
+          <div class="hint">Random runs briefly then stops automatically.</div>
+        </div>
+
+        <!-- TOOLS -->
+        <div class="card">
+          <div class="cardTitle">Tools</div>
+
+          <div class="toolsTopRow">
+            <button class="toolBtn toolArrow toolDown" id="btnDec" type="button" aria-label="Decrement">▼</button>
+            <button class="toolBtn toolArrow toolUp" id="btnInc" type="button" aria-label="Increment">▲</button>
+          </div>
+
+          <div class="twoBtnRow">
+            <button class="btn" id="btnShiftLeft" type="button">Left Shift</button>
+            <button class="btn" id="btnShiftRight" type="button">Right Shift</button>
+          </div>
+
+          <button class="toolBtn toolWide toolReset" id="btnClear" type="button">Reset</button>
+        </div>
+      </aside>
+    </section>
+  </main>
+
+  <script type="module" src="/src/scripts/binary.js"></script>
+</BaseLayout>

src/pages/hexadecimal.astro

@@ -0,0 +1,8 @@
+---
+import BaseLayout from "../layouts/BaseLayout.astro";
+import HexSimulator from "../components/simulators/HexSimulator.astro";
+---
+
+<BaseLayout title="Hexadecimal | Computing:Box">
+  <HexSimulator />
+</BaseLayout>

src/scripts/binary.js

@@ -1,6 +1,5 @@
 // src/scripts/binary.js
 // Computing:Box — Binary page logic (Unsigned + Two's Complement)
-// NOTE: This file is written to match the IDs/classes in your current binary.astro HTML.
 
 (() => {
   /* -----------------------------
@@ -13,8 +12,6 @@
 
   const modeToggle = document.getElementById("modeToggle");
   const modeHint = document.getElementById("modeHint");
-  const lblUnsigned = document.getElementById("lblUnsigned");
-  const lblTwos = document.getElementById("lblTwos");
 
   const btnCustomBinary = document.getElementById("btnCustomBinary");
   const btnCustomDenary = document.getElementById("btnCustomDenary");
@@ -29,15 +26,15 @@
   const btnBitsUp = document.getElementById("btnBitsUp");
   const btnBitsDown = document.getElementById("btnBitsDown");
 
+  const toolboxToggle = document.getElementById("toolboxToggle");
+  const toolboxPanel = document.getElementById("toolboxPanel");
+
   /* -----------------------------
      STATE
   ----------------------------- */
   let bitCount = clampInt(Number(bitsInput?.value ?? 8), 1, 64);
-
-  // bits[i] is bit value 2^i (LSB at i=0)
   let bits = new Array(bitCount).fill(false);
 
-  // Random run timer (brief)
   let randomTimer = null;
 
   /* -----------------------------
@@ -57,7 +54,7 @@
   }
 
   function unsignedMaxExclusive(nBits) {
-    return pow2Big(nBits); // 2^n
+    return pow2Big(nBits);
   }
 
   function unsignedMaxValue(nBits) {
@@ -81,7 +78,8 @@
   }
 
   function unsignedBigIntToBits(vUnsigned) {
-    const v = ((vUnsigned % unsignedMaxExclusive(bitCount)) + unsignedMaxExclusive(bitCount)) % unsignedMaxExclusive(bitCount);
+    const span = unsignedMaxExclusive(bitCount);
+    const v = ((vUnsigned % span) + span) % span;
     for (let i = 0; i < bitCount; i++) {
       bits[i] = ((v >> BigInt(i)) & 1n) === 1n;
     }
@@ -91,30 +89,16 @@
     const u = bitsToUnsignedBigInt();
     const signBit = bits[bitCount - 1] === true;
     if (!signBit) return u;
-
-    // negative: u - 2^n
     return u - pow2Big(bitCount);
   }
 
   function signedBigIntToBitsTwos(vSigned) {
-    // wrap into range [-2^(n-1), 2^(n-1)-1]
+    const span = pow2Big(bitCount);
-    const min = twosMin(bitCount);
+    let v = ((vSigned % span) + span) % span;
-    const max = twosMax(bitCount);
-    const span = pow2Big(bitCount); // 2^n
-
-    let v = vSigned;
-
-    // wrap using modular arithmetic on signed domain
-    // Convert to unsigned representative: v mod 2^n
-    v = ((v % span) + span) % span;
-
     unsignedBigIntToBits(v);
-    // labels/denary will show signed later
-    // (No further action needed here)
   }
 
   function formatBinaryGrouped() {
-    // MSB..LSB with a space every 4 bits (matches your screenshot 0000 0000)
     let s = "";
     for (let i = bitCount - 1; i >= 0; i--) {
       s += bits[i] ? "1" : "0";
@@ -126,11 +110,9 @@
 
   function updateModeHint() {
     if (!modeHint) return;
-    if (isTwosMode()) {
+    modeHint.textContent = isTwosMode()
-      modeHint.textContent = "Tip: In two’s complement, the left-most bit (MSB) represents a negative value.";
+      ? "Tip: In two’s complement, the left-most bit (MSB) represents a negative value."
-    } else {
+      : "Tip: In unsigned binary, all bits represent positive values.";
-      modeHint.textContent = "Tip: In unsigned binary, all bits represent positive values.";
-    }
   }
 
   /* -----------------------------
@@ -140,28 +122,15 @@
     bitCount = clampInt(count, 1, 64);
     if (bitsInput) bitsInput.value = String(bitCount);
 
-    // reset bits array size, preserve existing LSBs where possible
     const oldBits = bits.slice();
     bits = new Array(bitCount).fill(false);
     for (let i = 0; i < Math.min(oldBits.length, bitCount); i++) bits[i] = oldBits[i];
 
     bitsGrid.innerHTML = "";
 
-    // If less than 8 bits, centre nicely using your CSS helper
-    bitsGrid.classList.toggle("bitsFew", bitCount < 8);
-    if (bitCount < 8) {
-      bitsGrid.style.setProperty("--cols", String(bitCount));
-    } else {
-      bitsGrid.style.removeProperty("--cols");
-    }
-
-    // Render MSB..LSB left-to-right
     for (let i = bitCount - 1; i >= 0; i--) {
       const bitEl = document.createElement("div");
       bitEl.className = "bit";
-
-      // IMPORTANT: We render the bulb as an emoji with NO circle/ring.
-      // We do not rely on the .bulb CSS ring/background at all.
       bitEl.innerHTML = `
         <div class="bulb" id="bulb-${i}" aria-hidden="true">💡</div>
         <div class="bitVal" id="bitLabel-${i}"></div>
@@ -170,11 +139,9 @@
           <span class="slider"></span>
         </label>
       `;
-
       bitsGrid.appendChild(bitEl);
     }
 
-    // Hook switches
     bitsGrid.querySelectorAll('input[type="checkbox"]').forEach((input) => {
       input.addEventListener("change", () => {
         const i = Number(input.dataset.index);
@@ -183,42 +150,20 @@
       });
     });
 
-    // Force the bulb to be "just the emoji" (removes the circle even if CSS adds it)
-    for (let i = 0; i < bitCount; i++) {
-      const bulb = document.getElementById(`bulb-${i}`);
-      if (!bulb) continue;
-
-      // Strip the ring/circle coming from CSS
-      bulb.style.width = "auto";
-      bulb.style.height = "auto";
-      bulb.style.border = "none";
-      bulb.style.background = "transparent";
-      bulb.style.borderRadius = "0";
-      bulb.style.boxShadow = "none";
-      bulb.style.opacity = "0.45";
-      bulb.style.fontSize = "26px";
-      bulb.style.lineHeight = "1";
-      bulb.style.display = "flex";
-      bulb.style.alignItems = "center";
-      bulb.style.justifyContent = "center";
-      bulb.style.filter = "grayscale(1)";
-      bulb.textContent = "💡";
-    }
-
     updateUI();
   }
 
   /* -----------------------------
-     UI UPDATE (READOUT + LABELS + BULBS + SWITCHES)
+     UI UPDATE
   ----------------------------- */
   function updateBitLabels() {
-    // Show weights under each bit.
-    // Unsigned: 2^i
-    // Two's: MSB is -2^(n-1), others are 2^i
     for (let i = 0; i < bitCount; i++) {
       const label = document.getElementById(`bitLabel-${i}`);
       if (!label) continue;
 
+      // Keep label on ONE LINE (no wrapping)
+      label.style.whiteSpace = "nowrap";
+
       if (isTwosMode() && i === bitCount - 1) {
         label.textContent = `-${pow2Big(bitCount - 1).toString()}`;
       } else {
@@ -235,37 +180,16 @@
   }
 
   function updateBulbs() {
-    // Bulbs should ALWAYS reflect bits, regardless of mode.
     for (let i = 0; i < bitCount; i++) {
       const bulb = document.getElementById(`bulb-${i}`);
       if (!bulb) continue;
-
+      bulb.classList.toggle("on", bits[i] === true);
-      const on = bits[i] === true;
-
-      // Make it look "lit" when on (no circle, just glow)
-      if (on) {
-        bulb.style.opacity = "1";
-        bulb.style.filter = "grayscale(0)";
-        bulb.style.textShadow = "0 0 14px rgba(255,216,107,.75), 0 0 26px rgba(255,216,107,.45)";
-      } else {
-        bulb.style.opacity = "0.45";
-        bulb.style.filter = "grayscale(1)";
-        bulb.style.textShadow = "none";
-      }
     }
   }
 
   function updateReadout() {
     if (!denaryEl || !binaryEl) return;
-
+    denaryEl.textContent = (isTwosMode() ? bitsToSignedBigIntTwos() : bitsToUnsignedBigInt()).toString();
-    if (isTwosMode()) {
-      const signed = bitsToSignedBigIntTwos();
-      denaryEl.textContent = signed.toString();
-    } else {
-      const unsigned = bitsToUnsignedBigInt();
-      denaryEl.textContent = unsigned.toString();
-    }
-
     binaryEl.textContent = formatBinaryGrouped();
   }
 
@@ -278,36 +202,26 @@
   }
 
   /* -----------------------------
-     SET FROM BINARY STRING
+     INPUT SETTERS
   ----------------------------- */
   function setFromBinaryString(binStr) {
     const clean = String(binStr ?? "").replace(/\s+/g, "");
     if (!/^[01]+$/.test(clean)) return false;
-
-    // Use rightmost bitCount bits; left pad with 0
     const padded = clean.slice(-bitCount).padStart(bitCount, "0");
-
     for (let i = 0; i < bitCount; i++) {
-      // padded is MSB..LSB, bits[] is LSB..MSB
       const charFromRight = padded[padded.length - 1 - i];
       bits[i] = charFromRight === "1";
     }
-
     updateUI();
     return true;
   }
 
-  /* -----------------------------
-     SET FROM DENARY INPUT
-  ----------------------------- */
   function setFromDenaryInput(vStr) {
     const raw = String(vStr ?? "").trim();
     if (!raw) return false;
 
-    // BigInt parse (supports negatives)
     let v;
     try {
-      // Allow normal integers only
       if (!/^-?\d+$/.test(raw)) return false;
       v = BigInt(raw);
     } catch {
@@ -315,17 +229,13 @@
     }
 
     if (isTwosMode()) {
-      // Clamp to representable range
       const min = twosMin(bitCount);
       const max = twosMax(bitCount);
       if (v < min || v > max) return false;
-
       signedBigIntToBitsTwos(v);
     } else {
-      // Unsigned only
       if (v < 0n) return false;
       if (v > unsignedMaxValue(bitCount)) return false;
-
       unsignedBigIntToBits(v);
     }
 
@@ -337,20 +247,19 @@
      SHIFTS
   ----------------------------- */
   function shiftLeft() {
-    // logical left shift: bits move to higher index; LSB becomes 0
+    for (let i = bitCount - 1; i >= 1; i--) bits[i] = bits[i - 1];
-    for (let i = bitCount - 1; i >= 1; i--) {
-      bits[i] = bits[i - 1];
-    }
     bits[0] = false;
     updateUI();
   }
 
   function shiftRight() {
-    // logical right shift: bits move to lower index; MSB becomes 0
+    // Unsigned: logical right shift (MSB becomes 0)
-    for (let i = 0; i < bitCount - 1; i++) {
+    // Two's complement: arithmetic right shift (MSB preserved)
-      bits[i] = bits[i + 1];
+    const msb = bits[bitCount - 1];
-    }
+
-    bits[bitCount - 1] = false;
+    for (let i = 0; i < bitCount - 1; i++) bits[i] = bits[i + 1];
+
+    bits[bitCount - 1] = isTwosMode() ? msb : false;
     updateUI();
   }
 
@@ -367,7 +276,7 @@
       const min = twosMin(bitCount);
       const max = twosMax(bitCount);
       let v = bitsToSignedBigIntTwos() + 1n;
-      if (v > max) v = min; // wrap
+      if (v > max) v = min;
       signedBigIntToBitsTwos(v);
     } else {
       const span = unsignedMaxExclusive(bitCount);
@@ -382,7 +291,7 @@
       const min = twosMin(bitCount);
       const max = twosMax(bitCount);
       let v = bitsToSignedBigIntTwos() - 1n;
-      if (v < min) v = max; // wrap
+      if (v < min) v = max;
       signedBigIntToBitsTwos(v);
     } else {
       const span = unsignedMaxExclusive(bitCount);
@@ -393,26 +302,21 @@
   }
 
   /* -----------------------------
-     RANDOM (FIXED: NO BigInt->Number Math.min)
+     RANDOM (with running pulse + longer run)
   ----------------------------- */
   function cryptoRandomBigInt(maxExclusive) {
-    // returns 0 <= x < maxExclusive
     if (maxExclusive <= 0n) return 0n;
 
     const bitLen = maxExclusive.toString(2).length;
     const byteLen = Math.ceil(bitLen / 8);
 
-    // Rejection sampling
     while (true) {
       const bytes = new Uint8Array(byteLen);
       crypto.getRandomValues(bytes);
 
       let x = 0n;
-      for (const b of bytes) {
+      for (const b of bytes) x = (x << 8n) | BigInt(b);
-        x = (x << 8n) | BigInt(b);
-      }
 
-      // mask down to bitLen to reduce rejections slightly
       const extraBits = BigInt(byteLen * 8 - bitLen);
       if (extraBits > 0n) x = x >> extraBits;
 
@@ -421,27 +325,23 @@
   }
 
   function setRandomOnce() {
-    if (isTwosMode()) {
+    const span = unsignedMaxExclusive(bitCount); // 2^n
-      const span = unsignedMaxExclusive(bitCount); // 2^n
+    const u = cryptoRandomBigInt(span);
-      const u = cryptoRandomBigInt(span); // 0..2^n-1
+    unsignedBigIntToBits(u);
-      unsignedBigIntToBits(u);
-    } else {
-      const span = unsignedMaxExclusive(bitCount);
-      const u = cryptoRandomBigInt(span);
-      unsignedBigIntToBits(u);
-    }
     updateUI();
   }
 
   function runRandomBriefly() {
-    // stop any existing run
     if (randomTimer) {
       clearInterval(randomTimer);
       randomTimer = null;
     }
 
+    // pulse while running
+    btnRandom?.classList.add("is-running");
+
     const start = Date.now();
-    const durationMs = 900; // brief run then stop
+    const durationMs = 1125; // 25% longer than 900ms
     const tickMs = 80;
 
     randomTimer = setInterval(() => {
@@ -449,24 +349,31 @@
       if (Date.now() - start >= durationMs) {
         clearInterval(randomTimer);
         randomTimer = null;
+        btnRandom?.classList.remove("is-running");
       }
     }, tickMs);
   }
 
   /* -----------------------------
-     BIT WIDTH CONTROLS
+     BIT WIDTH
   ----------------------------- */
   function setBitWidth(n) {
-    const v = clampInt(n, 1, 64);
+    buildBits(clampInt(n, 1, 64));
-    buildBits(v);
+  }
+
+  /* -----------------------------
+     TOOLBOX VISIBILITY
+  ----------------------------- */
+  function setToolboxVisible(isVisible) {
+    if (!toolboxPanel) return;
+    toolboxPanel.style.display = isVisible ? "flex" : "none";
+    toolboxToggle?.setAttribute("aria-expanded", String(isVisible));
   }
 
   /* -----------------------------
      EVENTS
   ----------------------------- */
-  modeToggle?.addEventListener("change", () => {
+  modeToggle?.addEventListener("change", updateUI);
-    updateUI();
-  });
 
   btnCustomBinary?.addEventListener("click", () => {
     const v = prompt(`Enter binary (spaces allowed). Current width: ${bitCount} bits`);
@@ -477,8 +384,8 @@
   btnCustomDenary?.addEventListener("click", () => {
     const v = prompt(
       isTwosMode()
-        ? `Enter denary (${twosMin(bitCount).toString()} to ${twosMax(bitCount).toString()}):`
+        ? `Enter denary (${twosMin(bitCount)} to ${twosMax(bitCount)}):`
-        : `Enter denary (0 to ${unsignedMaxValue(bitCount).toString()}):`
+        : `Enter denary (0 to ${unsignedMaxValue(bitCount)}):`
     );
     if (v === null) return;
     if (!setFromDenaryInput(v)) alert("Invalid denary for current mode/bit width");
@@ -496,8 +403,11 @@
   btnBitsUp?.addEventListener("click", () => setBitWidth(bitCount + 1));
   btnBitsDown?.addEventListener("click", () => setBitWidth(bitCount - 1));
 
-  bitsInput?.addEventListener("change", () => {
+  bitsInput?.addEventListener("change", () => setBitWidth(Number(bitsInput.value)));
-    setBitWidth(Number(bitsInput.value));
+
+  toolboxToggle?.addEventListener("click", () => {
+    const isOpen = toolboxToggle.getAttribute("aria-expanded") !== "false";
+    setToolboxVisible(!isOpen);
   });
 
   /* -----------------------------
@@ -505,4 +415,5 @@
   ----------------------------- */
   updateModeHint();
   buildBits(bitCount);
+  setToolboxVisible(true);
 })();

src/src/assets/astro.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" width="115" height="48"><path fill="#17191E" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="url(#a)" d="M7.77 36.35C6.4 35.11 6 32.51 6.57 30.62c.99 1.2 2.35 1.57 3.75 1.78 2.18.33 4.31.2 6.33-.78.23-.12.44-.27.7-.42.18.55.23 1.1.17 1.67a4.56 4.56 0 0 1-1.94 3.23c-.43.32-.9.61-1.34.91-1.38.94-1.76 2.03-1.24 3.62l.05.17a3.63 3.63 0 0 1-1.6-1.38 3.87 3.87 0 0 1-.63-2.1c0-.37 0-.74-.05-1.1-.13-.9-.55-1.3-1.33-1.32a1.56 1.56 0 0 0-1.63 1.26c0 .06-.03.12-.05.2Z"/><path fill="#17191E" d="M.02 30.31s4.02-1.95 8.05-1.95l3.04-9.4c.11-.45.44-.76.82-.76.37 0 .7.31.82.76l3.04 9.4c4.77 0 8.05 1.95 8.05 1.95L17 11.71c-.2-.56-.53-.91-.98-.91H7.83c-.44 0-.76.35-.97.9L.02 30.31Zm42.37-5.97c0 1.64-2.05 2.62-4.88 2.62-1.85 0-2.5-.45-2.5-1.41 0-1 .8-1.49 2.65-1.49 1.67 0 3.09.03 4.73.23v.05Zm.03-2.04a21.37 21.37 0 0 0-4.37-.36c-5.32 0-7.82 1.25-7.82 4.18 0 3.04 1.71 4.2 5.68 4.2 3.35 0 5.63-.84 6.46-2.92h.14c-.03.5-.05 1-.05 1.4 0 1.07.18 1.16 1.06 1.16h4.15a16.9 16.9 0 0 1-.36-4c0-1.67.06-2.93.06-4.62 0-3.45-2.07-5.64-8.56-5.64-2.8 0-5.9.48-8.26 1.19.22.93.54 2.83.7 4.06 2.04-.96 4.95-1.37 7.2-1.37 3.11 0 3.97.71 3.97 2.15v.57Zm11.37 3c-.56.07-1.33.07-2.12.07-.83 0-1.6-.03-2.12-.1l-.02.58c0 2.85 1.87 4.52 8.45 4.52 6.2 0 8.2-1.64 8.2-4.55 0-2.74-1.33-4.09-7.2-4.39-4.58-.2-4.99-.7-4.99-1.28 0-.66.59-1 3.65-1 3.18 0 4.03.43 4.03 1.35v.2a46.13 46.13 0 0 1 4.24.03l.02-.55c0-3.36-2.8-4.46-8.2-4.46-6.08 0-8.13 1.49-8.13 4.39 0 2.6 1.64 4.23 7.48 4.48 4.3.14 4.77.62 4.77 1.28 0 .7-.7 1.03-3.71 1.03-3.47 0-4.35-.48-4.35-1.47v-.13Zm19.82-12.05a17.5 17.5 0 0 1-6.24 3.48c.03.84.03 2.4.03 3.24l1.5.02c-.02 1.63-.04 3.6-.04 4.9 0 3.04 1.6 5.32 6.58 5.32 2.1 0 3.5-.23 5.23-.6a43.77 43.77 0 0 1-.46-4.13c-1.03.34-2.34.53-3.78.53-2 0-2.82-.55-2.82-2.13 0-1.37 0-2.65.03-3.84 2.57.02 5.13.07 6.64.11-.02-1.18.03-2.9.1-4.04-2.2.04-4.65.07-6.68.07l.07-2.93h-.16Zm13.46 6.04a767.33 767.33 0 0 1 .07-3.18H82.6c.07 1.96.07 3.98.07 6.92 0 2.95-.03 4.99-.07 6.93h5.18c-.09-1.37-.11-3.68-.11-5.65 0-3.1 1.26-4 4.12-4 1.33 0 2.28.16 3.1.46.03-1.16.26-3.43.4-4.43-.86-.25-1.81-.41-2.96-.41-2.46-.03-4.26.98-5.1 3.38l-.17-.02Zm22.55 3.65c0 2.5-1.8 3.66-4.64 3.66-2.81 0-4.61-1.1-4.61-3.66s1.82-3.52 4.61-3.52c2.82 0 4.64 1.03 4.64 3.52Zm4.71-.11c0-4.96-3.87-7.18-9.35-7.18-5.5 0-9.23 2.22-9.23 7.18 0 4.94 3.49 7.59 9.21 7.59 5.77 0 9.37-2.65 9.37-7.6Z"/><defs><linearGradient id="a" x1="6.33" x2="19.43" y1="40.8" y2="34.6" gradientUnits="userSpaceOnUse"><stop stop-color="#D83333"/><stop offset="1" stop-color="#F041FF"/></linearGradient></defs></svg>

src/src/assets/background.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1440" height="1024" fill="none"><path fill="url(#a)" fill-rule="evenodd" d="M-217.58 475.75c91.82-72.02 225.52-29.38 341.2-44.74C240 415.56 372.33 315.14 466.77 384.9c102.9 76.02 44.74 246.76 90.31 366.31 29.83 78.24 90.48 136.14 129.48 210.23 57.92 109.99 169.67 208.23 155.9 331.77-13.52 121.26-103.42 264.33-224.23 281.37-141.96 20.03-232.72-220.96-374.06-196.99-151.7 25.73-172.68 330.24-325.85 315.72-128.6-12.2-110.9-230.73-128.15-358.76-12.16-90.14 65.87-176.25 44.1-264.57-26.42-107.2-167.12-163.46-176.72-273.45-10.15-116.29 33.01-248.75 124.87-320.79Z" clip-rule="evenodd" style="opacity:.154"/><path fill="url(#b)" fill-rule="evenodd" d="M1103.43 115.43c146.42-19.45 275.33-155.84 413.5-103.59 188.09 71.13 409 212.64 407.06 413.88-1.94 201.25-259.28 278.6-414.96 405.96-130 106.35-240.24 294.39-405.6 265.3-163.7-28.8-161.93-274.12-284.34-386.66-134.95-124.06-436-101.46-445.82-284.6-9.68-180.38 247.41-246.3 413.54-316.9 101.01-42.93 207.83 21.06 316.62 6.61Z" clip-rule="evenodd" style="opacity:.154"/><defs><linearGradient id="b" x1="373" x2="1995.44" y1="1100" y2="118.03" gradientUnits="userSpaceOnUse"><stop stop-color="#D83333"/><stop offset="1" stop-color="#F041FF"/></linearGradient><linearGradient id="a" x1="107.37" x2="1130.66" y1="1993.35" y2="1026.31" gradientUnits="userSpaceOnUse"><stop stop-color="#3245FF"/><stop offset="1" stop-color="#BC52EE"/></linearGradient></defs></svg>

src/src/components/Welcome.astro

@@ -0,0 +1,210 @@
+---
+import astroLogo from '../assets/astro.svg';
+import background from '../assets/background.svg';
+---
+
+<div id="container">
+	<img id="background" src={background.src} alt="" fetchpriority="high" />
+	<main>
+		<section id="hero">
+			<a href="https://astro.build"
+				><img src={astroLogo.src} width="115" height="48" alt="Astro Homepage" /></a
+			>
+			<h1>
+				To get started, open the <code><pre>src/pages</pre></code> directory in your project.
+			</h1>
+			<section id="links">
+				<a class="button" href="https://docs.astro.build">Read our docs</a>
+				<a href="https://astro.build/chat"
+					>Join our Discord <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 127.14 96.36"
+						><path
+							fill="currentColor"
+							d="M107.7 8.07A105.15 105.15 0 0 0 81.47 0a72.06 72.06 0 0 0-3.36 6.83 97.68 97.68 0 0 0-29.11 0A72.37 72.37 0 0 0 45.64 0a105.89 105.89 0 0 0-26.25 8.09C2.79 32.65-1.71 56.6.54 80.21a105.73 105.73 0 0 0 32.17 16.15 77.7 77.7 0 0 0 6.89-11.11 68.42 68.42 0 0 1-10.85-5.18c.91-.66 1.8-1.34 2.66-2a75.57 75.57 0 0 0 64.32 0c.87.71 1.76 1.39 2.66 2a68.68 68.68 0 0 1-10.87 5.19 77 77 0 0 0 6.89 11.1 105.25 105.25 0 0 0 32.19-16.14c2.64-27.38-4.51-51.11-18.9-72.15ZM42.45 65.69C36.18 65.69 31 60 31 53s5-12.74 11.43-12.74S54 46 53.89 53s-5.05 12.69-11.44 12.69Zm42.24 0C78.41 65.69 73.25 60 73.25 53s5-12.74 11.44-12.74S96.23 46 96.12 53s-5.04 12.69-11.43 12.69Z"
+						></path></svg
+					>
+				</a>
+			</section>
+		</section>
+	</main>
+
+	<a href="https://astro.build/blog/astro-5/" id="news" class="box">
+		<svg width="32" height="32" fill="none" xmlns="http://www.w3.org/2000/svg"
+			><path
+				d="M24.667 12c1.333 1.414 2 3.192 2 5.334 0 4.62-4.934 5.7-7.334 12C18.444 28.567 18 27.456 18 26c0-4.642 6.667-7.053 6.667-14Zm-5.334-5.333c1.6 1.65 2.4 3.43 2.4 5.333 0 6.602-8.06 7.59-6.4 17.334C13.111 27.787 12 25.564 12 22.666c0-4.434 7.333-8 7.333-16Zm-6-5.333C15.111 3.555 16 5.556 16 7.333c0 8.333-11.333 10.962-5.333 22-3.488-.774-6-4-6-8 0-8.667 8.666-10 8.666-20Z"
+				fill="#111827"></path></svg
+		>
+		<h2>What's New in Astro 5.0?</h2>
+		<p>
+			From content layers to server islands, click to learn more about the new features and
+			improvements in Astro 5.0
+		</p>
+	</a>
+</div>
+
+<style>
+	#background {
+		position: fixed;
+		top: 0;
+		left: 0;
+		width: 100%;
+		height: 100%;
+		z-index: -1;
+		filter: blur(100px);
+	}
+
+	#container {
+		font-family: Inter, Roboto, 'Helvetica Neue', 'Arial Nova', 'Nimbus Sans', Arial, sans-serif;
+		height: 100%;
+	}
+
+	main {
+		height: 100%;
+		display: flex;
+		justify-content: center;
+	}
+
+	#hero {
+		display: flex;
+		align-items: start;
+		flex-direction: column;
+		justify-content: center;
+		padding: 16px;
+	}
+
+	h1 {
+		font-size: 22px;
+		margin-top: 0.25em;
+	}
+
+	#links {
+		display: flex;
+		gap: 16px;
+	}
+
+	#links a {
+		display: flex;
+		align-items: center;
+		padding: 10px 12px;
+		color: #111827;
+		text-decoration: none;
+		transition: color 0.2s;
+	}
+
+	#links a:hover {
+		color: rgb(78, 80, 86);
+	}
+
+	#links a svg {
+		height: 1em;
+		margin-left: 8px;
+	}
+
+	#links a.button {
+		color: white;
+		background: linear-gradient(83.21deg, #3245ff 0%, #bc52ee 100%);
+		box-shadow:
+			inset 0 0 0 1px rgba(255, 255, 255, 0.12),
+			inset 0 -2px 0 rgba(0, 0, 0, 0.24);
+		border-radius: 10px;
+	}
+
+	#links a.button:hover {
+		color: rgb(230, 230, 230);
+		box-shadow: none;
+	}
+
+	pre {
+		font-family:
+			ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, 'DejaVu Sans Mono',
+			monospace;
+		font-weight: normal;
+		background: linear-gradient(14deg, #d83333 0%, #f041ff 100%);
+		-webkit-background-clip: text;
+		-webkit-text-fill-color: transparent;
+		background-clip: text;
+		margin: 0;
+	}
+
+	h2 {
+		margin: 0 0 1em;
+		font-weight: normal;
+		color: #111827;
+		font-size: 20px;
+	}
+
+	p {
+		color: #4b5563;
+		font-size: 16px;
+		line-height: 24px;
+		letter-spacing: -0.006em;
+		margin: 0;
+	}
+
+	code {
+		display: inline-block;
+		background:
+			linear-gradient(66.77deg, #f3cddd 0%, #f5cee7 100%) padding-box,
+			linear-gradient(155deg, #d83333 0%, #f041ff 18%, #f5cee7 45%) border-box;
+		border-radius: 8px;
+		border: 1px solid transparent;
+		padding: 6px 8px;
+	}
+
+	.box {
+		padding: 16px;
+		background: rgba(255, 255, 255, 1);
+		border-radius: 16px;
+		border: 1px solid white;
+	}
+
+	#news {
+		position: absolute;
+		bottom: 16px;
+		right: 16px;
+		max-width: 300px;
+		text-decoration: none;
+		transition: background 0.2s;
+		backdrop-filter: blur(50px);
+	}
+
+	#news:hover {
+		background: rgba(255, 255, 255, 0.55);
+	}
+
+	@media screen and (max-height: 368px) {
+		#news {
+			display: none;
+		}
+	}
+
+	@media screen and (max-width: 768px) {
+		#container {
+			display: flex;
+			flex-direction: column;
+		}
+
+		#hero {
+			display: block;
+			padding-top: 10%;
+		}
+
+		#links {
+			flex-wrap: wrap;
+		}
+
+		#links a.button {
+			padding: 14px 18px;
+		}
+
+		#news {
+			right: 16px;
+			left: 16px;
+			bottom: 2.5rem;
+			max-width: 100%;
+		}
+
+		h1 {
+			line-height: 1.5;
+		}
+	}
+</style>

src/src/components/simulators/HexSimulator.astro

@@ -0,0 +1,104 @@
+---
+import "./hex/hex-simulator.css";
+---
+
+<section class="hex-sim" data-hex-sim>
+  <div class="hex-main">
+    <div class="hex-readout">
+      <div class="hex-label">DENARY</div>
+      <div class="hex-number" data-out="denary">0</div>
+
+      <div class="hex-label hex-mt">HEXADECIMAL</div>
+      <div class="hex-number hex-number--small" data-out="hex">00</div>
+
+      <div class="hex-label hex-mt">BINARY</div>
+      <div class="hex-number hex-number--tiny" data-out="bin">0000 0000</div>
+    </div>
+
+    <div class="hex-divider"></div>
+
+    <div class="hex-digits" data-out="digitsRow"></div>
+  </div>
+
+  <!-- Toolbox button -->
+  <button class="hex-toolbox-btn" type="button" data-action="toggleToolbox" aria-controls="hex-toolbox" aria-expanded="true">
+    <span class="hex-toolbox-icon" aria-hidden="true">
+      <!-- toolbox icon -->
+      <svg viewBox="0 0 24 24" width="18" height="18" fill="none">
+        <path d="M9 7V6a3 3 0 0 1 6 0v1" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+        <path d="M4 9h16l-1.3 10.4A2 2 0 0 1 16.7 21H7.3a2 2 0 0 1-1.98-1.6L4 9Z" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>
+        <path d="M10 13h4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+      </svg>
+    </span>
+    TOOLBOX
+  </button>
+
+  <!-- Toolbox panel -->
+  <aside class="hex-toolbox is-open" id="hex-toolbox" data-out="toolbox">
+    <div class="hex-panel">
+      <div class="hex-panel-title">SETTINGS</div>
+
+      <div class="hex-setting-title">HEX DIGIT WIDTH</div>
+
+      <div class="hex-width">
+        <button class="hex-btn hex-btn--square" type="button" data-action="digitsMinus">−</button>
+
+        <div class="hex-width-readout">
+          <div class="hex-width-label">DIGITS</div>
+          <div class="hex-width-number" data-out="digitsCount">2</div>
+        </div>
+
+        <button class="hex-btn hex-btn--square" type="button" data-action="digitsPlus">+</button>
+      </div>
+
+      <div class="hex-hint" data-out="bitsHint">= 8 bits</div>
+    </div>
+
+    <div class="hex-panel">
+      <div class="hex-panel-title">CUSTOM NUMBER</div>
+
+      <div class="hex-grid-2">
+        <button class="hex-btn hex-btn--green" type="button" data-action="customHex">Custom Hexadecimal</button>
+        <button class="hex-btn hex-btn--green" type="button" data-action="customDenary">Custom Denary</button>
+      </div>
+
+      <!-- Custom Binary + Random on SAME row, same size -->
+      <div class="hex-grid-2 hex-mt-sm">
+        <button class="hex-btn hex-btn--green" type="button" data-action="customBinary">Custom Binary</button>
+        <button class="hex-btn hex-btn--wide hex-btn--random" type="button" data-action="random" data-random>Random</button>
+      </div>
+
+      <div class="hex-tiny-note">RANDOM RUNS BRIEFLY THEN STOPS AUTOMATICALLY.</div>
+    </div>
+
+    <div class="hex-panel">
+      <div class="hex-panel-title">TOOLS</div>
+
+      <div class="hex-tools-top">
+        <button class="hex-btn hex-btn--square hex-btn--red" type="button" data-action="decrement" title="Decrement">▼</button>
+        <button class="hex-btn hex-btn--square hex-btn--green2" type="button" data-action="increment" title="Increment">▲</button>
+      </div>
+
+      <button class="hex-btn hex-btn--wide hex-btn--reset" type="button" data-action="reset">Reset</button>
+    </div>
+  </aside>
+
+  <!-- Custom number dialog -->
+  <dialog class="hex-dialog" data-out="dialog">
+    <div class="hex-dialog-card">
+      <div class="hex-dialog-title" data-out="dialogTitle">Custom</div>
+
+      <input class="hex-dialog-input hex-font-mono" data-out="dialogInput" />
+
+      <div class="hex-dialog-hint" data-out="dialogHint"></div>
+      <div class="hex-dialog-error" data-out="dialogError" aria-live="polite"></div>
+
+      <div class="hex-dialog-actions">
+        <button class="hex-btn" type="button" data-action="dialogCancel">Cancel</button>
+        <button class="hex-btn hex-btn--green" type="button" data-action="dialogApply">Apply</button>
+      </div>
+    </div>
+  </dialog>
+
+  <script type="module" src="/src/components/simulators/hex/hex-simulator.ts"></script>
+</section>

src/src/components/simulators/hex/hex-simulator.css

@@ -0,0 +1,346 @@
+/* ================= Fonts to match Binary ================= */
+/* Adjust paths to wherever you store fonts (commonly /public/fonts/...) */
+@font-face {
+  font-family: "DSEG7Classic";
+  src: url("/fonts/DSEG7Classic-Regular.woff") format("woff"),
+       url("/fonts/DSEG7Classic-Regular.ttf") format("truetype");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: "SevenSegment";
+  src: url("/fonts/Seven-Segment.woff2") format("woff2"),
+       url("/fonts/Seven-Segment.woff") format("woff");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+.hex-sim {
+  min-height: 100vh;
+  background: #14151c;
+  color: #e7e8ee;
+  padding: 28px;
+}
+
+.hex-font-number { font-family: "DSEG7Classic", ui-monospace, monospace; }
+.hex-font-mono   { font-family: "SevenSegment", ui-monospace, monospace; }
+
+.hex-main { max-width: 1200px; margin: 0 auto; width: 100%; padding-top: 40px; }
+
+.hex-readout { text-align: center; }
+.hex-label {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  font-size: 12px;
+  letter-spacing: 2px;
+  opacity: 0.7;
+}
+.hex-mt { margin-top: 12px; }
+
+.hex-number {
+  font-family: "DSEG7Classic", ui-monospace, monospace;
+  font-size: 76px;
+  line-height: 1;
+  font-weight: 400;
+  color: #46ff8a;
+  text-shadow: 0 0 18px rgba(70,255,138,0.18);
+}
+.hex-number--small { font-size: 64px; }
+.hex-number--tiny  { font-size: 54px; letter-spacing: 6px; }
+
+.hex-divider {
+  margin: 26px auto 18px;
+  height: 1px;
+  width: min(760px, 90%);
+  background: rgba(255,255,255,0.10);
+}
+
+/* ================= Main digit columns ================= */
+.hex-digits {
+  margin-top: 18px;
+  display: flex;
+  justify-content: center;
+  gap: 18px;
+  flex-wrap: wrap;
+}
+
+.hex-digit-col {
+  width: 160px;
+  border-radius: 18px;
+  background: rgba(255,255,255,0.03);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 12px;
+  display: grid;
+  gap: 10px;
+  justify-items: center;
+}
+
+.hex-digit-controls {
+  width: 100%;
+  display: flex;
+  justify-content: center;
+  gap: 10px;
+}
+
+.hex-digit-char {
+  font-size: 64px;
+  line-height: 1;
+  color: #46ff8a;
+  text-shadow: 0 0 18px rgba(70,255,138,0.18);
+}
+
+.hex-digit-place {
+  font-family: "SevenSegment", ui-monospace, monospace;
+  opacity: 0.65;
+  font-size: 14px;
+  letter-spacing: 1px;
+}
+
+/* ================= Bulbs (brightness changes) ================= */
+.hex-bulbs {
+  width: 100%;
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 10px;
+  align-items: end;
+}
+
+.hex-bulb {
+  display: grid;
+  justify-items: center;
+  gap: 6px;
+  opacity: 0.35;
+  filter: grayscale(30%);
+  transition: opacity 160ms ease, filter 160ms ease;
+}
+
+.hex-bulb .hex-bulb-cap {
+  width: 18px;
+  height: 18px;
+  border-radius: 999px;
+  background: rgba(255,255,255,0.22);
+  border: 1px solid rgba(255,255,255,0.14);
+}
+
+.hex-bulb .hex-bulb-glow {
+  width: 18px;
+  height: 10px;
+  border-radius: 999px;
+  background: rgba(70,255,138,0.0);
+  box-shadow: 0 0 0 rgba(70,255,138,0.0);
+  transition: background 160ms ease, box-shadow 160ms ease;
+}
+
+.hex-bulb .hex-bulb-label {
+  font-family: "SevenSegment", ui-monospace, monospace;
+  font-size: 12px;
+  opacity: 0.8;
+}
+
+.hex-bulb.is-on {
+  opacity: 1;
+  filter: none;
+}
+.hex-bulb.is-on .hex-bulb-cap {
+  background: rgba(255,255,255,0.35);
+}
+.hex-bulb.is-on .hex-bulb-glow {
+  background: rgba(70,255,138,0.25);
+  box-shadow: 0 0 18px rgba(70,255,138,0.35);
+}
+
+/* ================= Buttons (toolbox style reused everywhere) ================= */
+.hex-btn {
+  padding: 10px 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(255,255,255,0.06);
+  color: #e7e8ee;
+  font-weight: 800;
+  cursor: pointer;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+}
+.hex-btn:hover { background: rgba(255,255,255,0.10); }
+
+.hex-btn--square {
+  width: 48px;
+  height: 48px;
+  padding: 0;
+  display: grid;
+  place-items: center;
+  font-size: 18px;
+}
+
+.hex-btn--wide { width: 100%; }
+
+.hex-btn--green {
+  background: rgba(46, 200, 120, 0.18);
+  border-color: rgba(46,200,120,0.35);
+}
+.hex-btn--green:hover { background: rgba(46, 200, 120, 0.26); }
+
+.hex-btn--green2 {
+  background: rgba(46, 200, 120, 0.18);
+  border-color: rgba(46,200,120,0.35);
+}
+
+.hex-btn--red {
+  background: rgba(220, 60, 70, 0.18);
+  border-color: rgba(220,60,70,0.35);
+}
+
+/* Random = green pulse while running */
+.hex-btn--random.is-running {
+  border-color: rgba(80, 255, 160, 0.55);
+  background: rgba(46, 200, 120, 0.22);
+  box-shadow: 0 0 18px rgba(80, 255, 160, 0.35);
+  animation: hexPulseGreen 900ms ease-in-out infinite;
+}
+@keyframes hexPulseGreen {
+  0%, 100% { box-shadow: 0 0 14px rgba(80, 255, 160, 0.25); }
+  50% { box-shadow: 0 0 26px rgba(80, 255, 160, 0.45); }
+}
+
+/* Reset = red background + pulse on hover */
+.hex-btn--reset:hover {
+  background: rgba(220, 60, 70, 0.28);
+  border-color: rgba(255, 80, 90, 0.55);
+  animation: hexPulseRed 900ms ease-in-out infinite;
+}
+@keyframes hexPulseRed {
+  0%, 100% { box-shadow: 0 0 12px rgba(255, 80, 90, 0.20); }
+  50% { box-shadow: 0 0 22px rgba(255, 80, 90, 0.38); }
+}
+
+/* ================= Toolbox button + panel (slide) ================= */
+.hex-toolbox-btn {
+  position: fixed;
+  top: 88px;
+  right: 28px;
+  z-index: 30;
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px 16px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(255,255,255,0.06);
+  color: #e7e8ee;
+  font-weight: 800;
+  letter-spacing: 1px;
+  cursor: pointer;
+}
+
+.hex-toolbox-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 18px;
+  height: 18px;
+  color: #ff4fa6;
+  filter: drop-shadow(0 0 10px rgba(255,79,166,0.35));
+}
+
+.hex-toolbox {
+  position: fixed;
+  top: 140px;
+  right: 28px;
+  width: 340px;
+  display: grid;
+  gap: 14px;
+  z-index: 25;
+
+  transform: translateX(0);
+  opacity: 1;
+  transition: transform 220ms ease, opacity 220ms ease;
+}
+.hex-toolbox:not(.is-open) {
+  transform: translateX(380px);
+  opacity: 0;
+  pointer-events: none;
+}
+
+.hex-panel {
+  border-radius: 16px;
+  background: rgba(255,255,255,0.04);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 14px;
+}
+.hex-panel-title {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  font-size: 12px;
+  letter-spacing: 2px;
+  opacity: 0.7;
+  margin-bottom: 10px;
+}
+
+.hex-setting-title { font-weight: 900; opacity: 0.9; margin-bottom: 10px; }
+
+.hex-width {
+  display: grid;
+  grid-template-columns: 48px 1fr 48px;
+  gap: 10px;
+  align-items: center;
+}
+.hex-width-readout {
+  border-radius: 14px;
+  background: rgba(0,0,0,0.22);
+  border: 1px solid rgba(255,255,255,0.10);
+  padding: 10px 12px;
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+}
+.hex-width-label {
+  font-family: "SevenSegment", ui-sans-serif, system-ui;
+  opacity: 0.7;
+  font-weight: 800;
+  letter-spacing: 1px;
+  font-size: 12px;
+}
+.hex-width-number { font-size: 30px; font-weight: 900; color: #46ff8a; }
+
+.hex-hint { margin-top: 8px; opacity: 0.65; font-size: 12px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+.hex-grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
+.hex-mt-sm { margin-top: 10px; }
+
+.hex-tools-top { display: flex; gap: 10px; justify-content: center; margin-bottom: 10px; }
+.hex-tiny-note { margin-top: 8px; font-size: 11px; opacity: 0.6; letter-spacing: 1px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+/* ================= Dialog ================= */
+.hex-dialog { border: none; padding: 0; background: transparent; }
+.hex-dialog::backdrop { background: rgba(0,0,0,0.55); }
+
+.hex-dialog-card {
+  width: min(560px, 92vw);
+  border-radius: 18px;
+  background: #1a1b24;
+  border: 1px solid rgba(255,255,255,0.12);
+  padding: 16px;
+  color: #e7e8ee;
+}
+
+.hex-dialog-title { font-weight: 900; letter-spacing: 1px; margin-bottom: 10px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+
+.hex-dialog-input {
+  width: 100%;
+  padding: 12px 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,0.14);
+  background: rgba(0,0,0,0.25);
+  color: #e7e8ee;
+  font-size: 18px;
+}
+
+.hex-dialog-hint { margin-top: 10px; opacity: 0.7; font-size: 13px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+.hex-dialog-error { margin-top: 8px; font-size: 13px; color: #ff6b6b; min-height: 18px; font-family: "SevenSegment", ui-sans-serif, system-ui; }
+.hex-dialog-actions { margin-top: 14px; display: flex; gap: 10px; justify-content: flex-end; }
+
+@media (max-width: 900px) {
+  .hex-toolbox { width: min(360px, 92vw); right: 16px; }
+  .hex-toolbox-btn { right: 16px; }
+  .hex-number { font-size: 60px; }
+  .hex-number--tiny { font-size: 40px; letter-spacing: 4px; }
+}

src/src/components/simulators/hex/hex-simulator.ts

@@ -0,0 +1,232 @@
+type DialogMode = "hex" | "den" | "bin";
+
+const root = document.querySelector<HTMLElement>("[data-hex-sim]");
+if (!root) throw new Error("Hex simulator root not found");
+
+const outDen = root.querySelector<HTMLElement>('[data-out="denary"]')!;
+const outHex = root.querySelector<HTMLElement>('[data-out="hex"]')!;
+const outBin = root.querySelector<HTMLElement>('[data-out="bin"]')!;
+const outDigitsRow = root.querySelector<HTMLElement>('[data-out="digitsRow"]')!;
+
+const toolbox = root.querySelector<HTMLElement>('[data-out="toolbox"]')!;
+const toolboxBtn = root.querySelector<HTMLButtonElement>('[data-action="toggleToolbox"]')!;
+const digitsCount = root.querySelector<HTMLElement>('[data-out="digitsCount"]')!;
+const bitsHint = root.querySelector<HTMLElement>('[data-out="bitsHint"]')!;
+const randomBtn = root.querySelector<HTMLButtonElement>("[data-random]")!;
+
+const dialog = root.querySelector<HTMLDialogElement>('[data-out="dialog"]')!;
+const dialogTitle = root.querySelector<HTMLElement>('[data-out="dialogTitle"]')!;
+const dialogInput = root.querySelector<HTMLInputElement>('[data-out="dialogInput"]')!;
+const dialogHint = root.querySelector<HTMLElement>('[data-out="dialogHint"]')!;
+const dialogError = root.querySelector<HTMLElement>('[data-out="dialogError"]')!;
+
+let digits = 2;        // 1..8
+let value = 0;         // unsigned denary
+let randomTimer: number | null = null;
+let dialogMode: DialogMode | null = null;
+
+const clamp = (n: number, min: number, max: number) => Math.min(max, Math.max(min, n));
+const maxForDigits = (d: number) => (16 ** d) - 1;
+
+const padHex = (n: number, d: number) => n.toString(16).toUpperCase().padStart(d, "0");
+const padBin = (n: number, b: number) => n.toString(2).padStart(b, "0");
+const groupBin = (b: string) => b.replace(/(.{4})/g, "$1 ").trim();
+
+function stopRandom(): void {
+  if (randomTimer !== null) window.clearInterval(randomTimer);
+  randomTimer = null;
+  randomBtn.classList.remove("is-running");
+}
+
+function startRandom(): void {
+  stopRandom();
+  const max = maxForDigits(digits);
+  const start = Date.now();
+
+  randomBtn.classList.add("is-running");
+
+  randomTimer = window.setInterval(() => {
+    value = Math.floor(Math.random() * (max + 1));
+    render();
+    if (Date.now() - start > 1600) stopRandom();
+  }, 90);
+}
+
+function render(): void {
+  const bits = digits * 4;
+
+  digitsCount.textContent = String(digits);
+  bitsHint.textContent = `= ${bits} bits`;
+
+  outDen.textContent = String(value);
+  outHex.textContent = padHex(value, digits);
+  outBin.textContent = groupBin(padBin(value, bits));
+
+  renderDigitsRow();
+}
+
+function renderDigitsRow(): void {
+  const hex = padHex(value, digits);
+  outDigitsRow.innerHTML = "";
+
+  for (let i = 0; i < digits; i++) {
+    const pow = digits - 1 - i;
+    const placeValue = 16 ** pow;
+
+    const digitChar = hex[i];
+    const digitVal = parseInt(digitChar, 16);
+    const nibbleBits = [(digitVal >> 3) & 1, (digitVal >> 2) & 1, (digitVal >> 1) & 1, digitVal & 1]; // 8 4 2 1
+
+    const col = document.createElement("div");
+    col.className = "hex-digit-col";
+    col.innerHTML = `
+      <div class="hex-digit-controls">
+        <button class="hex-btn hex-btn--square hex-btn--green2" type="button" data-action="digitUp" data-i="${i}" title="Increase">▲</button>
+        <button class="hex-btn hex-btn--square hex-btn--red" type="button" data-action="digitDown" data-i="${i}" title="Decrease">▼</button>
+      </div>
+
+      <div class="hex-digit-char hex-font-number">${digitChar}</div>
+
+      <!-- bulbs: brightness changes based on nibble bits -->
+      <div class="hex-bulbs" aria-label="Nibble bits">
+        ${[8,4,2,1].map((w, idx) => {
+          const on = nibbleBits[idx] === 1;
+          return `
+            <div class="hex-bulb ${on ? "is-on" : ""}">
+              <div class="hex-bulb-cap"></div>
+              <div class="hex-bulb-glow"></div>
+              <div class="hex-bulb-label">${w}</div>
+            </div>
+          `;
+        }).join("")}
+      </div>
+
+      <div class="hex-digit-place">${placeValue}</div>
+    `;
+    outDigitsRow.appendChild(col);
+  }
+}
+
+function openDialog(mode: DialogMode): void {
+  stopRandom();
+  dialogMode = mode;
+
+  dialogError.textContent = "";
+  dialogInput.value = "";
+
+  if (mode === "hex") {
+    dialogTitle.textContent = "Custom Hexadecimal";
+    dialogHint.textContent = `Enter 1–${digits} hex digit(s) (0–9, A–F).`;
+    dialogInput.placeholder = "A1";
+    dialogInput.inputMode = "text";
+  } else if (mode === "den") {
+    dialogTitle.textContent = "Custom Denary";
+    dialogHint.textContent = `Enter a whole number from 0 to ${maxForDigits(digits)}.`;
+    dialogInput.placeholder = "42";
+    dialogInput.inputMode = "numeric";
+  } else {
+    dialogTitle.textContent = "Custom Binary";
+    dialogHint.textContent = `Enter up to ${digits * 4} bit(s) using 0 and 1.`;
+    dialogInput.placeholder = "00101010";
+    dialogInput.inputMode = "text";
+  }
+
+  dialog.showModal();
+  window.setTimeout(() => dialogInput.focus(), 0);
+}
+
+function closeDialog(): void {
+  dialogMode = null;
+  dialogError.textContent = "";
+  if (dialog.open) dialog.close();
+}
+
+function applyDialog(): void {
+  const raw = (dialogInput.value || "").trim();
+  if (!dialogMode) return closeDialog();
+  if (raw.length === 0) return closeDialog();
+
+  const max = maxForDigits(digits);
+  const bits = digits * 4;
+
+  if (dialogMode === "hex") {
+    const v = raw.toUpperCase();
+    if (!/^[0-9A-F]+$/.test(v)) { dialogError.textContent = "Hex must use 0–9 and A–F only."; return; }
+    if (v.length > digits) { dialogError.textContent = `Max length is ${digits} hex digit(s).`; return; }
+    value = clamp(parseInt(v, 16), 0, max);
+    render();
+    return closeDialog();
+  }
+
+  if (dialogMode === "den") {
+    if (!/^\d+$/.test(raw)) { dialogError.textContent = "Denary must be whole numbers only."; return; }
+    const n = Number(raw);
+    if (!Number.isFinite(n)) { dialogError.textContent = "Invalid number."; return; }
+    value = clamp(n, 0, max);
+    render();
+    return closeDialog();
+  }
+
+  // bin
+  if (!/^[01]+$/.test(raw)) { dialogError.textContent = "Binary must use 0 and 1 only."; return; }
+  if (raw.length > bits) { dialogError.textContent = `Max length is ${bits} bit(s).`; return; }
+  value = clamp(parseInt(raw, 2), 0, max);
+  render();
+  return closeDialog();
+}
+
+function applyDigitDelta(i: number, delta: number): void {
+  stopRandom();
+  const hexArr = padHex(value, digits).split("");
+  let v = parseInt(hexArr[i], 16);
+  v = (v + delta) % 16;
+  if (v < 0) v += 16;
+  hexArr[i] = v.toString(16).toUpperCase();
+  value = clamp(parseInt(hexArr.join(""), 16), 0, maxForDigits(digits));
+  render();
+}
+
+// dialog cancel / backdrop
+dialog.addEventListener("cancel", (e) => { e.preventDefault(); closeDialog(); });
+dialog.addEventListener("click", (e) => {
+  const card = dialog.querySelector(".hex-dialog-card");
+  if (card && !card.contains(e.target as Node)) closeDialog();
+});
+dialogInput.addEventListener("keydown", (e) => {
+  if (e.key === "Enter") applyDialog();
+  if (e.key === "Escape") closeDialog();
+});
+
+// main click handler
+root.addEventListener("click", (e) => {
+  const btn = (e.target as HTMLElement).closest<HTMLElement>("[data-action]");
+  if (!btn) return;
+  const action = btn.getAttribute("data-action")!;
+
+  if (action === "toggleToolbox") {
+    toolbox.classList.toggle("is-open");
+    toolboxBtn.setAttribute("aria-expanded", toolbox.classList.contains("is-open") ? "true" : "false");
+    return;
+  }
+
+  if (action === "digitsMinus") { digits = clamp(digits - 1, 1, 8); value = clamp(value, 0, maxForDigits(digits)); return render(); }
+  if (action === "digitsPlus")  { digits = clamp(digits + 1, 1, 8); value = clamp(value, 0, maxForDigits(digits)); return render(); }
+
+  if (action === "increment") { stopRandom(); value = clamp(value + 1, 0, maxForDigits(digits)); return render(); }
+  if (action === "decrement") { stopRandom(); value = clamp(value - 1, 0, maxForDigits(digits)); return render(); }
+
+  if (action === "reset")     { stopRandom(); value = 0; return render(); }
+  if (action === "random")    { return startRandom(); }
+
+  if (action === "customHex")    return openDialog("hex");
+  if (action === "customDenary") return openDialog("den");
+  if (action === "customBinary") return openDialog("bin");
+
+  if (action === "dialogCancel") return closeDialog();
+  if (action === "dialogApply")  return applyDialog();
+
+  if (action === "digitUp")   return applyDigitDelta(Number(btn.getAttribute("data-i")), +1);
+  if (action === "digitDown") return applyDigitDelta(Number(btn.getAttribute("data-i")), -1);
+});
+
+render();

src/src/layouts/BaseLayout.astro

@@ -0,0 +1,118 @@
+---
+const { title = "Computing:Box" } = Astro.props;
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>{title}</title>
+
+    <style>
+      :root{
+        --nav-h: 108px; /* 3x-ish height */
+        --bg: #1f2027;
+        --text: #e8e8ee;
+        --muted: #a9acb8;
+        --line: rgba(255,255,255,.10);
+      }
+
+      body{
+        margin:0;
+        background:var(--bg);
+        color:var(--text);
+      }
+
+      .siteNav{
+        position: sticky;
+        top: 0;
+        z-index: 50;
+        height: var(--nav-h);
+        background: rgba(0,0,0,.10);
+        border-bottom: 1px solid var(--line);
+        backdrop-filter: blur(8px);
+      }
+
+      .navInner{
+        height: 100%;
+        max-width: 1400px;
+        margin: 0 auto;
+        padding: 0 20px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 24px;
+      }
+
+      .brand{
+        display:flex;
+        align-items:center;
+        gap:12px;
+        text-decoration:none;
+        color:var(--text);
+      }
+
+      .brandLogo{
+        width: 2em;
+        height: 2em;
+        image-rendering: pixelated;
+      }
+
+      .brandName{
+        letter-spacing: .12em;
+        font-weight: 900;
+        text-transform: uppercase;
+        font-size: 18px;
+      }
+
+      .navLinks{
+        display:flex;
+        align-items:center;
+        gap:18px;
+        flex-wrap:wrap;
+      }
+
+      .navLinks a{
+        color: var(--muted);
+        text-decoration: none;
+        font-weight: 800;
+        letter-spacing: .12em;
+        font-size: 16px;
+        text-transform: uppercase;
+      }
+
+      .navLinks a:hover{
+        color: var(--text);
+      }
+
+      .pageWrap{
+        max-width: 1400px;
+        margin: 0 auto;
+      }
+    </style>
+  </head>
+
+  <body>
+    <header class="siteNav">
+      <div class="navInner">
+        <a class="brand" href="/">
+          <img class="brandLogo" src="/images/computing-box-logo.svg" alt="Computing:Box logo" />
+          <span class="brandName">COMPUTING:BOX</span>
+        </a>
+
+        <nav class="navLinks" aria-label="Site navigation">
+          <a href="/about">ABOUT</a>
+          <a href="/binary">BINARY</a>
+          <a href="/hexadecimal">HEXADECIMAL</a>
+          <a href="/hex-colours">HEX COLOURS</a>
+          <a href="/logic-gates">LOGIC GATES</a>
+        </nav>
+      </div>
+    </header>
+
+    <main class="pageWrap">
+      <slot />
+    </main>
+  </body>
+</html>

src/src/layouts/Layout.astro

@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="UTF-8" />
+		<meta name="viewport" content="width=device-width" />
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<meta name="generator" content={Astro.generator} />
+		<title>Astro Basics</title>
+	</head>
+	<body>
+		<slot />
+	</body>
+</html>
+
+<style>
+	html,
+	body {
+		margin: 0;
+		width: 100%;
+		height: 100%;
+	}
+</style>

src/src/pages/binary.astro

@@ -0,0 +1,115 @@
+---
+import BaseLayout from "../layouts/BaseLayout.astro";
+import "../styles/binary.css";
+---
+
+<BaseLayout title="Binary Simulator">
+  <main class="wrap">
+    <!-- Toolbox toggle sits below navbar (navbar is in BaseLayout) -->
+    <button id="toolboxToggle" class="toolboxToggle" type="button" aria-expanded="true">
+      <span class="toolboxIcon" aria-hidden="true">🧰</span>
+      <span class="toolboxText">TOOLBOX</span>
+    </button>
+
+    <section class="topGrid">
+      <!-- LEFT -->
+      <div class="mainCol">
+        <div class="readout">
+          <div class="label">Denary</div>
+          <div id="denaryNumber" class="num denaryValue">0</div>
+
+          <div class="label">Binary</div>
+          <!-- NOTE: JS writes exact bit-width here, so initial value doesn't matter much -->
+          <div id="binaryNumber" class="num binaryValue">00000000</div>
+        </div>
+
+        <div class="divider"></div>
+
+        <section class="bitsWrap" aria-label="Bit switches">
+          <div class="bitsGrid" id="bitsGrid"></div>
+        </section>
+      </div>
+
+      <!-- RIGHT (Toolbox panel) -->
+      <aside id="toolboxPanel" class="panelCol" aria-label="Toolbox">
+        <!-- Settings -->
+        <div class="card">
+          <div class="cardTitle">Settings</div>
+
+          <div class="toggleRow">
+            <div class="toggleLabel" id="lblUnsigned">Unsigned</div>
+
+            <label class="switch" aria-label="Toggle mode">
+              <input id="modeToggle" type="checkbox" />
+              <span class="slider"></span>
+            </label>
+
+            <!-- keep this on ONE line -->
+            <div class="toggleLabel" id="lblTwos">Two&apos;s&nbsp;complement</div>
+          </div>
+
+          <div class="hint" id="modeHint">
+            Tip: In unsigned binary, all bits represent positive values.
+          </div>
+
+          <div class="subCard">
+            <div class="subTitle">Bit width</div>
+
+            <div class="bitWidthRow">
+              <button class="miniBtn" id="btnBitsDown" type="button" aria-label="Decrease bits">−</button>
+
+              <div class="bitInputWrap">
+                <div class="bitInputLabel">Bits</div>
+                <input
+                  id="bitsInput"
+                  class="bitInput"
+                  type="number"
+                  inputmode="numeric"
+                  min="1"
+                  max="64"
+                  step="1"
+                  value="8"
+                  aria-label="Number of bits"
+                />
+              </div>
+
+              <button class="miniBtn" id="btnBitsUp" type="button" aria-label="Increase bits">+</button>
+            </div>
+          </div>
+        </div>
+
+        <!-- Custom Number -->
+        <div class="card">
+          <div class="cardTitle">Custom Number</div>
+
+          <div class="controlsRow">
+            <button class="btn btnAccent btnHalf" id="btnCustomBinary" type="button">Custom Binary</button>
+            <button class="btn btnAccent btnHalf" id="btnCustomDenary" type="button">Custom Denary</button>
+          </div>
+
+          <button class="btn btnWide" id="btnRandom" type="button">Random</button>
+          <div class="hint">Random runs briefly then stops automatically.</div>
+        </div>
+
+        <!-- Tools -->
+        <div class="card">
+          <div class="cardTitle">Tools</div>
+
+          <div class="toolRowCentered">
+            <button class="toolBtn toolSpin toolDec" id="btnDec" type="button" aria-label="Decrement">▼</button>
+            <button class="toolBtn toolSpin toolInc" id="btnInc" type="button" aria-label="Increment">▲</button>
+          </div>
+
+          <div class="toolRow2">
+            <button class="btn btnHalf" id="btnShiftLeft" type="button">Left Shift</button>
+            <button class="btn btnHalf" id="btnShiftRight" type="button">Right Shift</button>
+          </div>
+
+          <button class="btn btnReset btnWide" id="btnClear" type="button">Reset</button>
+        </div>
+      </aside>
+    </section>
+  </main>
+
+  <script type="module" src="/src/scripts/binary.js"></script>
+</BaseLayout>

src/src/pages/hexadecimal.astro

@@ -0,0 +1,8 @@
+---
+import BaseLayout from "../layouts/BaseLayout.astro";
+import HexSimulator from "../components/simulators/HexSimulator.astro";
+---
+
+<BaseLayout title="Hexadecimal | Computing:Box">
+  <HexSimulator />
+</BaseLayout>

src/src/pages/index.astro

@@ -0,0 +1,11 @@
+---
+import Welcome from '../components/Welcome.astro';
+import Layout from '../layouts/Layout.astro';
+
+// Welcome to Astro! Wondering what to do next? Check out the Astro documentation at https://docs.astro.build
+// Don't want to use any of this? Delete everything in this file, the `assets`, `components`, and `layouts` directories, and start fresh.
+---
+
+<Layout>
+	<Welcome />
+</Layout>

src/src/scripts/binary.js

@@ -0,0 +1,522 @@
+// src/scripts/binary.js
+// Computing:Box — Binary page logic (Unsigned + Two's Complement)
+
+(() => {
+  /* -----------------------------
+     DOM
+  ----------------------------- */
+  const bitsGrid = document.getElementById("bitsGrid");
+  const denaryEl = document.getElementById("denaryNumber");
+  const binaryEl = document.getElementById("binaryNumber");
+  const bitsInput = document.getElementById("bitsInput");
+
+  const modeToggle = document.getElementById("modeToggle");
+  const modeHint = document.getElementById("modeHint");
+
+  const btnCustomBinary = document.getElementById("btnCustomBinary");
+  const btnCustomDenary = document.getElementById("btnCustomDenary");
+  const btnShiftLeft = document.getElementById("btnShiftLeft");
+  const btnShiftRight = document.getElementById("btnShiftRight");
+
+  const btnDec = document.getElementById("btnDec");
+  const btnInc = document.getElementById("btnInc");
+  const btnClear = document.getElementById("btnClear");
+  const btnRandom = document.getElementById("btnRandom");
+
+  const btnBitsUp = document.getElementById("btnBitsUp");
+  const btnBitsDown = document.getElementById("btnBitsDown");
+
+  const toolboxToggle = document.getElementById("toolboxToggle");
+  const toolboxPanel = document.getElementById("toolboxPanel");
+
+  /* -----------------------------
+     STATE
+  ----------------------------- */
+  let bitCount = clampInt(Number(bitsInput?.value ?? 8), 1, 64);
+  let bits = new Array(bitCount).fill(false);
+  let randomTimer = null;
+
+  // For responsive wrapping of the top binary display
+  let nibblesPerLine = null;
+  let wrapMeasureSpan = null;
+
+  /* -----------------------------
+     HELPERS
+  ----------------------------- */
+  function clampInt(n, min, max) {
+    if (!Number.isFinite(n)) return min;
+    return Math.max(min, Math.min(max, Math.trunc(n)));
+  }
+
+  function isTwosMode() {
+    return !!modeToggle?.checked;
+  }
+
+  function pow2Big(n) {
+    return 1n << BigInt(n);
+  }
+
+  function unsignedMaxExclusive(nBits) {
+    return pow2Big(nBits);
+  }
+
+  function unsignedMaxValue(nBits) {
+    return pow2Big(nBits) - 1n;
+  }
+
+  function twosMin(nBits) {
+    return -pow2Big(nBits - 1);
+  }
+
+  function twosMax(nBits) {
+    return pow2Big(nBits - 1) - 1n;
+  }
+
+  function bitsToUnsignedBigInt() {
+    let v = 0n;
+    for (let i = 0; i < bitCount; i++) {
+      if (bits[i]) v += pow2Big(i);
+    }
+    return v;
+  }
+
+  function unsignedBigIntToBits(vUnsigned) {
+    const span = unsignedMaxExclusive(bitCount);
+    const v = ((vUnsigned % span) + span) % span;
+
+    for (let i = 0; i < bitCount; i++) {
+      bits[i] = ((v >> BigInt(i)) & 1n) === 1n;
+    }
+  }
+
+  function bitsToSignedBigIntTwos() {
+    const u = bitsToUnsignedBigInt();
+    const signBit = bits[bitCount - 1] === true;
+    if (!signBit) return u;
+    return u - pow2Big(bitCount);
+  }
+
+  function signedBigIntToBitsTwos(vSigned) {
+    const span = pow2Big(bitCount);
+    let v = ((vSigned % span) + span) % span;
+    unsignedBigIntToBits(v);
+  }
+
+  function updateModeHint() {
+    if (!modeHint) return;
+    modeHint.textContent = isTwosMode()
+      ? "Tip: In two’s complement, the left-most bit (MSB) represents a negative value."
+      : "Tip: In unsigned binary, all bits represent positive values.";
+  }
+
+  /* -----------------------------
+     TOP BINARY DISPLAY: responsive wrap by nibble count
+  ----------------------------- */
+  function ensureWrapMeasurer() {
+    if (wrapMeasureSpan || !binaryEl) return;
+    wrapMeasureSpan = document.createElement("span");
+    wrapMeasureSpan.style.position = "absolute";
+    wrapMeasureSpan.style.visibility = "hidden";
+    wrapMeasureSpan.style.whiteSpace = "pre";
+    wrapMeasureSpan.style.pointerEvents = "none";
+    // Inherit font/letterspacing from binaryEl
+    wrapMeasureSpan.style.font = getComputedStyle(binaryEl).font;
+    wrapMeasureSpan.style.letterSpacing = getComputedStyle(binaryEl).letterSpacing;
+    document.body.appendChild(wrapMeasureSpan);
+  }
+
+  function computeNibblesPerLine() {
+    if (!binaryEl) return null;
+    ensureWrapMeasurer();
+
+    // Available width = width of the readout area (binaryEl parent)
+    const host = binaryEl.parentElement;
+    if (!host) return null;
+
+    const hostW = host.getBoundingClientRect().width;
+    if (!Number.isFinite(hostW) || hostW <= 0) return null;
+
+    // Measure one nibble including trailing space ("0000 ")
+    wrapMeasureSpan.textContent = "0000 ";
+    const nibbleW = wrapMeasureSpan.getBoundingClientRect().width || 1;
+
+    // Safety: keep at least 1 nibble per line
+    const max = Math.max(1, Math.floor(hostW / nibbleW));
+    return max;
+  }
+
+  function formatBinaryWrapped() {
+    // EXACT bitCount digits (no padding to 4)
+    let raw = "";
+    for (let i = bitCount - 1; i >= 0; i--) raw += bits[i] ? "1" : "0";
+
+    // If <= 4 bits, do NOT insert spaces/newlines at all
+    if (bitCount <= 4) return raw;
+
+    const groups = [];
+    for (let i = 0; i < raw.length; i += 4) {
+      groups.push(raw.slice(i, i + 4));
+    }
+
+    const perLine = nibblesPerLine ?? groups.length;
+    if (perLine >= groups.length) return groups.join(" ");
+
+    const lines = [];
+    for (let i = 0; i < groups.length; i += perLine) {
+      lines.push(groups.slice(i, i + perLine).join(" "));
+    }
+    return lines.join("\n");
+  }
+
+  function refreshBinaryWrap() {
+    const next = computeNibblesPerLine();
+    // Only update if it actually changes (prevents jitter)
+    if (next !== nibblesPerLine) nibblesPerLine = next;
+    updateReadout(); // re-render with new wrap
+  }
+
+  /* -----------------------------
+     BUILD UI (BITS)
+  ----------------------------- */
+  function buildBits(count) {
+    bitCount = clampInt(count, 1, 64);
+    if (bitsInput) bitsInput.value = String(bitCount);
+
+    const oldBits = bits.slice();
+    bits = new Array(bitCount).fill(false);
+    for (let i = 0; i < Math.min(oldBits.length, bitCount); i++) bits[i] = oldBits[i];
+
+    bitsGrid.innerHTML = "";
+
+    bitsGrid.classList.toggle("bitsFew", bitCount < 8);
+    if (bitCount < 8) {
+      bitsGrid.style.setProperty("--cols", String(bitCount));
+    } else {
+      bitsGrid.style.removeProperty("--cols");
+    }
+
+    for (let i = bitCount - 1; i >= 0; i--) {
+      const bitEl = document.createElement("div");
+      bitEl.className = "bit";
+
+      bitEl.innerHTML = `
+        <div class="bulb" id="bulb-${i}" aria-hidden="true">💡</div>
+        <div class="bitVal" id="bitLabel-${i}"></div>
+        <label class="switch" aria-label="Toggle bit ${i}">
+          <input type="checkbox" data-index="${i}">
+          <span class="slider"></span>
+        </label>
+      `;
+
+      bitsGrid.appendChild(bitEl);
+    }
+
+    bitsGrid.querySelectorAll('input[type="checkbox"]').forEach((input) => {
+      input.addEventListener("change", () => {
+        const i = Number(input.dataset.index);
+        bits[i] = input.checked;
+        updateUI();
+      });
+    });
+
+    // bulb styling + 25% bigger (vs 26px previously)
+    for (let i = 0; i < bitCount; i++) {
+      const bulb = document.getElementById(`bulb-${i}`);
+      if (!bulb) continue;
+      bulb.style.width = "auto";
+      bulb.style.height = "auto";
+      bulb.style.border = "none";
+      bulb.style.background = "transparent";
+      bulb.style.borderRadius = "0";
+      bulb.style.boxShadow = "none";
+      bulb.style.opacity = "0.45";
+      bulb.style.fontSize = "32px";
+      bulb.style.lineHeight = "1";
+      bulb.style.display = "flex";
+      bulb.style.alignItems = "center";
+      bulb.style.justifyContent = "center";
+      bulb.style.filter = "grayscale(1)";
+      bulb.textContent = "💡";
+    }
+
+    // wrapping may change when bit width changes
+    refreshBinaryWrap();
+    updateUI();
+  }
+
+  /* -----------------------------
+     UI UPDATE
+  ----------------------------- */
+  function updateBitLabels() {
+    for (let i = 0; i < bitCount; i++) {
+      const label = document.getElementById(`bitLabel-${i}`);
+      if (!label) continue;
+
+      if (isTwosMode() && i === bitCount - 1) {
+        // Keep on one line (CSS: white-space:nowrap)
+        label.textContent = `-${pow2Big(bitCount - 1).toString()}`;
+      } else {
+        label.textContent = pow2Big(i).toString();
+      }
+    }
+  }
+
+  function syncSwitchesToBits() {
+    bitsGrid.querySelectorAll('input[type="checkbox"]').forEach((input) => {
+      const i = Number(input.dataset.index);
+      input.checked = !!bits[i];
+    });
+  }
+
+  function updateBulbs() {
+    for (let i = 0; i < bitCount; i++) {
+      const bulb = document.getElementById(`bulb-${i}`);
+      if (!bulb) continue;
+
+      const on = bits[i] === true;
+      if (on) {
+        bulb.style.opacity = "1";
+        bulb.style.filter = "grayscale(0)";
+        bulb.style.textShadow = "0 0 18px rgba(255,216,107,.75), 0 0 30px rgba(255,216,107,.45)";
+      } else {
+        bulb.style.opacity = "0.45";
+        bulb.style.filter = "grayscale(1)";
+        bulb.style.textShadow = "none";
+      }
+    }
+  }
+
+  function updateReadout() {
+    if (!denaryEl || !binaryEl) return;
+
+    denaryEl.textContent = (isTwosMode() ? bitsToSignedBigIntTwos() : bitsToUnsignedBigInt()).toString();
+    binaryEl.textContent = formatBinaryWrapped();
+  }
+
+  function updateUI() {
+    updateModeHint();
+    updateBitLabels();
+    syncSwitchesToBits();
+    updateBulbs();
+    updateReadout();
+  }
+
+  /* -----------------------------
+     SET FROM INPUT
+  ----------------------------- */
+  function setFromBinaryString(binStr) {
+    const clean = String(binStr ?? "").replace(/\s+/g, "");
+    if (!/^[01]+$/.test(clean)) return false;
+
+    const padded = clean.slice(-bitCount).padStart(bitCount, "0");
+    for (let i = 0; i < bitCount; i++) {
+      const charFromRight = padded[padded.length - 1 - i];
+      bits[i] = charFromRight === "1";
+    }
+
+    updateUI();
+    return true;
+  }
+
+  function setFromDenaryInput(vStr) {
+    const raw = String(vStr ?? "").trim();
+    if (!raw) return false;
+
+    let v;
+    try {
+      if (!/^-?\d+$/.test(raw)) return false;
+      v = BigInt(raw);
+    } catch {
+      return false;
+    }
+
+    if (isTwosMode()) {
+      const min = twosMin(bitCount);
+      const max = twosMax(bitCount);
+      if (v < min || v > max) return false;
+      signedBigIntToBitsTwos(v);
+    } else {
+      if (v < 0n) return false;
+      if (v > unsignedMaxValue(bitCount)) return false;
+      unsignedBigIntToBits(v);
+    }
+
+    updateUI();
+    return true;
+  }
+
+  /* -----------------------------
+     SHIFTS
+  ----------------------------- */
+  function shiftLeft() {
+    for (let i = bitCount - 1; i >= 1; i--) bits[i] = bits[i - 1];
+    bits[0] = false;
+    updateUI();
+  }
+
+  function shiftRight() {
+    if (isTwosMode()) {
+      // arithmetic right shift: keep MSB
+      const msb = bits[bitCount - 1];
+      for (let i = 0; i < bitCount - 1; i++) bits[i] = bits[i + 1];
+      bits[bitCount - 1] = msb;
+    } else {
+      for (let i = 0; i < bitCount - 1; i++) bits[i] = bits[i + 1];
+      bits[bitCount - 1] = false;
+    }
+    updateUI();
+  }
+
+  /* -----------------------------
+     CLEAR / INC / DEC
+  ----------------------------- */
+  function clearAll() {
+    bits.fill(false);
+    updateUI();
+  }
+
+  function increment() {
+    if (isTwosMode()) {
+      const min = twosMin(bitCount);
+      const max = twosMax(bitCount);
+      let v = bitsToSignedBigIntTwos() + 1n;
+      if (v > max) v = min;
+      signedBigIntToBitsTwos(v);
+    } else {
+      const span = unsignedMaxExclusive(bitCount);
+      unsignedBigIntToBits((bitsToUnsignedBigInt() + 1n) % span);
+    }
+    updateUI();
+  }
+
+  function decrement() {
+    if (isTwosMode()) {
+      const min = twosMin(bitCount);
+      const max = twosMax(bitCount);
+      let v = bitsToSignedBigIntTwos() - 1n;
+      if (v < min) v = max;
+      signedBigIntToBitsTwos(v);
+    } else {
+      const span = unsignedMaxExclusive(bitCount);
+      unsignedBigIntToBits((bitsToUnsignedBigInt() - 1n + span) % span);
+    }
+    updateUI();
+  }
+
+  /* -----------------------------
+     RANDOM
+  ----------------------------- */
+  function cryptoRandomBigInt(maxExclusive) {
+    if (maxExclusive <= 0n) return 0n;
+    const bitLen = maxExclusive.toString(2).length;
+    const byteLen = Math.ceil(bitLen / 8);
+
+    while (true) {
+      const bytes = new Uint8Array(byteLen);
+      crypto.getRandomValues(bytes);
+
+      let x = 0n;
+      for (const b of bytes) x = (x << 8n) | BigInt(b);
+
+      const extraBits = BigInt(byteLen * 8 - bitLen);
+      if (extraBits > 0n) x = x >> extraBits;
+      if (x < maxExclusive) return x;
+    }
+  }
+
+  function setRandomOnce() {
+    const span = unsignedMaxExclusive(bitCount);
+    const u = cryptoRandomBigInt(span);
+    unsignedBigIntToBits(u);
+    updateUI();
+  }
+
+  function runRandomBriefly() {
+    if (randomTimer) {
+      clearInterval(randomTimer);
+      randomTimer = null;
+    }
+
+    const start = Date.now();
+    const durationMs = 1125; // (your “~25% longer” vs 900ms)
+    const tickMs = 80;
+
+    randomTimer = setInterval(() => {
+      setRandomOnce();
+      if (Date.now() - start >= durationMs) {
+        clearInterval(randomTimer);
+        randomTimer = null;
+      }
+    }, tickMs);
+  }
+
+  /* -----------------------------
+     BIT WIDTH CONTROLS
+  ----------------------------- */
+  function setBitWidth(n) {
+    buildBits(clampInt(n, 1, 64));
+  }
+
+  /* -----------------------------
+     TOOLBOX TOGGLE (simple open/close state)
+  ----------------------------- */
+  function setToolboxOpen(open) {
+    document.body.classList.toggle("toolboxClosed", !open);
+    toolboxToggle?.setAttribute("aria-expanded", open ? "true" : "false");
+    refreshBinaryWrap(); // width changes when toolbox closes/opens
+  }
+
+  /* -----------------------------
+     EVENTS
+  ----------------------------- */
+  modeToggle?.addEventListener("change", () => updateUI());
+
+  btnCustomBinary?.addEventListener("click", () => {
+    const v = prompt(`Enter binary (spaces allowed). Current width: ${bitCount} bits`);
+    if (v === null) return;
+    if (!setFromBinaryString(v)) alert("Invalid binary");
+  });
+
+  btnCustomDenary?.addEventListener("click", () => {
+    const v = prompt(
+      isTwosMode()
+        ? `Enter denary (${twosMin(bitCount).toString()} to ${twosMax(bitCount).toString()}):`
+        : `Enter denary (0 to ${unsignedMaxValue(bitCount).toString()}):`
+    );
+    if (v === null) return;
+    if (!setFromDenaryInput(v)) alert("Invalid denary for current mode/bit width");
+  });
+
+  btnShiftLeft?.addEventListener("click", shiftLeft);
+  btnShiftRight?.addEventListener("click", shiftRight);
+
+  btnInc?.addEventListener("click", increment);
+  btnDec?.addEventListener("click", decrement);
+
+  btnClear?.addEventListener("click", clearAll);
+  btnRandom?.addEventListener("click", runRandomBriefly);
+
+  btnBitsUp?.addEventListener("click", () => setBitWidth(bitCount + 1));
+  btnBitsDown?.addEventListener("click", () => setBitWidth(bitCount - 1));
+
+  bitsInput?.addEventListener("change", () => setBitWidth(Number(bitsInput.value)));
+
+  toolboxToggle?.addEventListener("click", () => {
+    const isOpen = !document.body.classList.contains("toolboxClosed");
+    setToolboxOpen(!isOpen);
+  });
+
+  // Recompute wrapping live when the window size changes
+  let resizeT = null;
+  window.addEventListener("resize", () => {
+    if (resizeT) clearTimeout(resizeT);
+    resizeT = setTimeout(() => refreshBinaryWrap(), 60);
+  });
+
+  /* -----------------------------
+     INIT
+  ----------------------------- */
+  updateModeHint();
+  buildBits(bitCount);
+  setToolboxOpen(true);
+})();

src/src/styles/binary.css

@@ -0,0 +1,342 @@
+/*
+  Binary page styles (keeps the last-working simulator markup + binary.js).
+
+  Goals:
+  - Do NOT change any IDs/classes expected by src/scripts/binary.js
+  - Toolbox button toggles the ENTIRE right-hand column via body.toolboxClosed
+  - Fix toolbox button positioning (no overlap, consistent with header container)
+  - Fix spacing/consistency of cards + buttons
+  - Keep binary readout wrapping/bit-width behaviour from JS (\n in output)
+*/
+
+:root{
+  --panel-w: 360px;
+  --gap: 22px;
+}
+
+/* Page wrapper (inside BaseLayout .pageWrap) */
+.wrap{
+  max-width: 1400px;
+  margin: 0 auto;
+  padding: 22px 20px 48px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+/* Toolbox toggle button (sits below navbar, aligned right, never overlaps) */
+.toolboxToggle{
+  align-self: flex-end;
+  position: sticky;
+  top: calc(var(--nav-h, 108px) + 14px);
+  z-index: 30;
+
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  height: 40px;
+  padding: 0 14px;
+  border-radius: 12px;
+  border: 1px solid rgba(255,255,255,.14);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.92);
+  cursor: pointer;
+}
+.toolboxToggle:hover{ background: rgba(255,255,255,.08); }
+.toolboxText{
+  letter-spacing: .12em;
+  font-weight: 900;
+}
+
+/* Main layout grid */
+.topGrid{
+  display: grid;
+  grid-template-columns: 1fr var(--panel-w);
+  gap: var(--gap);
+  align-items: start;
+}
+
+/* Hide ENTIRE toolbox column when toggled closed */
+body.toolboxClosed .topGrid{ grid-template-columns: 1fr; }
+body.toolboxClosed #toolboxPanel{ display: none; }
+
+.mainCol{ min-width: 0; }
+
+/* Readout */
+.readout{
+  text-align: center;
+  margin-top: 8px;
+}
+
+.label{
+  opacity: .8;
+  letter-spacing: .12em;
+  text-transform: uppercase;
+  font-size: 12px;
+}
+
+/* IMPORTANT: allow shrinking below 4 bits (no min-width!) */
+.num{
+  display: inline-block;
+  width: fit-content;
+  max-width: 100%;
+  white-space: pre-line; /* allows JS \n wraps */
+  letter-spacing: 2px;
+}
+
+.denaryValue{
+  font-size: 54px;
+  margin: 6px 0 10px;
+}
+
+.binaryValue{
+  font-size: 56px;
+  margin: 4px 0 18px;
+}
+
+.divider{
+  height: 1px;
+  background: rgba(255,255,255,.10);
+  margin: 14px auto 24px;
+  max-width: 900px;
+}
+
+/* Bits area */
+.bitsWrap{ padding-top: 6px; }
+
+.bitsGrid{
+  display: grid;
+  gap: 24px;
+  justify-content: center;
+  grid-template-columns: repeat(auto-fit, minmax(110px, 1fr));
+  max-width: 1200px;
+  margin: 0 auto;
+}
+
+.bitsGrid.bitsFew{ justify-content: center; }
+
+.bit{
+  display: grid;
+  justify-items: center;
+  gap: 8px;
+}
+
+.bulb{
+  font-size: 32px; /* JS also bumps this */
+  line-height: 1;
+  opacity: .45;
+}
+
+.bitVal{
+  font-size: 22px;
+  line-height: 1.05;
+  text-align: center;
+  white-space: nowrap; /* keep -128 on one line */
+}
+
+/* Switch (existing classes assumed) */
+.switch{
+  position: relative;
+  display: inline-block;
+  width: 52px;
+  height: 28px;
+}
+.switch input{ display:none; }
+.slider{
+  position:absolute;
+  inset:0;
+  border-radius:999px;
+  background: rgba(255,255,255,.18);
+  border: 1px solid rgba(255,255,255,.14);
+}
+.slider:before{
+  content:"";
+  position:absolute;
+  height: 22px;
+  width: 22px;
+  left: 3px;
+  top: 2.5px;
+  border-radius: 999px;
+  background: #fff;
+  transition: transform .18s ease;
+}
+.switch input:checked + .slider:before{ transform: translateX(22px); }
+
+/* Toolbox column */
+.panelCol{
+  position: sticky;
+  top: calc(var(--nav-h, 108px) + 72px); /* leaves space for sticky toolbox button */
+  align-self: start;
+  display: grid;
+  gap: 16px;
+}
+
+/* Cards */
+.card{
+  border: 1px solid rgba(255,255,255,.12);
+  border-radius: 16px;
+  background: rgba(255,255,255,.05);
+  padding: 14px;
+}
+
+.cardTitle{
+  opacity: .8;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 12px;
+  margin-bottom: 10px;
+}
+
+.hint{
+  opacity: .7;
+  font-size: 11px;
+  margin-top: 10px;
+  line-height: 1.35;
+}
+
+/* Keep mode labels on one line */
+.toggleRow{
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
+  gap: 10px;
+  align-items: center;
+}
+
+.toggleLabel{
+  font-size: 12px;
+  font-weight: 800;
+  letter-spacing: .12em;
+  text-transform: uppercase;
+  white-space: nowrap;
+}
+
+.subCard{
+  margin-top: 12px;
+  border: 1px solid rgba(255,255,255,.10);
+  border-radius: 14px;
+  background: rgba(0,0,0,.12);
+  padding: 12px;
+}
+
+.subTitle{
+  opacity: .8;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 11px;
+  margin-bottom: 10px;
+}
+
+.bitWidthRow{
+  display: grid;
+  grid-template-columns: 44px 1fr 44px;
+  gap: 10px;
+  align-items: center;
+}
+
+.bitInputWrap{
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 10px;
+  align-items: center;
+  padding: 10px 12px;
+  border: 1px solid rgba(255,255,255,.10);
+  border-radius: 12px;
+  background: rgba(255,255,255,.04);
+}
+
+.bitInputLabel{
+  opacity: .75;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 11px;
+  white-space: nowrap;
+}
+
+.bitInput{
+  width: 100%;
+  min-width: 0;
+  background: transparent;
+  border: none;
+  outline: none;
+  color: inherit;
+  font-size: 20px;
+  text-align: right;
+}
+
+.miniBtn{
+  height: 44px;
+  border-radius: 12px;
+  border: 1px solid rgba(255,255,255,.12);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.9);
+  font-size: 18px;
+  cursor: pointer;
+}
+.miniBtn:hover{ background: rgba(255,255,255,.08); }
+
+/* Buttons */
+.controlsRow{
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 10px;
+  margin-bottom: 10px;
+}
+
+.btn{
+  border-radius: 12px;
+  border: 1px solid rgba(255,255,255,.12);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.92);
+  padding: 12px 12px;
+  font-weight: 800;
+  letter-spacing: .10em;
+  text-transform: uppercase;
+  cursor: pointer;
+}
+.btn:hover{ background: rgba(255,255,255,.08); }
+
+.btnWide{ width: 100%; }
+
+.btnAccent{
+  background: rgba(0,255,140,.12);
+  border-color: rgba(0,255,140,.22);
+}
+.btnAccent:hover{ background: rgba(0,255,140,.16); }
+
+.toolRowCentered{
+  display: flex;
+  justify-content: center;
+  gap: 12px;
+  margin: 10px 0 12px;
+}
+
+.toolBtn{
+  width: 56px;
+  height: 56px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,.12);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.92);
+  font-size: 18px;
+  cursor: pointer;
+}
+
+.toolDec{ background: rgba(255,0,0,.14); border-color: rgba(255,0,0,.20); }
+.toolInc{ background: rgba(0,255,140,.14); border-color: rgba(0,255,140,.20); }
+
+.toolRow2{
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 10px;
+  margin-bottom: 12px;
+}
+
+/* Reset stays white text */
+.btnReset{ color: rgba(255,255,255,.92); }
+
+/* Responsive */
+@media (max-width: 980px){
+  .topGrid{ grid-template-columns: 1fr; }
+  .panelCol{ position: static; }
+  .toolboxToggle{ position: static; align-self: flex-start; }
+}

src/src/styles/global.css

@@ -0,0 +1,85 @@
+:root{
+  --bg: #1f2027;
+  --panel: #22242d;
+  --panel2: rgba(255,255,255,.04);
+  --text: #e8e8ee;
+  --muted: #a9acb8;
+  --accent: #33ff7a;
+  --accent-dim: rgba(51,255,122,.15);
+  --line: rgba(255,255,255,.12);
+}
+
+*{ box-sizing:border-box; }
+
+body{
+  margin:0;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+}
+
+.siteHeader{
+  position: sticky;
+  top: 0;
+  z-index: 10;
+  background: rgba(0,0,0,.15);
+  backdrop-filter: blur(8px);
+  border-bottom: 1px solid rgba(255,255,255,.06);
+}
+
+.siteHeaderInner{
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 14px 20px;
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  gap: 16px;
+}
+
+.brand{
+  color: var(--text);
+  text-decoration:none;
+  font-weight: 900;
+  letter-spacing:.02em;
+}
+
+.nav{
+  display:flex;
+  gap: 14px;
+  flex-wrap:wrap;
+  justify-content:flex-end;
+}
+.nav a{
+  color: var(--muted);
+  text-decoration:none;
+  font-weight: 700;
+  font-size: 14px;
+}
+.nav a:hover{ color: var(--text); }
+
+.siteMain{
+  min-height: calc(100vh - 140px);
+}
+
+.siteFooter{
+  border-top: 1px solid rgba(255,255,255,.08);
+  margin-top: 32px;
+  background: rgba(0,0,0,.10);
+}
+
+.siteFooterInner{
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 18px 20px 26px;
+  color: var(--muted);
+  font-size: 12px;
+  line-height: 1.6;
+}
+
+.footerTitle{
+  color: var(--text);
+  opacity:.9;
+  font-weight: 800;
+  margin-bottom: 6px;
+}

src/src/styles/site.css

@@ -0,0 +1,75 @@
+:root{
+  --bg: #1f2027;
+  --panel: rgba(255,255,255,.04);
+  --panel-border: rgba(255,255,255,.10);
+  --text: #e8e8ee;
+  --muted: #a9acb8;
+  --accent: #33ff7a;
+  --accent-dim: rgba(51,255,122,.15);
+  --line: rgba(255,255,255,.12);
+}
+
+*{ box-sizing: border-box; }
+
+body{
+  margin:0;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+}
+
+.site-header{
+  border-bottom: 1px solid rgba(255,255,255,.08);
+  background: rgba(0,0,0,.12);
+}
+
+.site-header__inner{
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 14px 20px;
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  gap: 18px;
+}
+
+.brand{
+  font-weight: 800;
+  letter-spacing: .02em;
+}
+
+.nav{
+  display:flex;
+  gap: 14px;
+  flex-wrap: wrap;
+  justify-content:flex-end;
+}
+
+.nav__link{
+  color: var(--muted);
+  text-decoration:none;
+  font-weight: 700;
+  font-size: 13px;
+}
+.nav__link:hover{ color: var(--text); }
+
+.site-main{
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 28px 20px 40px;
+  min-height: calc(100vh - 140px);
+}
+
+.site-footer{
+  border-top: 1px solid rgba(255,255,255,.08);
+  background: rgba(0,0,0,.10);
+}
+
+.site-footer__inner{
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 16px 20px;
+  color: var(--muted);
+  font-size: 12px;
+  line-height: 1.5;
+}

src/styles/binary.css

@@ -1,386 +1,326 @@
+/* Binary page styles (moved OUT of binary.astro) */
+
 :root{
-  --bg: #1f2027;
+  --panel-w: 360px;
-  --panel2: rgba(255,255,255,.04);
+  --gap: 22px;
-  --text: #e8e8ee;
-  --muted: #a9acb8;
-  --accent: #33ff7a;
-  --accent-dim: rgba(51,255,122,.15);
-  --line: rgba(255,255,255,.12);
-
-  --danger: #e24444;
-  --danger-dim: rgba(226,68,68,.22);
-  --success: #2fd66b;
-  --success-dim: rgba(47,214,107,.22);
-}
-
-/* -------- Fonts -------- */
-@font-face{
-  font-family: "DSEG7ClassicRegular";
-  src:
-    url("/fonts/DSEG7Classic-Regular.woff") format("woff"),
-    url("/fonts/DSEG7Classic-Regular.ttf") format("truetype");
-  font-weight: 400;
-  font-style: normal;
-  font-display: swap;
-}
-
-@font-face{
-  font-family: "SevenSegment";
-  src:
-    url("/fonts/Seven-Segment.woff2") format("woff2"),
-    url("/fonts/Seven-Segment.woff") format("woff");
-  font-weight: 400;
-  font-style: normal;
-  font-display: swap;
-}
-
-body{
-  margin:0;
-  font-family: "SevenSegment", system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
-  background: var(--bg);
-  color: var(--text);
 }
 
 .wrap{
-  max-width: 1200px;
+  max-width: 1400px;
   margin: 0 auto;
-  padding: 32px 20px 60px;
+  padding: 26px 20px 48px;
+  position: relative;
 }
 
 .topGrid{
-  display:grid;
+  display: grid;
-  grid-template-columns: 1fr 340px;
+  grid-template-columns: 1fr var(--panel-w);
-  gap: 28px;
+  gap: var(--gap);
-  align-items:start;
+  align-items: start;
+}
+
+/* When toolbox is hidden, reclaim space + centre content */
+body.toolboxClosed .topGrid{
+  grid-template-columns: 1fr;
+}
+body.toolboxClosed #toolboxPanel{
+  display: none;
+}
+
+.mainCol{
+  min-width: 0;
 }
 
 .readout{
-  text-align:center;
+  text-align: center;
-  padding: 10px 10px 0;
+  margin-top: 8px;
 }
 
 .label{
-  letter-spacing: .18em;
+  opacity: .8;
-  font-weight: 700;
+  letter-spacing: .12em;
-  color: var(--muted);
   text-transform: uppercase;
-  font-size: 14px;
+  font-size: 12px;
-  margin-top: 10px;
 }
 
-/* Anything that is a number uses DSEG7 */
+/* IMPORTANT: allow shrinking below 4 bits (no min-width!) */
 .num{
-  font-family: "DSEG7ClassicRegular", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  display: inline-block;
-  font-weight: 400;
+  width: fit-content;
-  color: var(--accent);
+  max-width: 100%;
-  text-shadow: 0 0 18px var(--accent-dim);
+  white-space: pre-line; /* allows JS \n wraps */
+  letter-spacing: 2px;
 }
 
 .denaryValue{
-  font-size: 70px;
+  font-size: 54px;
-  line-height: 1.0;
   margin: 6px 0 10px;
 }
 
 .binaryValue{
-  font-size: 52px;
+  font-size: 56px;
-  letter-spacing: .12em;
+  margin: 4px 0 18px;
-  line-height: 1.0;
-  margin: 6px 0 14px;
-  white-space: pre;
-}
-
-.controlsStack{
-  margin-top: 10px;
-  display:flex;
-  flex-direction:column;
-  gap: 10px;
-  align-items:center;
-}
-
-.controlsRow{
-  display:flex;
-  gap: 12px;
-  justify-content:center;
-  flex-wrap:wrap;
-}
-
-.btn{
-  background: rgba(255,255,255,.06);
-  border: 1px solid rgba(255,255,255,.14);
-  color: #fff;
-  padding: 12px 14px;
-  border-radius: 12px;
-  font-weight: 700;
-  cursor: pointer;
-  min-width: 170px;
-  font-family: "SevenSegment", system-ui, sans-serif;
-}
-.btn:active{ transform: translateY(1px); }
-
-.btnAccent{
-  background: rgba(51,255,122,.18);
-  border-color: rgba(51,255,122,.45);
 }
 
 .divider{
-  margin-top: 26px;
+  height: 1px;
-  border-top: 1px solid var(--line);
+  background: rgba(255,255,255,.10);
+  margin: 14px auto 24px;
+  max-width: 900px;
 }
 
-.panelCol{
+.bitsWrap{
-  display:flex;
+  padding-top: 6px;
-  flex-direction:column;
-  gap: 14px;
 }
 
-.card{
+.bitsGrid{
-  background: var(--panel2);
+  display: grid;
-  border: 1px solid rgba(255,255,255,.10);
+  gap: 24px;
-  border-radius: 14px;
+  justify-content: center;
-  padding: 14px;
 }
 
-.cardTitle{
+/* Default: a single row of bits (will wrap automatically as bit count grows) */
-  letter-spacing: .18em;
+.bitsGrid{
-  font-weight: 800;
+  grid-template-columns: repeat(auto-fit, minmax(110px, 1fr));
-  color: var(--muted);
+  max-width: 1200px;
-  text-transform: uppercase;
+  margin: 0 auto;
-  font-size: 12px;
-  margin: 0 0 10px;
 }
 
-.hint{
+.bitsGrid.bitsFew{
-  color: var(--muted);
+  justify-content: center;
-  font-size: 12px;
-  margin-top: 8px;
-  line-height: 1.35;
 }
 
-.toggleRow{
+/* Bit tile */
-  display:flex;
+.bit{
-  align-items:center;
+  display: grid;
-  justify-content:space-between;
+  justify-items: center;
-  gap: 10px;
+  gap: 8px;
 }
 
-.toggleLabel{
+.bulb{
-  color: var(--text);
+  font-size: 32px; /* JS also bumps this */
-  font-weight: 700;
+  line-height: 1;
-  font-size: 14px;
+  opacity: .45;
-  font-family: "SevenSegment", system-ui, sans-serif;
 }
 
-/* Switch */
+.bitVal{
+  font-size: 22px;
+  line-height: 1.05;
+  text-align: center;
+  white-space: nowrap; /* keep -128 on one line */
+}
+
+/* Switch (existing classes assumed) */
 .switch{
   position: relative;
-  width: 56px;
+  display: inline-block;
-  height: 34px;
+  width: 52px;
-  display:inline-block;
+  height: 28px;
-  flex: 0 0 auto;
-}
-.switch input{
-  opacity:0;
-  width:0;
-  height:0;
 }
+.switch input{ display:none; }
 .slider{
   position:absolute;
   inset:0;
-  background: rgba(255,255,255,.10);
+  border-radius:999px;
+  background: rgba(255,255,255,.18);
   border: 1px solid rgba(255,255,255,.14);
-  border-radius: 999px;
-  transition: .18s ease;
 }
-.slider::before{
+.slider:before{
   content:"";
   position:absolute;
-  height: 28px;
+  height: 22px;
-  width: 28px;
+  width: 22px;
   left: 3px;
-  top: 2px;
+  top: 2.5px;
-  background: rgba(255,255,255,.92);
+  border-radius: 999px;
-  border-radius: 50%;
+  background: #fff;
-  transition: .18s ease;
+  transition: transform .18s ease;
 }
-.switch input:checked + .slider{
+.switch input:checked + .slider:before{
-  background: rgba(51,255,122,.20);
-  border-color: rgba(51,255,122,.55);
-}
-.switch input:checked + .slider::before{
   transform: translateX(22px);
-  background: var(--accent);
 }
 
-/* Tools layout */
+/* Toolbox toggle button */
-.toolRow{
+.toolboxToggle{
-  display:grid;
+  position: absolute;
+  right: 20px;
+  top: 18px;
+  z-index: 20;
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 14px;
+  border-radius: 12px;
+  border: 1px solid rgba(255,255,255,.14);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.92);
+  cursor: pointer;
+}
+.toolboxText{
+  letter-spacing: .12em;
+  font-weight: 900;
+}
+
+/* Toolbox panel */
+.panelCol{
+  position: sticky;
+  top: calc(var(--nav-h, 72px) + 18px);
+  align-self: start;
+  display: grid;
+  gap: 16px;
+}
+
+/* Cards */
+.card{
+  border: 1px solid rgba(255,255,255,.12);
+  border-radius: 16px;
+  background: rgba(255,255,255,.05);
+  padding: 14px;
+}
+.cardTitle{
+  opacity: .8;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 12px;
+  margin-bottom: 10px;
+}
+
+.hint{
+  opacity: .7;
+  font-size: 11px;
+  margin-top: 10px;
+  line-height: 1.35;
+}
+
+/* Keep mode labels on one line */
+.toggleRow{
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
+  gap: 10px;
+  align-items: center;
+}
+.toggleLabel{
+  font-size: 12px;
+  font-weight: 800;
+  letter-spacing: .12em;
+  text-transform: uppercase;
+  white-space: nowrap;
+}
+
+.subCard{
+  margin-top: 12px;
+  border: 1px solid rgba(255,255,255,.10);
+  border-radius: 14px;
+  background: rgba(0,0,0,.12);
+  padding: 12px;
+}
+.subTitle{
+  opacity: .8;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 11px;
+  margin-bottom: 10px;
+}
+
+.bitWidthRow{
+  display: grid;
+  grid-template-columns: 44px 1fr 44px;
+  gap: 10px;
+  align-items: center;
+}
+
+.bitInputWrap{
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 10px;
+  align-items: center;
+  padding: 10px 12px;
+  border: 1px solid rgba(255,255,255,.10);
+  border-radius: 12px;
+  background: rgba(255,255,255,.04);
+}
+.bitInputLabel{
+  opacity: .75;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+  font-size: 11px;
+  white-space: nowrap;
+}
+.bitInput{
+  width: 100%;
+  min-width: 0;
+  background: transparent;
+  border: none;
+  outline: none;
+  color: inherit;
+  font-size: 20px;
+  text-align: right;
+}
+
+.miniBtn{
+  height: 44px;
+  border-radius: 12px;
+  border: 1px solid rgba(255,255,255,.12);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.9);
+  font-size: 18px;
+  cursor: pointer;
+}
+
+/* Buttons */
+.controlsRow{
+  display: grid;
   grid-template-columns: 1fr 1fr;
   gap: 10px;
   margin-bottom: 10px;
 }
-.toolRow2{
+
-  display:grid;
+.btn{
-  grid-template-columns: 1fr 1fr;
+  border-radius: 12px;
-  gap: 10px;
+  border: 1px solid rgba(255,255,255,.12);
+  background: rgba(255,255,255,.06);
+  color: rgba(255,255,255,.92);
+  padding: 12px 12px;
+  font-weight: 800;
+  letter-spacing: .10em;
+  text-transform: uppercase;
+  cursor: pointer;
+}
+.btnWide{ width: 100%; }
+
+.btnAccent{
+  background: rgba(0,255,140,.12);
+  border-color: rgba(0,255,140,.22);
+}
+
+.toolRowCentered{
+  display: flex;
+  justify-content: center;
+  gap: 12px;
+  margin: 10px 0 12px;
 }
 
 .toolBtn{
-  height: 48px;
+  width: 56px;
-  border-radius: 12px;
+  height: 56px;
+  border-radius: 14px;
+  border: 1px solid rgba(255,255,255,.12);
   background: rgba(255,255,255,.06);
-  border: 1px solid rgba(255,255,255,.14);
+  color: rgba(255,255,255,.92);
-  color: #fff;
+  font-size: 18px;
   cursor: pointer;
-  font-weight: 800;
-  font-family: "SevenSegment", system-ui, sans-serif;
 }
+.toolDec{ background: rgba(255,0,0,.14); border-color: rgba(255,0,0,.20); }
+.toolInc{ background: rgba(0,255,140,.14); border-color: rgba(0,255,140,.20); }
 
-/* Narrower arrow buttons (only the arrow pair) */
+.toolRow2{
-.toolSpin{
+  display: grid;
-  font-size: 22px;
+  grid-template-columns: 1fr 1fr;
-  height: 48px;
-  max-width: 120px;      /* narrower */
-  justify-self: start;
-  padding: 0;
-}
-
-/* Down = red, Up = green */
-#btnDec{
-  background: var(--danger-dim);
-  border-color: rgba(226,68,68,.45);
-}
-#btnInc{
-  background: var(--success-dim);
-  border-color: rgba(47,214,107,.45);
-}
-
-/* Bit width control */
-.bitWidthRow{
-  display:grid;
-  grid-template-columns: 44px 1fr 44px;
   gap: 10px;
-  align-items:center;
+  margin-bottom: 12px;
-}
-.miniBtn{
-  height:44px;
-  width:44px;
-  border-radius:12px;
-  background:rgba(255,255,255,.06);
-  border:1px solid rgba(255,255,255,.14);
-  color:#fff;
-  cursor:pointer;
-  font-weight:900;
-  font-size:18px;
-  font-family: "SevenSegment", system-ui, sans-serif;
 }
 
-.bitInputWrap{
+/* Reset stays white text */
-  background:rgba(255,255,255,.06);
+.btnReset{
-  border:1px solid rgba(255,255,255,.14);
+  color: rgba(255,255,255,.92);
-  border-radius:12px;
-  padding:10px 12px;
-  display:flex;
-  align-items:center;
-  justify-content:space-between;
-  gap:12px;
-}
-.bitInputLabel{
-  color:var(--muted);
-  font-size:12px;
-  font-weight:800;
-  letter-spacing:.18em;
-  text-transform:uppercase;
-  font-family: "SevenSegment", system-ui, sans-serif;
-}
-.bitInput{
-  width:86px;
-  text-align:right;
-  background:transparent;
-  border:none;
-  outline:none;
-  color:var(--accent);
-  font-family:"DSEG7ClassicRegular", ui-monospace, monospace;
-  font-size:28px;
-}
-.bitInput::-webkit-outer-spin-button,
-.bitInput::-webkit-inner-spin-button{
-  -webkit-appearance:none;
-  margin:0;
-}
-
-/* Bits: wrap every 8, centred */
-.bitsWrap{
-  margin-top: 22px;
-}
-.bitsGrid{
-  display:grid;
-  gap: 18px;
-  justify-content:center;
-  grid-template-columns: repeat(8, minmax(90px, 1fr));
-  padding-top: 18px;
-}
-.bitsGrid.bitsFew{
-  grid-template-columns: repeat(var(--cols, 4), minmax(90px, 1fr));
-}
-
-.bit{
-  display:flex;
-  flex-direction:column;
-  align-items:center;
-  gap: 10px;
-  padding: 8px 4px;
-  text-align:center;
-}
-
-/* Bulb (emoji only — no circle, no ::before so it won't duplicate) */
-.bulb{
-  width: auto;
-  height: auto;
-  border: none;
-  background: transparent;
-  border-radius: 0;
-  box-shadow: none;
-
-  display:flex;
-  align-items:center;
-  justify-content:center;
-
-  font-size: 26px;
-  line-height: 1;
-  opacity: .45;
-  filter: grayscale(1);
-  text-shadow: none;
-}
-
-/* IMPORTANT: remove the pseudo-element that was causing the 2nd bulb */
-.bulb::before{
-  content: none;
-}
-
-.bulb.on{
-  opacity: 1;
-  filter: grayscale(0);
-  text-shadow: 0 0 14px rgba(255,216,107,.75), 0 0 26px rgba(255,216,107,.45);
-}
-
-/* Bit value numbers use DSEG7 */
-.bitVal{
-  font-family:"DSEG7ClassicRegular", ui-monospace, monospace;
-  font-size: 28px;
-  color: var(--text);
-  opacity: .95;
-  line-height: 1;
-  min-height: 32px;
-}
-
-@media (max-width: 980px){
-  .topGrid{ grid-template-columns: 1fr; }
-  .denaryValue{ font-size: 62px; }
-  .binaryValue{ font-size: 46px; }
-}
-
-@media (max-width: 520px){
-  .btn{ min-width: 150px; }
-  .bitsGrid{ grid-template-columns: repeat(4, minmax(90px, 1fr)); }
 }