Update Astro to 5.16.6

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

.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"

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
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+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
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+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
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     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
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     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,
-     communicate, and translate a Work;
- 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.
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+Public License
 
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), 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 "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.
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
+("Public License"). To the extent this Public License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
 
-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,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. BY-NC-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  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

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",
-      "resolved": "https://registry.npmjs.org/astro/-/astro-5.16.5.tgz",
-      "integrity": "sha512-QeuM4xzTR0QuXFDNlGVW0BW7rcquKFIkylaPeM4ufii0/RRiPTYtwxDYVZ3KfiMRuuc+nbLD0214kMKTvz/yvQ==",
+      "version": "5.16.6",
+      "resolved": "https://registry.npmjs.org/astro/-/astro-5.16.6.tgz",
+      "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

@@ -1,7 +1,7 @@
 {
-  "name": "Computing:Box",
+  "name": "computing-box",
   "type": "module",
-  "version": "2.0.0 Alpha",
+  "version": "0.0.1",
   "scripts": {
     "dev": "astro dev",
     "build": "astro build",
@@ -9,6 +9,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^5.16.5"
+    "astro": "^5.16.6"
   }
 }

public/css/tools/binary.css

@@ -0,0 +1,137 @@
+/* ---------- DSEG7 font ---------- */
+/* Put your font file here:
+   public/fonts/DSEG7Classic-Regular.woff2
+*/
+@font-face {
+  font-family: "DSEG7ClassicRegular";
+  src: url("/fonts/DSEG7Classic-Regular.woff2") format("woff2");
+  font-display: swap;
+}
+
+/* ---------- Layout ---------- */
+.tool-shell {
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+  padding: 1rem;
+  background: #0b0f14;
+  color: #e7eaf0;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+}
+
+.tool-card {
+  width: min(1100px, 100%);
+  background: #111824;
+  border: 1px solid rgba(255,255,255,0.08);
+  border-radius: 18px;
+  padding: 1rem;
+}
+
+.tool-header h1 { margin: 0 0 .25rem 0; font-size: 1.4rem; }
+.tool-header p { margin: 0 0 1rem 0; opacity: .85; }
+
+.display-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: .75rem;
+  margin-bottom: .75rem;
+}
+
+.display-box {
+  background: #0b0f14;
+  border: 1px solid rgba(255,255,255,0.08);
+  border-radius: 14px;
+  padding: .75rem;
+}
+
+.display-label { font-size: .9rem; opacity: .8; margin-bottom: .25rem; }
+
+.sevenseg {
+  font-family: "DSEG7ClassicRegular", monospace;
+  font-size: clamp(2rem, 4vw, 3.2rem);
+  letter-spacing: 0.08em;
+  line-height: 1.1;
+}
+
+/* Buttons under denary/binary (your request) */
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .5rem;
+  margin-bottom: 1rem;
+}
+
+/* ---------- Simple MD3-ish buttons ---------- */
+.md3-btn {
+  border: 1px solid rgba(255,255,255,0.16);
+  background: rgba(255,255,255,0.06);
+  color: #e7eaf0;
+  padding: .6rem .9rem;
+  border-radius: 999px;
+  cursor: pointer;
+  font-weight: 600;
+}
+.md3-btn:hover { background: rgba(255,255,255,0.10); }
+.md3-btn--tonal { background: rgba(255,255,255,0.10); }
+
+/* ---------- Switches row ---------- */
+.switch-row {
+  display: grid;
+  grid-template-columns: repeat(8, minmax(90px, 1fr));
+  gap: .75rem;
+}
+
+.switch-col {
+  display: grid;
+  justify-items: center;
+  gap: .35rem;
+}
+
+.bit-label { opacity: .85; font-weight: 600; }
+
+/* ---------- “Light switch” rocker ---------- */
+.rocker {
+  position: relative;
+  width: 70px;
+  height: 46px;
+  display: inline-block;
+  user-select: none;
+}
+
+.rocker input {
+  opacity: 0;
+  width: 0;
+  height: 0;
+}
+
+.rocker-body {
+  position: absolute;
+  inset: 0;
+  border-radius: 12px;
+  background: #1a2331;
+  border: 1px solid rgba(255,255,255,0.14);
+  box-shadow: inset 0 0 0 2px rgba(0,0,0,0.35);
+}
+
+/* the “toggle” */
+.rocker-body::after {
+  content: "";
+  position: absolute;
+  left: 6px;
+  top: 6px;
+  width: 58px;
+  height: 18px;
+  border-radius: 10px;
+  background: rgba(255,255,255,0.20);
+  transition: transform 180ms ease, background 180ms ease;
+}
+
+/* ON position */
+.rocker input:checked + .rocker-body::after {
+  transform: translateY(16px);
+  background: rgba(255,255,255,0.55);
+}
+
+@media (max-width: 900px) {
+  .switch-row { grid-template-columns: repeat(4, minmax(90px, 1fr)); }
+}

public/favicon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
+    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
+    <style>
+        path { fill: #000; }
+        @media (prefers-color-scheme: dark) {
+            path { fill: #FFF; }
+        }
+    </style>
+</svg>

public/js/binary/unsigned-binary.js

@@ -0,0 +1,115 @@
+// Browser-only script. Safe because it's loaded via <script> (not server-imported).
+
+const BIT_COUNT = 8; // unsigned page = 8 bits
+const bitValues = [128, 64, 32, 16, 8, 4, 2, 1];
+
+const elDenary = document.getElementById("denaryNumber");
+const elBinary = document.getElementById("binaryNumber");
+const elSwitches = document.getElementById("bitSwitches");
+
+const btnCustomDenary = document.getElementById("btnCustomDenary");
+const btnCustomBinary = document.getElementById("btnCustomBinary");
+const btnReset = document.getElementById("btnReset");
+
+let bits = new Array(BIT_COUNT).fill(false);
+
+function renderSwitches() {
+  elSwitches.innerHTML = "";
+
+  bitValues.forEach((value, index) => {
+    const id = `bit-${value}`;
+
+    const wrapper = document.createElement("div");
+    wrapper.className = "switch-col";
+
+    const labelTop = document.createElement("div");
+    labelTop.className = "bit-label";
+    labelTop.textContent = value;
+
+    const label = document.createElement("label");
+    label.className = "rocker";
+    label.setAttribute("for", id);
+
+    const input = document.createElement("input");
+    input.type = "checkbox";
+    input.id = id;
+    input.checked = bits[index];
+
+    input.addEventListener("change", () => {
+      bits[index] = input.checked;
+      updateNumbers();
+    });
+
+    const span = document.createElement("span");
+    span.className = "rocker-body";
+    span.setAttribute("aria-hidden", "true");
+
+    label.appendChild(input);
+    label.appendChild(span);
+
+    wrapper.appendChild(labelTop);
+    wrapper.appendChild(label);
+
+    elSwitches.appendChild(wrapper);
+  });
+}
+
+function updateNumbers() {
+  const binary = bits.map(b => (b ? "1" : "0")).join("");
+  const denary = bits.reduce((acc, b, i) => acc + (b ? bitValues[i] : 0), 0);
+
+  elBinary.textContent = binary;
+  elDenary.textContent = denary.toString();
+}
+
+function resetAll() {
+  bits = new Array(BIT_COUNT).fill(false);
+  renderSwitches();
+  updateNumbers();
+}
+
+function requestCustomDenary() {
+  let input = prompt(`Enter a denary number (0 to 255):`);
+  if (input === null) return;
+
+  const n = Number.parseInt(input, 10);
+  if (Number.isNaN(n) || n < 0 || n > 255) {
+    alert("Invalid input. Enter a number from 0 to 255.");
+    return;
+  }
+
+  let remaining = n;
+  bits = bitValues.map(v => {
+    if (remaining >= v) {
+      remaining -= v;
+      return true;
+    }
+    return false;
+  });
+
+  renderSwitches();
+  updateNumbers();
+}
+
+function requestCustomBinary() {
+  let input = prompt(`Enter an ${BIT_COUNT}-bit binary number (e.g. 01010101):`);
+  if (input === null) return;
+
+  input = input.trim();
+  const re = new RegExp(`^[01]{${BIT_COUNT}}$`);
+  if (!re.test(input)) {
+    alert(`Invalid input. Enter exactly ${BIT_COUNT} digits using only 0 or 1.`);
+    return;
+  }
+
+  bits = input.split("").map(c => c === "1");
+  renderSwitches();
+  updateNumbers();
+}
+
+btnCustomDenary?.addEventListener("click", requestCustomDenary);
+btnCustomBinary?.addEventListener("click", requestCustomBinary);
+btnReset?.addEventListener("click", resetAll);
+
+renderSwitches();
+updateNumbers();

public/js/tools/unsigned-binary.js

@@ -0,0 +1,72 @@
+// public/js/tools/unsigned-binary.js
+// Lightweight: no frameworks. Works on weak devices.
+const BIT_COUNT = 8;
+const MAX_DENARY = 255;
+let bits = new Array(BIT_COUNT).fill(false);
+function bitsToBinaryString(){
+ return bits.map(b => (b ? "1" : "0")).join("");
+}
+function bitsToDenary(){
+ // MSB on the left: 128..1
+ const weights = [128,64,32,16,8,4,2,1];
+ return bits.reduce((acc, b, i) => acc + (b ? weights[i] : 0), 0);
+}
+function render(){
+ const grid = document.getElementById("bitGrid");
+ grid.innerHTML = "";
+ const weights = [128,64,32,16,8,4,2,1];
+ bits.forEach((on, i) => {
+ const btn = document.createElement("button");
+ btn.type = "button";
+ btn.className = "btn";
+ btn.style.width = "100%";
+ btn.style.justifyContent = "space-between";
+ btn.setAttribute("aria-pressed", on ? "true" : "false");
+ btn.innerHTML = `<span>${weights[i]}</span><b>${on ? "1" : "0"}</b>`;
+ btn.addEventListener("click", () => {
+ bits[i] = !bits[i];
+ update();
+ });
+ grid.appendChild(btn);
+ });
+}
+function update(){
+ document.getElementById("binaryNumber").innerText = bitsToBinaryString();
+ document.getElementById("denaryNumber").innerText = bitsToDenary();
+ render();
+}
+function requestBinary(){
+ let v;
+ do{
+ v = prompt("Enter an 8-bit binary value (8 digits, only 0 or 1):", bitsToBinaryString());
+ if(v === null) return;
+ v = v.trim();
+ }while(!/^[01]{8}$/.test(v));
+ bits = v.split("").map(ch => ch === "1");
+ update();
+}
+function requestDenary(){
+ let v;
+ do{
+ v = prompt("Enter a denary value (0 to 255):", String(bitsToDenary()));
+ if(v === null) return;
+ v = Number(v);
+ }while(!Number.isInteger(v) || v < 0 || v > MAX_DENARY);
+ // set bits from MSB to LSB
+ const weights = [128,64,32,16,8,4,2,1];
+ bits = weights.map(w => {
+ if(v >= w){ v -= w; return true; }
+ return false;
+ });
+ update();
+}
+function reset(){
+ bits = new Array(BIT_COUNT).fill(false);
+ update();
+}
+document.addEventListener("DOMContentLoaded", () => {
+ document.getElementById("btnCustomBinary")?.addEventListener("click", requestBinary);
+ document.getElementById("btnCustomDenary")?.addEventListener("click", requestDenary);
+ document.getElementById("btnReset")?.addEventListener("click", reset);
+ update();
+});

public/styles.css

@@ -0,0 +1,96 @@
+/* src/styles/md3-tokens.css */
+/* MD3-inspired tokens tuned for education: high readability, clear contrast, calm surfaces */
+:root{
+ /* Typography */
+ --font-sans: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+ --font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
+ /* Spacing + shape */
+ --radius-1: 10px;
+ --radius-2: 16px;
+ --radius-3: 22px;
+ --shadow-1: 0 1px 2px rgba(0,0,0,.08), 0 2px 8px rgba(0,0,0,.06);
+ /* Color roles (keep simple) */
+ --md-surface: #ffffff;
+ --md-surface-2: #f6f7fb;
+ --md-on-surface: #111318;
+ --md-primary: #2f6fed; /* calm blue */
+ --md-on-primary: #ffffff;
+ --md-secondary: #5a5f72; /* muted */
+ --md-on-secondary: #ffffff;
+ --md-tertiary: #0f766e; /* teal for "practical" tools */
+ --md-on-tertiary: #ffffff;
+ --md-outline: #d7dbe7;
+ --md-success: #1a7f37;
+ --md-warning: #b54708;
+ --md-danger: #b42318;
+ /* Focus ring for accessibility */
+ --md-focus: 0 0 0 3px rgba(47,111,237,.28);
+}
+@media (prefers-color-scheme: dark){
+ :root{
+ --md-surface: #0b0e14;
+ --md-surface-2: #121725;
+ --md-on-surface: #e8eaf2;
+ --md-primary: #9bb6ff;
+ --md-on-primary: #0b0e14;
+ --md-secondary: #b8bccd;
+ --md-on-secondary: #0b0e14;
+ --md-tertiary: #4fd1c5;
+ --md-on-tertiary: #0b0e14;
+ --md-outline: #2b3244;
+ --md-focus: 0 0 0 3px rgba(155,182,255,.25);
+ }
+}
+
+/* src/styles/base.css */
+@import "./md3-tokens.css";
+html, body{ height:100%; }
+body{
+ margin:0;
+ font-family: var(--font-sans);
+ background: var(--md-surface-2);
+ color: var(--md-on-surface);
+}
+a{ color: var(--md-primary); text-decoration: none; }
+a:hover{ text-decoration: underline; }
+.container{
+ max-width: 1100px;
+ margin: 0 auto;
+ padding: 16px;
+}
+.card{
+ background: var(--md-surface);
+ border: 1px solid var(--md-outline);
+ border-radius: var(--radius-2);
+ box-shadow: var(--shadow-1);
+ padding: 16px;
+}
+.btn{
+ display:inline-flex;
+ gap:8px;
+ align-items:center;
+ justify-content:center;
+ border-radius: 999px;
+ border: 1px solid var(--md-outline);
+ background: var(--md-surface);
+ color: var(--md-on-surface);
+ padding: 10px 14px;
+ font-weight: 600;
+ cursor: pointer;
+}
+.btn:hover{ filter: brightness(0.98); }
+.btn:focus{ outline:none; box-shadow: var(--md-focus); }
+.btn-primary{
+ background: var(--md-primary);
+ color: var(--md-on-primary);
+ border-color: transparent;
+}
+.badge{
+ display:inline-block;
+ padding: 2px 10px;
+ border-radius: 999px;
+ font-size: 12px;
+ border: 1px solid var(--md-outline);
+ background: var(--md-surface-2);
+}
+code, pre{ font-family: var(--font-mono); }

src/components/Footer.astro

@@ -1,29 +0,0 @@
-<footer class="siteFooter">
-  <div class="inner">
-    <div class="title">Computer Science Concept Simulators</div>
-    <div class="meta">
-      © 2025 Computing:Box · Created with 💗 by Mr Lyall<br />
-      Powered by ADCM Networks
-    </div>
-  </div>
-</footer>
-
-<style>
-  .siteFooter{
-    border-top: 1px solid rgba(255,255,255,.10);
-    background: rgba(0,0,0,.10);
-  }
-  .inner{
-    max-width:1200px;
-    margin:0 auto;
-    padding: 18px 20px;
-    color: rgba(255,255,255,.65);
-    font-size: 12px;
-    line-height: 1.6;
-  }
-  .title{
-    color: rgba(255,255,255,.80);
-    font-weight: 800;
-    margin-bottom: 6px;
-  }
-</style>

src/components/Header.astro

@@ -1,57 +0,0 @@
-<header class="siteHeader">
-  <div class="inner">
-    <div class="brand">
-      <a href="/">Computing:Box</a>
-    </div>
-
-    <nav class="nav">
-      <a href="/binary">Binary</a>
-      <a href="/hexadecimal">Hexadecimal</a>
-      <a href="/hex-colours">Hex Colours</a>
-      <a href="/logic-gates">Logic Gates</a>
-      <a href="/about">About</a>
-    </nav>
-  </div>
-</header>
-
-<style>
-  .siteHeader{
-    height: 64px;
-    display:flex;
-    align-items:center;
-    border-bottom: 1px solid rgba(255,255,255,.10);
-    background: rgba(0,0,0,.10);
-    backdrop-filter: blur(8px);
-  }
-  .inner{
-    max-width: 1200px;
-    width: 100%;
-    margin: 0 auto;
-    padding: 0 20px;
-    display:flex;
-    align-items:center;
-    justify-content: space-between;
-    gap: 18px;
-  }
-  .brand a{
-    color:#fff;
-    text-decoration:none;
-    font-weight: 800;
-    letter-spacing: .02em;
-  }
-  .nav{
-    display:flex;
-    gap: 16px;
-    flex-wrap: wrap;
-  }
-  .nav a{
-    color: rgba(255,255,255,.78);
-    text-decoration:none;
-    font-weight: 700;
-    font-size: 13px;
-    letter-spacing:.02em;
-  }
-  .nav a:hover{
-    color:#fff;
-  }
-</style>

src/components/tools/BinarySimulator.astro

@@ -0,0 +1,381 @@
+---
+const { mode = "unsigned", defaultBits = 8 } = Astro.props;
+
+// For unsigned: min 1 bit, max 16 bits (tweak if you want)
+const minBits = 4;
+const maxBits = 16;
+const initialBits = Math.min(Math.max(defaultBits, minBits), maxBits);
+---
+
+<section class="binary-sim" data-mode={mode} data-bits={initialBits}>
+  <div class="top">
+    <div class="left-brand">
+      <!-- Replace with your logo/img -->
+      <div class="brand-box" aria-hidden="true">Computing:Box</div>
+    </div>
+
+    <div class="display" aria-live="polite">
+      <div class="label">DENARY</div>
+      <div id="denaryNumber" class="value">0</div>
+
+      <div class="label">BINARY</div>
+      <div id="binaryNumber" class="value mono">00000000</div>
+    </div>
+
+    <div class="actions">
+      <button class="btn" type="button" data-action="custom-binary">Custom Binary</button>
+      <button class="btn" type="button" data-action="custom-denary">Custom Denary</button>
+      <button class="btn" type="button" data-action="shift-left">Left Shift</button>
+      <button class="btn" type="button" data-action="shift-right">Right Shift</button>
+
+      <div class="bits-control">
+        <div class="bits-title">Bits</div>
+        <div class="bits-buttons">
+          <button class="btn small" type="button" data-action="bits-minus" aria-label="Decrease bits">−</button>
+          <span id="bitsCount" class="bits-count">{initialBits}</span>
+          <button class="btn small" type="button" data-action="bits-plus" aria-label="Increase bits">+</button>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div id="bitsRow" class="bits-row" aria-label="Binary bit switches"></div>
+</section>
+
+<script is:inline>
+(() => {
+  const root = document.currentScript.closest(".binary-sim");
+  const bitsRow = root.querySelector("#bitsRow");
+  const binaryEl = root.querySelector("#binaryNumber");
+  const denaryEl = root.querySelector("#denaryNumber");
+  const bitsCountEl = root.querySelector("#bitsCount");
+
+  let bitCount = parseInt(root.dataset.bits || "8", 10);
+  const minBits = 4;
+  const maxBits = 16;
+
+  // state: array of 0/1, MSB at index 0
+  let bits = new Array(bitCount).fill(0);
+
+  function placeValues(n) {
+    // unsigned place values: [2^(n-1), ..., 2^0]
+    return Array.from({ length: n }, (_, i) => 2 ** (n - 1 - i));
+  }
+
+  function bitsToDenary(bitsArr) {
+    const pv = placeValues(bitsArr.length);
+    return bitsArr.reduce((acc, b, i) => acc + (b ? pv[i] : 0), 0);
+  }
+
+  function render() {
+    const binaryStr = bits.join("");
+    binaryEl.textContent = binaryStr;
+    denaryEl.textContent = String(bitsToDenary(bits));
+    bitsCountEl.textContent = String(bitCount);
+
+    const pv = placeValues(bitCount);
+
+    bitsRow.innerHTML = pv.map((value, i) => {
+      const id = `bit_${bitCount}_${i}`;
+      const checked = bits[i] === 1 ? "checked" : "";
+      return `
+        <div class="bit-col">
+          <div class="bulb ${bits[i] ? "on" : "off"}" aria-hidden="true"></div>
+          <div class="place">${value}</div>
+
+          <label class="switch" for="${id}">
+            <input id="${id}" type="checkbox" ${checked} data-index="${i}">
+            <span class="slider" aria-hidden="true"></span>
+            <span class="sr-only">Toggle bit value ${value}</span>
+          </label>
+        </div>
+      `;
+    }).join("");
+  }
+
+  function setBitsFromBinaryString(str) {
+    // allow shorter input; pad left
+    const clean = (str || "").trim();
+    if (!/^[01]+$/.test(clean) || clean.length > bitCount) return false;
+    const padded = clean.padStart(bitCount, "0");
+    bits = padded.split("").map(c => c === "1" ? 1 : 0);
+    return true;
+  }
+
+  function setBitsFromDenary(num) {
+    if (!Number.isInteger(num)) return false;
+    const max = (2 ** bitCount) - 1;
+    if (num < 0 || num > max) return false;
+
+    const bin = num.toString(2).padStart(bitCount, "0");
+    bits = bin.split("").map(c => c === "1" ? 1 : 0);
+    return true;
+  }
+
+  function shiftLeft() {
+    bits = bits.slice(1).concat(0);
+  }
+
+  function shiftRight() {
+    bits = [0].concat(bits.slice(0, -1));
+  }
+
+  function resizeBits(newCount) {
+    const clamped = Math.max(minBits, Math.min(maxBits, newCount));
+    if (clamped === bitCount) return;
+
+    // keep value as best as possible: preserve LSBs when resizing
+    const currentBinary = bits.join("");
+    bitCount = clamped;
+    bits = new Array(bitCount).fill(0);
+
+    const take = currentBinary.slice(-bitCount);
+    setBitsFromBinaryString(take);
+  }
+
+  // Switch input handler
+  bitsRow.addEventListener("change", (e) => {
+    const input = e.target;
+    if (!(input instanceof HTMLInputElement)) return;
+    const idx = parseInt(input.dataset.index || "-1", 10);
+    if (idx < 0) return;
+    bits[idx] = input.checked ? 1 : 0;
+    render();
+  });
+
+  // Button actions
+  root.querySelector(".actions").addEventListener("click", (e) => {
+    const btn = e.target.closest("button[data-action]");
+    if (!btn) return;
+
+    const action = btn.dataset.action;
+
+    if (action === "custom-binary") {
+      const entered = prompt(`Enter a ${bitCount}-bit binary value (0s and 1s):`, bits.join(""));
+      if (entered === null) return;
+      if (!setBitsFromBinaryString(entered)) {
+        alert(`Invalid binary. Use only 0 and 1, up to ${bitCount} digits.`);
+        return;
+      }
+      render();
+    }
+
+    if (action === "custom-denary") {
+      const max = (2 ** bitCount) - 1;
+      const entered = prompt(`Enter a denary value (0 to ${max}):`, String(bitsToDenary(bits)));
+      if (entered === null) return;
+      const num = Number.parseInt(entered, 10);
+      if (!setBitsFromDenary(num)) {
+        alert(`Invalid denary. Enter a whole number from 0 to ${max}.`);
+        return;
+      }
+      render();
+    }
+
+    if (action === "shift-left") { shiftLeft(); render(); }
+    if (action === "shift-right") { shiftRight(); render(); }
+
+    if (action === "bits-minus") { resizeBits(bitCount - 1); render(); }
+    if (action === "bits-plus") { resizeBits(bitCount + 1); render(); }
+  });
+
+  // initial
+  render();
+})();
+</script>
+
+<style>
+/* Layout */
+.binary-sim {
+  padding: 2rem 1rem 3rem;
+}
+
+.top {
+  display: grid;
+  grid-template-columns: 260px 1fr 220px;
+  gap: 1.5rem;
+  align-items: start;
+}
+
+@media (max-width: 980px) {
+  .top {
+    grid-template-columns: 1fr;
+  }
+  .actions {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+  }
+}
+
+/* Brand placeholder */
+.brand-box {
+  width: 180px;
+  height: 180px;
+  border-radius: 12px;
+  display: grid;
+  place-items: center;
+  font-weight: 700;
+  opacity: 0.9;
+  border: 1px solid rgba(255,255,255,0.08);
+  background: rgba(255,255,255,0.04);
+}
+
+/* Display */
+.display {
+  text-align: center;
+  padding: 1rem;
+}
+
+.label {
+  letter-spacing: 0.12em;
+  opacity: 0.85;
+  margin-top: 0.5rem;
+}
+
+.value {
+  font-size: 3rem;
+  line-height: 1.1;
+  margin: 0.25rem 0 0.75rem;
+  font-weight: 700;
+}
+
+.mono {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+}
+
+/* Buttons */
+.actions {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+
+.btn {
+  border: 0;
+  border-radius: 10px;
+  padding: 0.75rem 1rem;
+  font-weight: 600;
+  cursor: pointer;
+  background: rgba(255,255,255,0.08);
+  color: inherit;
+}
+
+.btn:hover { background: rgba(255,255,255,0.12); }
+
+.btn.small {
+  padding: 0.45rem 0.75rem;
+  border-radius: 10px;
+}
+
+.bits-control {
+  margin-top: 0.25rem;
+  padding-top: 0.5rem;
+  border-top: 1px solid rgba(255,255,255,0.08);
+}
+
+.bits-title { opacity: 0.8; margin-bottom: 0.35rem; }
+
+.bits-buttons {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.bits-count {
+  min-width: 2ch;
+  text-align: center;
+  font-weight: 700;
+}
+
+/* Bits row */
+.bits-row {
+  margin-top: 2rem;
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(88px, 1fr));
+  gap: 1.25rem;
+  align-items: end;
+}
+
+.bit-col {
+  text-align: center;
+  padding: 0.5rem 0.25rem;
+}
+
+.place {
+  margin: 0.5rem 0 0.5rem;
+  font-size: 2rem;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+}
+
+/* Bulb */
+.bulb {
+  width: 26px;
+  height: 26px;
+  margin: 0 auto 0.25rem;
+  border-radius: 50%;
+  border: 1px solid rgba(255,255,255,0.15);
+}
+.bulb.off { opacity: 0.15; }
+.bulb.on  { opacity: 1; }
+
+/* Light switch (accessible checkbox) */
+.switch {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 64px;
+  height: 36px;
+  position: relative;
+}
+
+.switch input {
+  position: absolute;
+  opacity: 0;
+  width: 1px;
+  height: 1px;
+}
+
+.slider {
+  width: 64px;
+  height: 36px;
+  border-radius: 999px;
+  background: rgba(255,255,255,0.10);
+  border: 1px solid rgba(255,255,255,0.14);
+  position: relative;
+  transition: transform 120ms ease, background 120ms ease;
+}
+
+.slider::after {
+  content: "";
+  position: absolute;
+  top: 4px;
+  left: 4px;
+  width: 28px;
+  height: 28px;
+  border-radius: 999px;
+  background: rgba(255,255,255,0.85);
+  transition: transform 120ms ease;
+}
+
+.switch input:checked + .slider {
+  background: rgba(255,255,255,0.18);
+}
+
+.switch input:checked + .slider::after {
+  transform: translateX(28px);
+}
+
+/* focus */
+.switch input:focus-visible + .slider {
+  outline: 3px solid rgba(255,255,255,0.35);
+  outline-offset: 2px;
+}
+
+.sr-only {
+  position: absolute;
+  width: 1px; height: 1px;
+  padding: 0; margin: -1px;
+  overflow: hidden; clip: rect(0,0,0,0);
+  white-space: nowrap; border: 0;
+}
+</style>

src/layouts/BaseLayout.astro

@@ -1,41 +1,17 @@
 ---
+// src/layouts/BaseLayout.astro
 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" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>{title}</title>
-    <link rel="stylesheet" href="/src/styles/site.css" />
+ <link rel="stylesheet" href="/styles.css" />
+ <link rel="stylesheet" href="/fonts/DSEG7Classic-Regular.css">
  </head>
-
  <body>
-    <header class="site-header">
-      <div class="site-header__inner">
-        <div class="brand">Computing:Box</div>
-
-        <nav class="nav">
-          <a class="nav__link" href="/binary">Binary</a>
-          <a class="nav__link" href="/hexadecimal">Hexadecimal</a>
-          <a class="nav__link" href="/hex-colours">Hex Colours</a>
-          <a class="nav__link" href="/logic-gates">Logic Gates</a>
-          <a class="nav__link" href="/about">About</a>
-        </nav>
-      </div>
-    </header>
-
-    <main class="site-main">
  <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,106 +1,642 @@
 ---
-import BaseLayout from "../layouts/BaseLayout.astro";
-import "../styles/binary.css";
-
-// ✅ Correct Astro v5 way: bundle script from src/ and get its final URL
-import binaryScriptUrl from "../scripts/binary.js?url";
+/**
+ * src/pages/binary.astro
+ * Single-file binary simulator (Unsigned + Two's complement)
+ * Bit width: 4..64
+ *
+ * Requires:
+ *  public/fonts/DSEG7Classic-Regular.woff
+ *  public/fonts/DSEG7Classic-Regular.ttf
+ */
 ---
 
-<BaseLayout title="Binary | Computing:Box">
-  <section class="binary-wrap">
-    <div class="topGrid">
-      <!-- LEFT: readout + main buttons -->
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>Binary | Computing:Box</title>
+
+    <style>
+      :root{
+        --bg: #1f2027;
+        --panel: #22242d;
+        --panel2:#262833;
+        --text: #e8e8ee;
+        --muted: #a9acb8;
+        --accent: #33ff7a;
+        --accent-dim: rgba(51,255,122,.15);
+        --line: rgba(255,255,255,.12);
+      }
+
+      @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;
+      }
+
+      body{
+        margin:0;
+        font-family: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+        background: var(--bg);
+        color: var(--text);
+      }
+
+      .wrap{
+        max-width: 1200px;
+        margin: 0 auto;
+        padding: 32px 20px 60px;
+      }
+
+      /* Layout: readout left, settings panel right (like your screenshot) */
+      .layout{
+        display:grid;
+        grid-template-columns: 1fr 360px;
+        gap: 22px;
+        align-items:start;
+      }
+
+      .readout{
+        text-align:center;
+        padding: 10px 10px 0;
+      }
+
+      .label{
+        letter-spacing: .18em;
+        font-weight: 700;
+        color: var(--muted);
+        text-transform: uppercase;
+        font-size: 16px;
+        margin-top: 8px;
+      }
+
+      .num{
+        font-family: "DSEG7ClassicRegular", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+        font-weight: 400;
+        color: var(--accent);
+        text-shadow: 0 0 18px var(--accent-dim);
+      }
+
+      .value{
+        font-size: 70px;
+        line-height: 1.0;
+        margin: 6px 0 16px;
+      }
+
+      .binary{
+        font-size: 54px;
+        letter-spacing: .12em;
+        word-break: break-all;
+      }
+
+      /* Buttons under readout (as requested) */
+      .controls{
+        margin-top: 16px;
+        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: 160px;
+      }
+      .btn:active{ transform: translateY(1px); }
+
+      /* Settings panel cards */
+      .panel{
+        background: rgba(255,255,255,.04);
+        border: 1px solid rgba(255,255,255,.10);
+        border-radius: 14px;
+        padding: 16px 16px 14px;
+        margin-bottom: 14px;
+      }
+      .panelTitle{
+        font-size: 12px;
+        letter-spacing: .16em;
+        text-transform: uppercase;
+        color: var(--muted);
+        font-weight: 800;
+        margin-bottom: 10px;
+      }
+      .panelRow{
+        display:flex;
+        align-items:center;
+        justify-content:space-between;
+        gap: 12px;
+      }
+      .hint{
+        color: var(--muted);
+        font-size: 12px;
+        margin-top: 10px;
+        line-height: 1.35;
+      }
+
+      /* Reusable toggle switch (for MODE and for each BIT) */
+      .switch{
+        position: relative;
+        width: 56px;
+        height: 34px;
+        display:inline-block;
+        flex: 0 0 auto;
+      }
+      .switch input{
+        opacity:0;
+        width:0;
+        height:0;
+      }
+      .slider{
+        position:absolute;
+        inset:0;
+        background: rgba(255,255,255,.10);
+        border: 1px solid rgba(255,255,255,.14);
+        border-radius: 999px;
+        transition: .18s ease;
+      }
+      .slider::before{
+        content:"";
+        position:absolute;
+        height: 28px;
+        width: 28px;
+        left: 3px;
+        top: 2px;
+        background: rgba(255,255,255,.92);
+        border-radius: 50%;
+        transition: .18s ease;
+      }
+      .switch input:checked + .slider{
+        background: rgba(51,255,122,.20);
+        border-color: rgba(51,255,122,.55);
+      }
+      .switch input:checked + .slider::before{
+        transform: translateX(22px);
+        background: var(--accent);
+      }
+
+      /* Bit width controls */
+      .bwControls{
+        display:grid;
+        grid-template-columns: 44px 1fr 44px;
+        gap: 10px;
+        align-items:center;
+        margin-top: 8px;
+      }
+      .bwBtn{
+        width: 44px;
+        height: 44px;
+        border-radius: 12px;
+        border: 1px solid rgba(255,255,255,.14);
+        background: rgba(255,255,255,.06);
+        color: #fff;
+        font-weight: 900;
+        cursor: pointer;
+      }
+      .bwBtn:active{ transform: translateY(1px); }
+
+      .bwInput{
+        display:flex;
+        align-items:center;
+        justify-content:space-between;
+        gap: 12px;
+        background: rgba(255,255,255,.05);
+        border: 1px solid rgba(255,255,255,.12);
+        border-radius: 12px;
+        padding: 10px 12px;
+      }
+      .bwLabel{
+        color: var(--muted);
+        font-size: 12px;
+        letter-spacing: .14em;
+        text-transform: uppercase;
+        font-weight: 800;
+      }
+      .bwField{
+        width: 100px;
+        text-align:right;
+        background: transparent;
+        border: none;
+        outline: none;
+        color: var(--accent);
+        font-family: "DSEG7ClassicRegular", ui-monospace, monospace;
+        font-size: 26px;
+        padding: 0;
+      }
+      .bwField::-webkit-outer-spin-button,
+      .bwField::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }
+      .bwField[type=number] { -moz-appearance: textfield; }
+
+      /* Bits grid */
+      .bits{
+        margin-top: 34px;
+        padding-top: 26px;
+        border-top: 1px solid var(--line);
+        display:grid;
+        gap: 18px;
+        align-items:end;
+        text-align:center;
+      }
+
+      .bit{
+        display:flex;
+        flex-direction:column;
+        align-items:center;
+        gap: 10px;
+        padding: 8px 4px;
+      }
+
+      .bitVal{
+        font-size: 34px;
+        color: var(--text);
+        opacity: .95;
+      }
+
+      /* Bulb (must come back!) */
+      .bulb{
+        width: 22px;
+        height: 22px;
+        border-radius: 50%;
+        background: rgba(255,255,255,.08);
+        border: 1px solid rgba(255,255,255,.12);
+        box-shadow: none;
+        margin-bottom: 6px;
+      }
+      .bulb.on{
+        background: #ffd86b;
+        border-color: rgba(255,216,107,.7);
+        box-shadow: 0 0 18px rgba(255,216,107,.6);
+      }
+
+      /* Responsive */
+      @media (max-width: 1000px){
+        .layout{ grid-template-columns: 1fr; }
+        .value{ font-size: 60px; }
+        .binary{ font-size: 44px; }
+      }
+      @media (max-width: 900px){
+        .value{ font-size: 54px; }
+        .binary{ font-size: 36px; }
+        .btn{ min-width: 140px; }
+      }
+    </style>
+  </head>
+
+  <body>
+    <main class="wrap">
+      <section class="layout">
+        <!-- LEFT: readout + buttons -->
         <div>
           <div class="readout">
             <div class="label">Denary</div>
-          <div id="denaryNumber" class="num denary">0</div>
+            <div id="denaryNumber" class="value num">0</div>
 
             <div class="label">Binary</div>
-          <pre id="binaryNumber" class="num binary" aria-label="Binary value">0</pre>
+            <div id="binaryNumber" class="value binary num">00000000</div>
 
-          <!-- ORANGE: custom + shifts on separate lines -->
-          <div class="controls controls--twoRows">
-            <div class="controlsRow">
-              <button class="btn btn--green" id="btnCustomBinary" type="button">Custom Binary</button>
-              <button class="btn btn--green" id="btnCustomDenary" type="button">Custom Denary</button>
-            </div>
-            <div class="controlsRow">
+            <div class="controls">
+              <button class="btn" id="btnCustomBinary" type="button">Custom Binary</button>
+              <button class="btn" id="btnCustomDenary" type="button">Custom Denary</button>
               <button class="btn" id="btnShiftLeft" type="button">Left Shift</button>
               <button class="btn" id="btnShiftRight" type="button">Right Shift</button>
             </div>
           </div>
+
+          <!-- Bits grid (built by JS so bit-width 4..64 works) -->
+          <section id="bitsGrid" class="bits" aria-label="Bit switches"></section>
         </div>
 
-        <div class="divider"></div>
+        <!-- RIGHT: settings panel -->
+        <aside>
+          <div class="panel">
+            <div class="panelTitle">Mode</div>
+            <div class="panelRow">
+              <span style="font-weight:800;">Unsigned</span>
 
-        <!-- Bits render here -->
-        <section class="bits" id="bitsGrid" aria-label="Bit switches"></section>
-      </div>
-
-      <!-- RIGHT: red buttons go above/below this panel (not in the middle) -->
-      <aside class="panelCol">
-        <div class="card">
-          <div class="cardTitle">Mode</div>
-
-          <div class="toggleRow">
-            <div class="toggleLabel" id="lblUnsigned">Unsigned</div>
-
-            <label class="switch" aria-label="Toggle mode">
+              <!-- MODE TOGGLE uses SAME switch style -->
+              <label class="switch" aria-label="Toggle Two's complement mode">
                 <input id="modeToggle" type="checkbox" />
                 <span class="slider"></span>
               </label>
 
-            <div class="toggleLabel" id="lblTwos">Two&apos;s complement</div>
-          </div>
-
-          <div class="hint" id="modeHint">
-            Tip: In unsigned binary, all bits represent positive values.
-          </div>
-        </div>
-
-        <!-- RED: extra buttons ABOVE bit width -->
-        <div class="card">
-          <div class="cardTitle">Tools</div>
-          <div class="toolsGrid">
-            <button class="btn" id="btnClear" type="button">Clear</button>
-            <button class="btn btn--spin" id="btnMinus1" type="button">−1</button>
-            <button class="btn btn--spin" id="btnPlus1" type="button">+1</button>
-            <button class="btn" id="btnAutoRandom" type="button">Auto Random</button>
+              <span style="font-weight:800;">Two’s complement</span>
             </div>
             <div class="hint">
-            Auto Random runs briefly then stops automatically.
+              Tip: In two’s complement, the left-most bit (MSB) represents a negative value.
             </div>
           </div>
 
-        <div class="card">
-          <div class="cardTitle">Bit width</div>
+          <div class="panel">
+            <div class="panelTitle">Bit width</div>
 
-          <div class="bitWidthRow">
-            <button class="miniBtn" id="btnBitsDown" type="button" aria-label="Decrease bits">−</button>
+            <div class="bwControls">
+              <button class="bwBtn" id="btnBitsDown" type="button" aria-label="Decrease bits">−</button>
 
-            <div class="bitInputWrap">
-              <div class="bitInputLabel">Bits</div>
+              <div class="bwInput">
+                <div class="bwLabel">Bits</div>
                 <input
-                id="bitsInput"
-                class="bitInput"
+                  id="bitsField"
+                  class="bwField"
                   type="number"
-                inputmode="numeric"
-                min="1"
+                  min="4"
                   max="64"
                   step="1"
                   value="8"
-                aria-label="Number of bits"
+                  inputmode="numeric"
                 />
               </div>
 
-            <button class="miniBtn" id="btnBitsUp" type="button" aria-label="Increase bits">+</button>
+              <button class="bwBtn" id="btnBitsUp" type="button" aria-label="Increase bits">+</button>
             </div>
 
-          <div class="hint">Minimum 1 bit, maximum 64 bits.</div>
+            <div class="hint">
+              Minimum 4 bits, maximum 64 bits.
+            </div>
           </div>
         </aside>
-    </div>
-
-    <script type="module" src={binaryScriptUrl}></script>
       </section>
-</BaseLayout>
+    </main>
+
+    <script type="module">
+      // ---------- State ----------
+      let bitsCount = 8;           // 4..64
+      let isTwos = false;          // false = unsigned
+      let bitStates = [];          // MSB -> LSB booleans
+
+      // ---------- Helpers ----------
+      function clamp(n, min, max){ return Math.min(max, Math.max(min, n)); }
+
+      function pow2(n){
+        // for up to 64 bits, Number is still OK for *visual simulator*.
+        // if you later want exact 64-bit maths, swap to BigInt end-to-end.
+        return 2 ** n;
+      }
+
+      function getPlaceValues(){
+        // MSB -> LSB
+        // Unsigned: [2^(n-1), ..., 1]
+        // Two's:    [-2^(n-1), 2^(n-2), ..., 1]
+        const vals = [];
+        for (let i = 0; i < bitsCount; i++){
+          const power = bitsCount - 1 - i;
+          if (isTwos && i === 0){
+            vals.push(-pow2(power));
+          } else {
+            vals.push(pow2(power));
+          }
+        }
+        return vals;
+      }
+
+      function binaryString(){
+        return bitStates.map(b => (b ? "1" : "0")).join("");
+      }
+
+      function denaryValue(){
+        const values = getPlaceValues();
+        let sum = 0;
+        for (let i = 0; i < bitsCount; i++){
+          if (bitStates[i]) sum += values[i];
+        }
+        return sum;
+      }
+
+      function rangeForMode(){
+        if (!isTwos){
+          return { min: 0, max: pow2(bitsCount) - 1 };
+        }
+        return { min: -pow2(bitsCount - 1), max: pow2(bitsCount - 1) - 1 };
+      }
+
+      function updateReadout(){
+        document.getElementById("binaryNumber").innerText = binaryString();
+        document.getElementById("denaryNumber").innerText = String(denaryValue());
+
+        // bulb on/off updates:
+        for (let i = 0; i < bitsCount; i++){
+          const bulb = document.getElementById(`bulb-${i}`);
+          if (bulb) bulb.classList.toggle("on", !!bitStates[i]);
+        }
+      }
+
+      // ---------- DOM build for bits grid ----------
+      function setBitsGridColumns(){
+        const grid = document.getElementById("bitsGrid");
+        // make it adapt (up to 16 per row max, then wraps)
+        const cols = clamp(bitsCount, 4, 16);
+        grid.style.gridTemplateColumns = `repeat(${cols}, 1fr)`;
+      }
+
+      function buildBitsGrid(){
+        const grid = document.getElementById("bitsGrid");
+        grid.innerHTML = "";
+
+        setBitsGridColumns();
+
+        const values = getPlaceValues();
+
+        for (let i = 0; i < bitsCount; i++){
+          const v = values[i];
+
+          const bit = document.createElement("div");
+          bit.className = "bit";
+
+          const bulb = document.createElement("div");
+          bulb.className = "bulb";
+          bulb.id = `bulb-${i}`;
+          bulb.setAttribute("aria-hidden", "true");
+
+          const val = document.createElement("div");
+          val.className = "bitVal num";
+          // show absolute label for MSB in twos? No — show the actual negative value (clear to students).
+          val.textContent = String(v);
+
+          // IMPORTANT: bit switch must be the SAME style as MODE switch
+          const label = document.createElement("label");
+          label.className = "switch";
+          label.setAttribute("aria-label", `Toggle bit ${v}`);
+
+          const input = document.createElement("input");
+          input.type = "checkbox";
+          input.dataset.index = String(i);
+          input.checked = !!bitStates[i];
+
+          const slider = document.createElement("span");
+          slider.className = "slider";
+
+          input.addEventListener("change", () => {
+            bitStates[i] = input.checked;
+            updateReadout();
+          });
+
+          label.appendChild(input);
+          label.appendChild(slider);
+
+          bit.appendChild(bulb);
+          bit.appendChild(val);
+          bit.appendChild(label);
+          grid.appendChild(bit);
+        }
+
+        updateReadout();
+      }
+
+      // ---------- Set state from binary / denary ----------
+      function setFromBinary(bin){
+        const clean = String(bin).replace(/\s+/g, "");
+        if (!/^[01]+$/.test(clean)) return false;
+
+        const padded = clean.slice(-bitsCount).padStart(bitsCount, "0");
+        bitStates = [...padded].map(ch => ch === "1");
+
+        // update toggles without rebuilding
+        for (let i = 0; i < bitsCount; i++){
+          const toggle = document.querySelector(`input[type="checkbox"][data-index="${i}"]`);
+          if (toggle) toggle.checked = bitStates[i];
+        }
+        updateReadout();
+        return true;
+      }
+
+      function setFromDenary(n){
+        const num = Number(n);
+        if (!Number.isInteger(num)) return false;
+
+        const { min, max } = rangeForMode();
+        if (num < min || num > max) return false;
+
+        // convert to bit pattern
+        let unsignedVal;
+        if (!isTwos){
+          unsignedVal = num;
+        } else {
+          // two's complement representation
+          unsignedVal = num < 0 ? (pow2(bitsCount) + num) : num;
+        }
+
+        // build MSB->LSB bits from unsignedVal
+        const newBits = [];
+        for (let i = 0; i < bitsCount; i++){
+          const power = bitsCount - 1 - i;
+          const bit = Math.floor(unsignedVal / pow2(power)) % 2;
+          newBits.push(bit === 1);
+        }
+        bitStates = newBits;
+
+        for (let i = 0; i < bitsCount; i++){
+          const toggle = document.querySelector(`input[type="checkbox"][data-index="${i}"]`);
+          if (toggle) toggle.checked = bitStates[i];
+        }
+        updateReadout();
+        return true;
+      }
+
+      // ---------- Shifts ----------
+      function shiftLeft(){
+        // logical left shift: drop MSB, add 0 at LSB
+        bitStates = bitStates.slice(1).concat(false);
+        buildBitsGrid(); // rebuild keeps labels correct if mode changed (also updates bulbs)
+      }
+
+      function shiftRight(){
+        if (!isTwos){
+          // logical right shift
+          bitStates = [false].concat(bitStates.slice(0, -1));
+        } else {
+          // arithmetic right shift (preserve MSB)
+          const msb = bitStates[0];
+          bitStates = [msb].concat(bitStates.slice(0, -1));
+        }
+        buildBitsGrid();
+      }
+
+      // ---------- Bit width ----------
+      function applyBitsCount(next){
+        const wanted = clamp(Number(next) || 8, 4, 64);
+        if (wanted === bitsCount) return;
+
+        // keep the right-most (LSB) bits when resizing (feels natural)
+        const old = binaryString();
+        bitsCount = wanted;
+
+        // rebuild state from old binary, keeping LSBs
+        const padded = old.slice(-bitsCount).padStart(bitsCount, "0");
+        bitStates = [...padded].map(ch => ch === "1");
+
+        document.getElementById("bitsField").value = String(bitsCount);
+        buildBitsGrid();
+      }
+
+      // ---------- Mode toggle ----------
+      function applyMode(nextIsTwos){
+        const prevDenary = denaryValue(); // keep the *value* if possible
+        isTwos = !!nextIsTwos;
+
+        // Try to keep the denary value, but clamp if it becomes invalid in the new mode
+        const { min, max } = rangeForMode();
+        const kept = clamp(prevDenary, min, max);
+        setFromDenary(kept);
+
+        buildBitsGrid();
+      }
+
+      // ---------- Wire up UI ----------
+      function wireUI(){
+        document.getElementById("btnShiftLeft").addEventListener("click", shiftLeft);
+        document.getElementById("btnShiftRight").addEventListener("click", shiftRight);
+
+        document.getElementById("btnCustomBinary").addEventListener("click", () => {
+          const val = prompt(`Enter a binary number (up to ${bitsCount} bits):`);
+          if (val === null) return;
+          if (!setFromBinary(val)) alert("Invalid input. Use only 0 and 1.");
+        });
+
+        document.getElementById("btnCustomDenary").addEventListener("click", () => {
+          const { min, max } = rangeForMode();
+          const val = prompt(`Enter a denary number (${min} to ${max}):`);
+          if (val === null) return;
+          if (!setFromDenary(val)) alert(`Invalid input. Enter an integer from ${min} to ${max}.`);
+        });
+
+        // Mode toggle
+        const modeToggle = document.getElementById("modeToggle");
+        modeToggle.addEventListener("change", () => applyMode(modeToggle.checked));
+
+        // Bit width +/- and manual entry
+        document.getElementById("btnBitsDown").addEventListener("click", () => applyBitsCount(bitsCount - 1));
+        document.getElementById("btnBitsUp").addEventListener("click", () => applyBitsCount(bitsCount + 1));
+
+        const bitsField = document.getElementById("bitsField");
+        bitsField.addEventListener("change", () => applyBitsCount(bitsField.value));
+        bitsField.addEventListener("blur", () => applyBitsCount(bitsField.value));
+        bitsField.addEventListener("keydown", (e) => {
+          if (e.key === "Enter") applyBitsCount(bitsField.value);
+        });
+      }
+
+      // ---------- Init ----------
+      function init(){
+        // default: 8-bit unsigned
+        bitsCount = 8;
+        isTwos = false;
+        bitStates = Array(bitsCount).fill(false);
+
+        document.getElementById("modeToggle").checked = false;
+        document.getElementById("bitsField").value = String(bitsCount);
+
+        wireUI();
+        buildBitsGrid();
+      }
+
+      init();
+    </script>
+  </body>
+</html>

src/scripts/binary.js

@@ -1,347 +0,0 @@
-const bitsGrid = document.getElementById("bitsGrid");
-const denaryEl = document.getElementById("denaryNumber");
-const binaryEl = document.getElementById("binaryNumber");
-
-const modeToggle = document.getElementById("modeToggle");
-const modeHint = document.getElementById("modeHint");
-
-const bitsInput = document.getElementById("bitsInput");
-const btnBitsUp = document.getElementById("btnBitsUp");
-const btnBitsDown = document.getElementById("btnBitsDown");
-
-const btnShiftLeft = document.getElementById("btnShiftLeft");
-const btnShiftRight = document.getElementById("btnShiftRight");
-const btnCustomBinary = document.getElementById("btnCustomBinary");
-const btnCustomDenary = document.getElementById("btnCustomDenary");
-
-const btnClear = document.getElementById("btnClear");
-const btnMinus1 = document.getElementById("btnMinus1");
-const btnPlus1 = document.getElementById("btnPlus1");
-const btnAutoRandom = document.getElementById("btnAutoRandom");
-
-let bitCount = clampInt(Number(bitsInput?.value ?? 8), 1, 64);
-let isTwos = Boolean(modeToggle?.checked);
-
-let bits = new Array(bitCount).fill(false); // MSB at index 0
-let autoTimer = null;
-
-function clampInt(n, min, max){
-  n = Number(n);
-  if (!Number.isFinite(n)) return min;
-  n = Math.trunc(n);
-  return Math.max(min, Math.min(max, n));
-}
-
-/* ----------------------------
-   Label values (MSB..LSB)
-   Unsigned: [2^(n-1) ... 1]
-   Two's:   [-2^(n-1), 2^(n-2) ... 1]
------------------------------ */
-function getLabelValues(){
-  const vals = [];
-  for (let i = 0; i < bitCount; i++){
-    const pow = bitCount - 1 - i;
-    let v = 2 ** pow;
-    if (isTwos && i === 0) v = -v; // ✅ MSB label becomes negative
-    vals.push(v);
-  }
-  return vals;
-}
-
-function buildBits(){
-  // wrap every 8 bits
-  bitsGrid.style.setProperty("--cols", String(Math.min(8, bitCount)));
-
-  bitsGrid.innerHTML = "";
-  const labelValues = getLabelValues();
-
-  for (let i = 0; i < bitCount; i++){
-    const bit = document.createElement("div");
-    bit.className = "bit";
-    bit.innerHTML = `
-      <div class="bulb" id="bulb-${i}" aria-hidden="true">💡</div>
-      <div class="bitVal num" id="label-${i}">${labelValues[i]}</div>
-      <label class="switch" aria-label="Toggle bit">
-        <input type="checkbox" data-index="${i}">
-        <span class="slider"></span>
-      </label>
-    `;
-    bitsGrid.appendChild(bit);
-  }
-
-  // hook switches
-  bitsGrid.querySelectorAll('input[type="checkbox"][data-index]').forEach((input) => {
-    input.addEventListener("change", () => {
-      const idx = Number(input.dataset.index);
-      bits[idx] = input.checked;
-      updateUI();
-    });
-  });
-
-  updateUI();
-}
-
-function setLabels(){
-  const labelValues = getLabelValues();
-  for (let i = 0; i < bitCount; i++){
-    const el = document.getElementById(`label-${i}`);
-    if (el) el.textContent = String(labelValues[i]);
-  }
-}
-
-function bitsToUnsigned(){
-  let n = 0;
-  for (let i = 0; i < bitCount; i++){
-    if (!bits[i]) continue;
-    const pow = bitCount - 1 - i;
-    n += 2 ** pow;
-  }
-  return n;
-}
-
-function bitsToTwos(){
-  // Two's complement interpretation
-  // value = -MSB*2^(n-1) + sum(other set bits)
-  let n = 0;
-  for (let i = 0; i < bitCount; i++){
-    if (!bits[i]) continue;
-    const pow = bitCount - 1 - i;
-    const v = 2 ** pow;
-    if (i === 0) n -= v;
-    else n += v;
-  }
-  return n;
-}
-
-function getCurrentValue(){
-  return isTwos ? bitsToTwos() : bitsToUnsigned();
-}
-
-function setFromUnsignedValue(n){
-  // clamp to range of bitCount
-  const max = (2 ** bitCount) - 1;
-  n = clampInt(n, 0, max);
-
-  for (let i = 0; i < bitCount; i++){
-    const pow = bitCount - 1 - i;
-    const v = 2 ** pow;
-    if (n >= v){
-      bits[i] = true;
-      n -= v;
-    } else {
-      bits[i] = false;
-    }
-  }
-  syncSwitchesAndBulbs();
-  updateUI(false);
-}
-
-function setFromTwosValue(n){
-  // represent in two's complement with bitCount bits:
-  // allowed range: [-2^(n-1), 2^(n-1)-1]
-  const min = -(2 ** (bitCount - 1));
-  const max = (2 ** (bitCount - 1)) - 1;
-  n = clampInt(n, min, max);
-
-  // Convert to unsigned representation modulo 2^bitCount
-  const mod = 2 ** bitCount;
-  let u = ((n % mod) + mod) % mod;
-
-  // then set bits from unsigned u
-  for (let i = 0; i < bitCount; i++){
-    const pow = bitCount - 1 - i;
-    const v = 2 ** pow;
-    if (u >= v){
-      bits[i] = true;
-      u -= v;
-    } else {
-      bits[i] = false;
-    }
-  }
-  syncSwitchesAndBulbs();
-  updateUI(false);
-}
-
-function formatBinary(groupsOf = 4){
-  const raw = bits.map(b => (b ? "1" : "0")).join("");
-  // group for readability (keeps your “wrap every 8 bits” layout for switches;
-  // this just formats the readout)
-  let out = "";
-  for (let i = 0; i < raw.length; i++){
-    out += raw[i];
-    const isLast = i === raw.length - 1;
-    if (!isLast && (i + 1) % groupsOf === 0) out += " ";
-  }
-  return out.trim();
-}
-
-function syncSwitchesAndBulbs(){
-  // ✅ Bulbs always update (unsigned OR two's)
-  bitsGrid.querySelectorAll('input[type="checkbox"][data-index]').forEach((input) => {
-    const idx = Number(input.dataset.index);
-    input.checked = Boolean(bits[idx]);
-  });
-
-  for (let i = 0; i < bitCount; i++){
-    const bulb = document.getElementById(`bulb-${i}`);
-    if (bulb) bulb.classList.toggle("on", Boolean(bits[i]));
-  }
-}
-
-function updateUI(sync = true){
-  if (sync) syncSwitchesAndBulbs();
-
-  // labels update when mode changes
-  setLabels();
-
-  // readouts
-  const value = getCurrentValue();
-  denaryEl.textContent = String(value);
-  binaryEl.textContent = formatBinary(4);
-
-  // hint
-  if (isTwos){
-    modeHint.textContent = "Tip: In two’s complement, the left-most bit (MSB) represents a negative value.";
-  } else {
-    modeHint.textContent = "Tip: In unsigned binary, all bits represent positive values.";
-  }
-}
-
-/* ----------------------------
-   Controls
------------------------------ */
-btnShiftLeft?.addEventListener("click", () => {
-  // shift left: drop MSB, append 0 to LSB
-  bits.shift();
-  bits.push(false);
-  updateUI();
-});
-
-btnShiftRight?.addEventListener("click", () => {
-  // shift right: drop LSB, insert 0 at MSB
-  bits.pop();
-  bits.unshift(false);
-  updateUI();
-});
-
-btnClear?.addEventListener("click", () => {
-  bits = new Array(bitCount).fill(false);
-  updateUI();
-});
-
-btnMinus1?.addEventListener("click", () => {
-  const v = getCurrentValue();
-  if (isTwos) setFromTwosValue(v - 1);
-  else setFromUnsignedValue(v - 1);
-});
-
-btnPlus1?.addEventListener("click", () => {
-  const v = getCurrentValue();
-  if (isTwos) setFromTwosValue(v + 1);
-  else setFromUnsignedValue(v + 1);
-});
-
-btnAutoRandom?.addEventListener("click", () => {
-  // stop if already running
-  if (autoTimer){
-    clearInterval(autoTimer);
-    autoTimer = null;
-    btnAutoRandom.textContent = "Auto Random";
-    return;
-  }
-
-  btnAutoRandom.textContent = "Stop Random";
-
-  // run briefly then stop automatically
-  const start = Date.now();
-  const durationMs = 2200; // auto stop
-
-  autoTimer = setInterval(() => {
-    const now = Date.now();
-    if (now - start > durationMs){
-      clearInterval(autoTimer);
-      autoTimer = null;
-      btnAutoRandom.textContent = "Auto Random";
-      return;
-    }
-
-    // random within correct range for current mode
-    if (isTwos){
-      const min = -(2 ** (bitCount - 1));
-      const max = (2 ** (bitCount - 1)) - 1;
-      const n = Math.floor(Math.random() * (max - min + 1)) + min;
-      setFromTwosValue(n);
-    } else {
-      const max = (2 ** bitCount) - 1;
-      const n = Math.floor(Math.random() * (max + 1));
-      setFromUnsignedValue(n);
-    }
-  }, 90);
-});
-
-btnCustomBinary?.addEventListener("click", () => {
-  const v = prompt(`Enter a ${bitCount}-bit binary number (0/1):`);
-  if (v === null) return;
-
-  const clean = v.replace(/\s+/g, "");
-  if (!/^[01]+$/.test(clean)){
-    alert("Invalid binary. Use only 0 and 1.");
-    return;
-  }
-
-  const padded = clean.slice(-bitCount).padStart(bitCount, "0");
-  bits = [...padded].map(ch => ch === "1");
-  updateUI();
-});
-
-btnCustomDenary?.addEventListener("click", () => {
-  const v = prompt(isTwos
-    ? `Enter a denary number (${-(2 ** (bitCount - 1))} to ${(2 ** (bitCount - 1)) - 1}):`
-    : `Enter a denary number (0 to ${(2 ** bitCount) - 1}):`
-  );
-  if (v === null) return;
-
-  const n = Number(v);
-  if (!Number.isFinite(n) || !Number.isInteger(n)){
-    alert("Invalid denary. Enter a whole number.");
-    return;
-  }
-
-  if (isTwos) setFromTwosValue(n);
-  else setFromUnsignedValue(n);
-});
-
-/* ----------------------------
-   Mode + Bit width
------------------------------ */
-modeToggle?.addEventListener("change", () => {
-  isTwos = Boolean(modeToggle.checked);
-  // keep the same underlying bit pattern; just reinterpret and relabel
-  updateUI(false);
-});
-
-btnBitsUp?.addEventListener("click", () => {
-  bitCount = clampInt(bitCount + 1, 1, 64);
-  bitsInput.value = String(bitCount);
-  bits = new Array(bitCount).fill(false);
-  buildBits();
-});
-
-btnBitsDown?.addEventListener("click", () => {
-  bitCount = clampInt(bitCount - 1, 1, 64);
-  bitsInput.value = String(bitCount);
-  bits = new Array(bitCount).fill(false);
-  buildBits();
-});
-
-bitsInput?.addEventListener("change", () => {
-  bitCount = clampInt(Number(bitsInput.value), 1, 64);
-  bitsInput.value = String(bitCount);
-  bits = new Array(bitCount).fill(false);
-  buildBits();
-});
-
-/* ----------------------------
-   Init
------------------------------ */
-buildBits();

src/scripts/unsignedBinary.js

@@ -0,0 +1,54 @@
+let bits = [128,64,32,16,8,4,2,1];
+let state = Array(8).fill(0);
+
+const denaryEl = document.getElementById("denaryNumber");
+const binaryEl = document.getElementById("binaryNumber");
+const bitEls = document.querySelectorAll(".bit");
+
+bitEls.forEach((el, i) => {
+  el.addEventListener("click", () => {
+    state[i] = state[i] ? 0 : 1;
+    el.classList.toggle("on");
+    update();
+  });
+});
+
+function update() {
+  const denary = state.reduce((sum, bit, i) => sum + bit * bits[i], 0);
+  denaryEl.textContent = denary;
+  binaryEl.textContent = state.join("");
+}
+
+function requestBinary() {
+  const input = prompt("Enter 8-bit binary:");
+  if (!/^[01]{8}$/.test(input)) return;
+  state = input.split("").map(Number);
+  bitEls.forEach((el,i)=>el.classList.toggle("on",state[i]));
+  update();
+}
+
+function requestDenary() {
+  const input = parseInt(prompt("Enter denary (0–255)"),10);
+  if (isNaN(input) || input < 0 || input > 255) return;
+
+  let value = input;
+  state = bits.map(b => {
+    if (value >= b) {
+      value -= b;
+      return 1;
+    }
+    return 0;
+  });
+
+  bitEls.forEach((el,i)=>el.classList.toggle("on",state[i]));
+  update();
+}
+
+function shiftBinary(dir) {
+  if (dir === "left") state.shift(), state.push(0);
+  if (dir === "right") state.pop(), state.unshift(0);
+  bitEls.forEach((el,i)=>el.classList.toggle("on",state[i]));
+  update();
+}
+
+update();

src/styles/base.css

@@ -0,0 +1,52 @@
+/* src/styles/base.css */
+@import "./md3-tokens.css";
+html, body{ height:100%; }
+body{
+ margin:0;
+ font-family: var(--font-sans);
+ background: var(--md-surface-2);
+ color: var(--md-on-surface);
+}
+a{ color: var(--md-primary); text-decoration: none; }
+a:hover{ text-decoration: underline; }
+.container{
+ max-width: 1100px;
+ margin: 0 auto;
+ padding: 16px;
+}
+.card{
+ background: var(--md-surface);
+ border: 1px solid var(--md-outline);
+ border-radius: var(--radius-2);
+ box-shadow: var(--shadow-1);
+ padding: 16px;
+}
+.btn{
+ display:inline-flex;
+ gap:8px;
+ align-items:center;
+ justify-content:center;
+ border-radius: 999px;
+ border: 1px solid var(--md-outline);
+ background: var(--md-surface);
+ color: var(--md-on-surface);
+ padding: 10px 14px;
+ font-weight: 600;
+ cursor: pointer;
+}
+.btn:hover{ filter: brightness(0.98); }
+.btn:focus{ outline:none; box-shadow: var(--md-focus); }
+.btn-primary{
+ background: var(--md-primary);
+ color: var(--md-on-primary);
+ border-color: transparent;
+}
+.badge{
+ display:inline-block;
+ padding: 2px 10px;
+ border-radius: 999px;
+ font-size: 12px;
+ border: 1px solid var(--md-outline);
+ background: var(--md-surface-2);
+}
+code, pre{ font-family: var(--font-mono); }

src/styles/binary.css

@@ -1,297 +1,68 @@
-/* DSEG7ClassicRegular font */
-@font-face{
-  font-family: "DSEG7ClassicRegular";
-  src:
-    url("/fonts/DSEG7Classic-Regular.ttf") format("truetype"),
-    url("/fonts/DSEG7Classic-Regular.woff") format("woff");
-  font-weight: 400;
-  font-style: normal;
-  font-display: swap;
+.binary-container {
+  max-width: 1100px;
+  margin: auto;
+  padding: 2rem;
+  color: #e0e0e0;
 }
 
-.binary-wrap{
-  padding-top: 6px;
+.display {
+  text-align: center;
 }
 
-.topGrid{
-  display:grid;
-  grid-template-columns: 1fr 340px;
-  gap: 28px;
-  align-items:start;
+.label {
+  font-size: 1.2rem;
+  opacity: 0.7;
 }
 
-.readout{
-  background: transparent;
-  text-align:center;
-  padding: 10px 10px 0;
+.number {
+  font-size: 3rem;
+  margin-bottom: 1rem;
+  color: #00ff66;
 }
 
-.label{
-  letter-spacing: .18em;
-  font-weight: 800;
-  color: var(--muted);
-  text-transform: uppercase;
-  font-size: 13px;
-  margin-top: 10px;
+.controls {
+  margin-top: 1rem;
 }
 
-.num{
-  font-family: "DSEG7ClassicRegular", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
-  font-weight: 400;
-  color: var(--accent);
-  text-shadow: 0 0 18px var(--accent-dim);
+.controls button {
+  margin: 0.25rem;
+  padding: 0.6rem 1rem;
+  font-size: 1rem;
 }
 
-.denary{
-  font-size: 72px; /* smaller */
-  line-height: 1.0;
-  margin: 6px 0 10px;
+.bits {
+  display: grid;
+  grid-template-columns: repeat(8, 1fr);
+  gap: 1rem;
+  margin-top: 3rem;
 }
 
-.binary{
-  font-size: 46px; /* smaller */
-  letter-spacing: .12em;
-  line-height: 1.15;
-  margin: 6px 0 14px;
-  white-space: pre-wrap;
-  word-break: break-word;
-  display:inline-block;
-  text-align:center;
-}
-
-.controls{
-  margin-top: 8px;
-  display:flex;
-  justify-content:center;
-  gap: 12px;
-  flex-wrap: wrap;
-}
-
-.controls--twoRows{
-  flex-direction: column;
-  gap: 10px;
-}
-
-.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: 800;
+.bit {
+  width: 40px;
+  height: 80px;
+  background: #333;
+  border-radius: 20px;
+  position: relative;
   cursor: pointer;
-  min-width: 160px;
 }
 
-.btn:active{ transform: translateY(1px); }
-
-.btn--green{
-  background: rgba(51,255,122,.16);
-  border-color: rgba(51,255,122,.45);
+.bit::after {
+  content: "";
+  width: 32px;
+  height: 32px;
+  background: #555;
+  border-radius: 50%;
+  position: absolute;
+  bottom: 6px;
+  left: 4px;
+  transition: all 0.2s ease;
 }
 
-.btn--green:hover{
-  background: rgba(51,255,122,.22);
+.bit.on {
+  background: #00c853;
 }
 
-.btn--spin{
-  min-width: 120px;
-  font-size: 18px; /* bigger */
-}
-
-.divider{
-  margin-top: 22px;
-  border-top: 1px solid var(--line);
-}
-
-.panelCol{
-  display:flex;
-  flex-direction:column;
-  gap: 14px;
-}
-
-.card{
-  background: var(--panel);
-  border: 1px solid var(--panel-border);
-  border-radius: 14px;
-  padding: 14px;
-}
-
-.cardTitle{
-  letter-spacing: .18em;
-  font-weight: 900;
-  color: var(--muted);
-  text-transform: uppercase;
-  font-size: 12px;
-  margin: 0 0 10px;
-}
-
-.hint{
-  color: var(--muted);
-  font-size: 12px;
-  margin-top: 8px;
-  line-height: 1.35;
-}
-
-.toggleRow{
-  display:flex;
-  align-items:center;
-  justify-content:space-between;
-  gap: 10px;
-}
-
-.toggleLabel{
-  color: var(--text);
-  font-weight: 800;
-  font-size: 14px;
-}
-
-.switch{
-  position:relative;
-  width:56px;
-  height:34px;
-  display:inline-block;
-  flex:0 0 auto;
-}
-.switch input{
-  opacity:0;
-  width:0;
-  height:0;
-}
-.slider{
-  position:absolute;
-  inset:0;
-  background: rgba(255,255,255,.10);
-  border: 1px solid rgba(255,255,255,.14);
-  border-radius:999px;
-  transition:.18s ease;
-}
-.slider::before{
-  content:"";
-  position:absolute;
-  height:28px;
-  width:28px;
-  left:3px;
-  top:2px;
-  background: rgba(255,255,255,.92);
-  border-radius:50%;
-  transition:.18s ease;
-}
-.switch input:checked + .slider{
-  background: rgba(51,255,122,.20);
-  border-color: rgba(51,255,122,.55);
-}
-.switch input:checked + .slider::before{
-  transform: translateX(22px);
-  background: var(--accent);
-}
-
-.bitWidthRow{
-  display:grid;
-  grid-template-columns:44px 1fr 44px;
-  gap:10px;
-  align-items:center;
-}
-
-.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;
-}
-
-.bitInputWrap{
-  background: rgba(255,255,255,.06);
-  border: 1px solid rgba(255,255,255,.14);
-  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:900;
-  letter-spacing:.18em;
-  text-transform:uppercase;
-}
-
-.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 */
-.bits{
-  --cols: 8;
-  margin-top: 26px;
-  padding-top: 18px;
-  display:grid;
-  grid-template-columns: repeat(var(--cols), 90px);
-  justify-content: center; /* centres when < 8 too */
-  gap: 18px;
-  align-items:end;
-  text-align:center;
-}
-
-.bit{
-  display:flex;
-  flex-direction:column;
-  align-items:center;
-  gap: 10px;
-  padding: 8px 4px;
-}
-
-/* Bulb emoji bigger */
-.bulb{
-  font-size: 26px;      /* bigger */
-  line-height: 1;
-  filter: grayscale(1);
-  opacity: .35;
-  transform: translateY(2px);
-}
-.bulb.on{
-  filter: grayscale(0);
-  opacity: 1;
-  text-shadow: 0 0 16px rgba(255,216,107,.55);
-}
-
-.bitVal{
-  font-size: 28px;
-  color: var(--text);
-  opacity: .95;
-  line-height: 1;
-  min-height: 34px;
-}
-
-@media (max-width: 980px){
-  .topGrid{ grid-template-columns: 1fr; }
-  .denary{ font-size: 62px; }
-  .binary{ font-size: 40px; }
+.bit.on::after {
+  bottom: 42px;
+  background: #eaffea;
 }

src/styles/fonts.css

@@ -0,0 +1,11 @@
+@font-face {
+  font-family: "DSEG7";
+  src: url("/fonts/DSEG7Classic-Regular.ttf") format("truetype");
+  font-weight: normal;
+  font-style: normal;
+}
+
+.dseg {
+  font-family: "DSEG7", monospace;
+  letter-spacing: 0.15em;
+}

src/styles/global.css

@@ -1,85 +0,0 @@
-: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/styles/md3-tokens.css

@@ -0,0 +1,43 @@
+/* src/styles/md3-tokens.css */
+/* MD3-inspired tokens tuned for education: high readability, clear contrast, calm surfaces */
+:root{
+ /* Typography */
+ --font-sans: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+ --font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
+ /* Spacing + shape */
+ --radius-1: 10px;
+ --radius-2: 16px;
+ --radius-3: 22px;
+ --shadow-1: 0 1px 2px rgba(0,0,0,.08), 0 2px 8px rgba(0,0,0,.06);
+ /* Color roles (keep simple) */
+ --md-surface: #ffffff;
+ --md-surface-2: #f6f7fb;
+ --md-on-surface: #111318;
+ --md-primary: #2f6fed; /* calm blue */
+ --md-on-primary: #ffffff;
+ --md-secondary: #5a5f72; /* muted */
+ --md-on-secondary: #ffffff;
+ --md-tertiary: #0f766e; /* teal for "practical" tools */
+ --md-on-tertiary: #ffffff;
+ --md-outline: #d7dbe7;
+ --md-success: #1a7f37;
+ --md-warning: #b54708;
+ --md-danger: #b42318;
+ /* Focus ring for accessibility */
+ --md-focus: 0 0 0 3px rgba(47,111,237,.28);
+}
+@media (prefers-color-scheme: dark){
+ :root{
+ --md-surface: #0b0e14;
+ --md-surface-2: #121725;
+ --md-on-surface: #e8eaf2;
+ --md-primary: #9bb6ff;
+ --md-on-primary: #0b0e14;
+ --md-secondary: #b8bccd;
+ --md-on-secondary: #0b0e14;
+ --md-tertiary: #4fd1c5;
+ --md-on-tertiary: #0b0e14;
+ --md-outline: #2b3244;
+ --md-focus: 0 0 0 3px rgba(155,182,255,.25);
+ }
+}

src/styles/site.css

@@ -1,75 +0,0 @@
-: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;
-}