Merge branch 'main' into dependabot/npm_and_yarn/storybook-8.6.15

* feat: initial functions for exporting to txt

* feat: add save as text to calendar header new export option

* docs: comment for saveAsText()

* feat: generate text line by line for each course

* docs: jsdoc

* chore: lint

* Apply suggestion from @doprz

---------

Co-authored-by: Diego Perez <52579214+doprz@users.noreply.github.com>

.editorconfig

@@ -7,3 +7,6 @@ insert_final_newline = true
 trim_trailing_whitespace = true
 indent_size = 4
 indent_style = space
+
+[*.{nix,yaml,yml}]
+indent_size = 2

.env.example

@@ -0,0 +1,3 @@
+SENTRY_ORG=longhorn-developers
+SENTRY_PROJECT=ut-registration-plus
+SENTRY_AUTH_TOKEN=

.envrc

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

.eslintignore

@@ -94,3 +94,5 @@ typings/
 config
 .eslintrc.js
 !.storybook
+
+src/lib/chrome-extension-toolkit

.eslintrc.cjs

@@ -205,7 +205,7 @@ module.exports = {
                     {
                         target: './src/shared',
                         from: './',
-                        except: ['./src/shared', './node_modules'],
+                        except: ['./src/shared', './node_modules', './src/lib/chrome-extension-toolkit'],
                         message: 'You cannot import into `shared` from an external directory.',
                     },
                 ],
@@ -227,6 +227,6 @@ module.exports = {
         'simple-import-sort/imports': 'error',
         'simple-import-sort/exports': 'error',
         'import-essentials/restrict-import-depth': 'error',
-        'import-essentials/check-path-alias': 'error',
+        // 'import-essentials/check-path-alias': 'error',
     },
 };

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,21 +1,20 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: "[BUG] "
+title: '[BUG] '
 labels: ''
 assignees: ''
-
 ---
 
 **Pre-submission Checklist**
 
 <!-- Please check all applicable boxes before submitting your issue -->
 
--   [ ] I have searched existing issues to make sure this is not a duplicate
+- [ ] I have searched existing issues to make sure this is not a duplicate
--   [ ] I have cleared my browser cache and confirmed the issue persists
+- [ ] I have cleared my browser cache and confirmed the issue persists
--   [ ] I have checked this issue affects the latest version of the extension
+- [ ] I have checked this issue affects the latest version of the extension
--   [ ] I have disabled other extensions to ensure this isn't a conflict issue
+- [ ] I have disabled other extensions to ensure this isn't a conflict issue
--   [ ] I have included all the information requested below
+- [ ] I have included all the information requested below
 
 **Bug Description**
 
@@ -30,11 +29,11 @@ assignees: ''
 
 **Expected Behavior**
 
-<!-- A clear and concise description of what you expected to happen -->
+<!-- What you expected to happen -->
 
 **Current Behavior**
 
-<!-- A clear and concise description of what actually happened -->
+<!-- What actually happened -->
 
 **Screenshots**
 
@@ -42,9 +41,9 @@ assignees: ''
 
 **Debug Information**
 
--   UTRP Extension Version: [e.g. 1.2.0]
+- UTRP Extension Version: [e.g. 1.2.0]
--   Browser Info: [e.g. Chrome 120.0.0]
+- Browser Info: [e.g. Chrome 120.0.0]
--   OS: [e.g. Windows 11, macOS Sonoma]
+- OS: [e.g. Windows 11, macOS Sonoma]
 
 **Console Logs**
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,34 +1,29 @@
 ---
 name: Feature Request
 about: Suggest an idea for this project
-title: "[FEATURE] "
+title: '[FEATURE] '
 labels: feature
 assignees: ''
-
 ---
 
 **Pre-submission Checklist**
 
 <!-- Please check all applicable boxes before submitting your feature request -->
 
--   [ ] I have searched existing issues to ensure this feature hasn't been requested
+- [ ] I have searched existing issues to ensure this feature hasn't been requested
--   [ ] I have searched closed issues to check if this was previously rejected/implemented
+- [ ] I have searched closed issues to check if this was previously rejected/implemented
--   [ ] I have checked the project roadmap (if available) for planned similar features
+- [ ] I have checked the project roadmap (if available) for planned similar features
--   [ ] I have reviewed the documentation to confirm this feature doesn't exist
+- [ ] I have reviewed the documentation to confirm this feature doesn't exist
--   [ ] I have completed all sections below with detailed information
+- [ ] I have completed all sections below with detailed information
 
-**Feature Description**
+**Your Idea**
 
-<!-- A clear and concise description of the feature you'd like to see -->
+<!-- A clear and concise description of the feature you'd like to see, and how it would work -->
-
-**Proposed Solution**
-
-<!-- A clear and concise description of what you want to happen -->
 
 **UI/UX Considerations**
 
-<!-- If this feature involves UI changes, please describe the visual aspects -->
+<!-- If this feature involves UI changes (aka how it looks), please describe the visual aspects -->
 
-**Technical Implementation Details**
+**Other**
 
-<!-- If you have specific technical suggestions, list them here -->
+<!-- Any other comments you have can go here! -->

.github/ISSUE_TEMPLATE/updating-build-dependencies.md

@@ -4,7 +4,6 @@ about: Updating Build Dependencies
 title: ''
 labels: build, dependencies
 assignees: doprz, Razboy20
-
 ---
 
 - [ ] Updated Nix Flake

.github/dependabot.yml

@@ -1,21 +1,20 @@
 version: 2
 updates:
-    - package-ecosystem: 'npm'
+  - package-ecosystem: 'npm'
-      directory: '/'
+    directory: '/'
-      schedule:
+    schedule:
-          interval: 'weekly'
+      interval: 'weekly'
-          day: 'monday'
+      day: 'monday'
-          time: '09:00'
+      time: '09:00'
-          timezone: 'America/Chicago'
+      timezone: 'America/Chicago'
-      groups:
+    groups:
-          minor-and-patch-updates:
+      minor-and-patch-updates:
-              update-types:
+        update-types:
-                  - 'minor'
+          - 'minor'
-                  - 'patch'
+          - 'patch'
-          major-updates:
+      major-updates:
-              update-types:
+        update-types:
-                  - 'major'
+          - 'major'
-
+    ignore:
-      ignore:
+      - dependency-name: '@crxjs/vite-plugin'
-         - dependency-name: '@crxjs/vite-plugin'
+      - dependency-name: '@unocss/vite'
-         - dependency-name: '@unocss/vite'

.github/workflows/best-practices.yml

@@ -1,43 +1,33 @@
 name: Best Practices
-
 on: [push, pull_request]
-
 jobs:
-    lint:
+  lint:
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+    steps:
-        steps:
+      - name: Checkout code
-            - name: Checkout code
+        uses: actions/checkout@v4
-              uses: actions/checkout@v4
+        with:
-              with:
+          fetch-depth: 0
-                  fetch-depth: 0
+      - name: Setup pnpm
-
+        uses: pnpm/action-setup@v4
-            - name: Setup pnpm
+        with:
-              uses: pnpm/action-setup@v4
+          version: 10
-              with:
+      - name: Install dependencies
-                  version: 10
+        run: pnpm install
-
+      - name: Run ESLint
-            - name: Install dependencies
+        run: pnpm run lint
-              run: pnpm install
+  format:
-
+    runs-on: ubuntu-latest
-            - name: Run ESLint
+    steps:
-              run: pnpm run lint
+      - name: Checkout code
-    format:
+        uses: actions/checkout@v4
-        runs-on: ubuntu-latest
+        with:
-
+          fetch-depth: 0
-        steps:
+      - name: Setup pnpm
-            - name: Checkout code
+        uses: pnpm/action-setup@v4
-              uses: actions/checkout@v4
+        with:
-              with:
+          version: 10
-                  fetch-depth: 0
+      - name: Install dependencies
-
+        run: pnpm install
-            - name: Setup pnpm
+      - name: Run Prettier
-              uses: pnpm/action-setup@v4
+        run: pnpm run prettier
-              with:
-                  version: 10
-
-            - name: Install dependencies
-              run: pnpm install
-
-            - name: Run Prettier
-              run: pnpm run prettier

.github/workflows/check-types.yml

@@ -1,24 +1,18 @@
 name: Type Check
-
 on: [push, pull_request]
-
 jobs:
-    type-check:
+  type-check:
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+    steps:
-        steps:
+      - name: Checkout code
-            - name: Checkout code
+        uses: actions/checkout@v4
-              uses: actions/checkout@v4
+        with:
-              with:
+          fetch-depth: 0
-                  fetch-depth: 0
+      - name: Setup pnpm
-
+        uses: pnpm/action-setup@v4
-            - name: Setup pnpm
+        with:
-              uses: pnpm/action-setup@v4
+          version: 10
-              with:
+      - name: Install dependencies
-                  version: 10
+        run: pnpm install
-
+      - name: Run tests
-            - name: Install dependencies
+        run: pnpm run check-types
-              run: pnpm install
-
-            - name: Run tests
-              run: pnpm run check-types

.github/workflows/chromatic.yml

@@ -1,26 +1,22 @@
 name: 'Chromatic'
-
 on: [push, pull_request]
-
 jobs:
-    chromatic:
+  chromatic:
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-        steps:
+    steps:
-            - name: Checkout code
+      - name: Checkout code
-              uses: actions/checkout@v4
+        uses: actions/checkout@v4
-              with:
+        with:
-                  fetch-depth: 0
+          fetch-depth: 0
-            - name: Setup pnpm
+      - name: Setup pnpm
-              uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v4
-              with:
+        with:
-                  version: 10
+          version: 10
-
+      - name: Install dependencies
-            - name: Install dependencies
+        run: pnpm install
-              run: pnpm install
+      - name: Publish to Chromatic
-
+        uses: chromaui/action@latest
-            - name: Publish to Chromatic
+        with:
-              uses: chromaui/action@latest
+          projectToken: chpt_e8bd07b0b27d8eb
-              with:
+          exitZeroOnChanges: true
-                  projectToken: chpt_e8bd07b0b27d8eb
+          autoAcceptChanges: 'main'
-                  exitZeroOnChanges: true
-                  autoAcceptChanges: 'main'

.github/workflows/release.yml

@@ -1,25 +1,24 @@
 name: Create Release
 on:
-    push:
+  push:
-        branches:
+    branches:
-            - production
+      - production
-            - preview
+      - preview
 jobs:
-    build:
+  build:
-        name: build extension & create release
+    name: build extension & create release
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-        concurrency:
+    concurrency:
-            group: ${{ github.ref }}
+      group: ${{ github.ref }}
-            cancel-in-progress: true
+      cancel-in-progress: true
-        steps:
+    steps:
-            - uses: actions/checkout@master
+      - uses: actions/checkout@master
-            - name: Get file permission
+      - name: Get file permission
-              run: chmod -R 777 .
+        run: chmod -R 777 .
-
+      - name: Install dependencies
-            - name: Install dependencies
+        run: npm ci
-              run: npm ci
+      - name: Release with semantic-release
-            - name: Release with semantic-release
+        id: semantic-release
-              id: semantic-release
+        run: npx --no-install semantic-release
-              run: npx --no-install semantic-release
+        env:
-              env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yml

@@ -1,24 +1,18 @@
 name: Tests
-
 on: [push, pull_request]
-
 jobs:
-    test:
+  test:
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+    steps:
-        steps:
+      - name: Checkout code
-            - name: Checkout code
+        uses: actions/checkout@v4
-              uses: actions/checkout@v4
+        with:
-              with:
+          fetch-depth: 0
-                  fetch-depth: 0
+      - name: Setup pnpm
-
+        uses: pnpm/action-setup@v4
-            - name: Setup pnpm
+        with:
-              uses: pnpm/action-setup@v4
+          version: 10
-              with:
+      - name: Install dependencies
-                  version: 10
+        run: pnpm install
-
+      - name: Run tests
-            - name: Install dependencies
+        run: pnpm test
-              run: pnpm install
-
-            - name: Run tests
-              run: pnpm test

.github/workflows/validate-pr.yml

@@ -1,43 +1,40 @@
 name: Validate PR Title
-
 # thank you ben limmer for this workflow:
 # https://github.com/blimmer/semantic-release-demo-2/blob/main/.github/workflows/lint-pr.yml
-
 on:
-    pull_request_target:
+  pull_request_target:
-        types:
+    types:
-            - opened
+      - opened
-            - reopened
+      - reopened
-            - edited
+      - edited
-            - synchronize
+      - synchronize
-
 jobs:
-    main:
+  main:
-        runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-        steps:
+    steps:
-            - uses: amannn/action-semantic-pull-request@v3.2.6
+      - uses: amannn/action-semantic-pull-request@v3.2.6
-              env:
+        env:
-                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-            - name: Post Conventional Commit Comment (on failure)
+      - name: Post Conventional Commit Comment (on failure)
-              uses: jungwinter/comment@v1
+        uses: jungwinter/comment@v1
-              id: conventional-commit-help
+        id: conventional-commit-help
-              with:
+        with:
-                  type: create
+          type: create
-                  issue_number: ${{ github.event.pull_request.number }}
+          issue_number: ${{ github.event.pull_request.number }}
-                  token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ secrets.GITHUB_TOKEN }}
-                  body: |
+          body: |
-                      Your pull request title did not conform to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/) standards. Our upcoming automated release pipeline will automatically determine
+            Your pull request title did not conform to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/) standards. Our upcoming automated release pipeline will automatically determine
-                      the proper release version based on your pull request title.
+            the proper release version based on your pull request title.
-                      **Cheat Sheet**
+            **Cheat Sheet**
-                      - feat: A new feature
+            - feat: A new feature
-                      - fix: A bug fix
+            - fix: A bug fix
-                      - docs: Documentation only changes
+            - docs: Documentation only changes
-                      - style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+            - style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
-                      - refactor: A code change that neither fixes a bug nor adds a feature
+            - refactor: A code change that neither fixes a bug nor adds a feature
-                      - perf: A code change that improves performance
+            - perf: A code change that improves performance
-                      - test: Adding missing tests or correcting existing tests
+            - test: Adding missing tests or correcting existing tests
-                      - build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
+            - build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
-                      - ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
+            - ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
-                      - chore: Other changes that don't modify src or test files
+            - chore: Other changes that don't modify src or test files
-                      - revert: Reverts a previous commit
+            - revert: Reverts a previous commit
-              if: ${{ failure() }}
+        if: ${{ failure() }}

.gitignore

@@ -211,3 +211,10 @@ sketch
 package-lock.json
 storybook-static/
 package/
+
+# Nix
+result
+result-*
+
+# direnv
+.direnv

.storybook/vite-storybook.config.ts

@@ -23,6 +23,7 @@ export default defineConfig({
             '@shared': resolve(root, 'shared'),
             '@background': resolve(pagesDir, 'background'),
             '@views': resolve(root, 'views'),
+            '@chrome-extension-toolkit': resolve(root, 'lib/chrome-extension-toolkit'),
         },
     },
 });

.vscode/launch.json

@@ -6,13 +6,9 @@
             "request": "launch",
             "name": "Run current script",
             "runtimeExecutable": "npx",
-            "runtimeArgs": [
+            "runtimeArgs": ["tsx"],
-                "tsx"
-            ],
             "program": "${file}",
-            "skipFiles": [
+            "skipFiles": ["<node_internals>/**"]
-                "<node_internals>/**"
-            ],
         }
     ]
-}
+}

.vscode/settings.json

@@ -26,7 +26,7 @@
         "navigation": "Routes",
         "logging": "log",
         "popup": "Layout",
-        "storage": "Database",
+        "storage": "Database"
     },
     "material-icon-theme.files.associations": {
         "tsconfig.extension.json": "tsconfig",
@@ -36,5 +36,5 @@
     "[html]": {
         "editor.defaultFormatter": "esbenp.prettier-vscode"
     },
-    "typescript.tsdk": "node_modules/typescript/lib",
+    "typescript.tsdk": "node_modules/typescript/lib"
 }

CHANGELOG.md

@@ -1,9 +1,43 @@
+## [2.3.0](https://github.com/Longhorn-Developers/UT-Registration-Plus/compare/v2.2.2...v2.3.0) (2026-01-07)
+
+### Features
+
+* add drag-and-drop import for schedules ([#661](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/661)) ([549c52a](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/549c52a39fee718f2bb07cfce33a294835a2246b)), closes [#446](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/446)
+* allow bypassing the 10-schedule limit ([#675](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/675)) ([6a67a32](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/6a67a32e4f50a5bdd20aa43789f199b822483e2d))
+* condense resourceLinks course schedule ([#676](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/676)) ([cee5f02](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/cee5f0284f09f39ca5ae64559d0b697646c77e74))
+* LHD birthday ([#717](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/717)) ([2d18553](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/2d18553f98c5146fa18699ae20462e7dcbc9d35c))
+* **nix:** add prettier-version-match check ([#713](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/713)) ([8ccf7fb](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/8ccf7fb37e769ba445f39c140ca9c1c4245cc1c1))
+* **nix:** build UTRP ([#714](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/714)) ([38bb29b](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/38bb29b20b97ed3cf8fd6511df16553fed1d58bb))
+
+### Bug Fixes
+
+* .editorconfig syntax for nix files ([b406d4d](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/b406d4dd244a25688c2b9621cf5d441228bd8913))
+* toSorted outdated chrome bug  ([#694](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/694)) ([4f5d8c6](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/4f5d8c6d20e3cfeb7b62520ba1819e297d2cc60f))
+## [2.2.2](https://github.com/Longhorn-Developers/UT-Registration-Plus/compare/v2.2.1...v2.2.2) (2025-10-13)
+
+### Features
+
+* add nix flake ([#593](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/593)) ([7b401ad](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/7b401add1565ff401bad99745ff9e53b9a7f899f))
+* automatically select new or duplicated schedules ([#583](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/583)) ([#589](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/589)) ([2a50f55](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/2a50f5580d3dbeb0d66546c23cf29bbb37d80da2))
+* **env:** add SENTRY env vars ([8f7e1bc](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/8f7e1bc0af6336549068e02b80df21d4e8f4ef9c))
+* export schedule button add to calendar ([#594](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/594)) ([5994ded](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/5994ded8be876cb55174d27d3fdb0832b21a0ff9))
+* **release:** v2.2.2 ([c21cbd7](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/c21cbd77f0764c03a711589ff4f957cb8c936eec))
+* search result shading ([#617](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/617)) ([be861b8](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/be861b823cb2cb7f6f4a1f266351eec3fc1c2f99))
+* show warning for courses of different semesters ([#570](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/570)) ([2e7dac1](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/2e7dac1e3eba757231ac07ac966231c08c703a16))
+* support summer grades, fix summer course parser ([#596](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/596)) ([2d92dd4](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/2d92dd47f00a44b7d48e92a8ffba94480e4e73f9))
+
+### Bug Fixes
+
+* fix or ignore various eslint warning ([#609](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/609)) ([95de8df](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/95de8df37243b6d59625df515a60442f11b7a9d3))
+* limit height of schedule list dropdown in the extension popup ([#543](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/543)) ([eb8141e](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/eb8141ee8c3d32bce901457178d50781b78f86dd))
+* whitespace wrapping in semester warning ([#629](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/629)) ([46fe591](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/46fe591fa72ef017eea7cfb8aa37d12d8f223926))
 ## [2.2.1](https://github.com/Longhorn-Developers/UT-Registration-Plus/compare/v2.2.0...v2.2.1) (2025-06-04)
 
 ### Features
 
 * add dining app promo ([#598](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/598)) ([be1dccf](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/be1dccfcb9d052c6b291b50cc53418d6bb645beb))
 * inside jokes005 ([#590](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues/590)) ([37471ef](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/37471efb740c7a5828cf3b54bac70954694359d7))
+* **release:** v2.2.1 ([234f3d6](https://github.com/Longhorn-Developers/UT-Registration-Plus/commit/234f3d627d603adf8555b4d0e93106d198918169))
 
 ### Bug Fixes
 

CODE_OF_CONDUCT.md

@@ -0,0 +1,32 @@
+# UT Registration Plus Code of Conduct
+
+Like the technical community as a whole, the UT Registration Plus team and community is made up of a mixture of professionals and volunteers from all over the world, working on every aspect of the mission - including mentorship, teaching, and connecting people.
+
+Diversity is one of our huge strengths, but it can also lead to communication issues and unhappiness. To that end, we have a few ground rules that we ask people to adhere to. This code applies equally to founders, mentors and those seeking help and guidance.
+
+This isn’t an exhaustive list of things that you can’t do. Rather, take it in the spirit in which it’s intended - a guide to make it easier to enrich all of us and the technical communities in which we participate.
+
+This code of conduct applies to all spaces managed by the UT Registration Plus project or Longhorn Developers. This includes IRC, the mailing lists, the issue tracker, DSF events, and any other forums created by the project team which the community uses for communication. In addition, violations of this code outside these spaces may affect a person's ability to participate within them.
+
+If you believe someone is violating the code of conduct, we ask that you report it by emailing [contact@longhorns.dev](mailto:contact@longhorns.dev). For more details please see our
+
+- **Be friendly and patient.**
+- **Be welcoming.** We strive to be a community that welcomes and supports people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, colour, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability.
+- **Be considerate.** Your work will be used by other people, and you in turn will depend on the work of others. Any decision you take will affect users and colleagues, and you should take those consequences into account when making decisions. Remember that we're a world-wide community, so you might not be communicating in someone else's primary language.
+- **Be respectful.** Not all of us will agree all the time, but disagreement is no excuse for poor behavior and poor manners. We might all experience some frustration now and then, but we cannot allow that frustration to turn into a personal attack. It’s important to remember that a community where people feel uncomfortable or threatened is not a productive one. Members of the UT Registration Plus community should be respectful when dealing with other members as well as with people outside the UT Registration Plus community.
+- **Be careful in the words that you choose.** We are a community of professionals, and we conduct ourselves professionally. Be kind to others. Do not insult or put down other participants. Harassment and other exclusionary behavior aren't acceptable. This includes, but is not limited to:
+- Violent threats or language directed against another person.
+- Discriminatory jokes and language.
+- Posting sexually explicit or violent material.
+- Posting (or threatening to post) other people's personally identifying information ("doxing").
+- Personal insults, especially those using racist or sexist terms.
+- Unwelcome sexual attention.
+- Advocating for, or encouraging, any of the above behavior.
+- Repeated harassment of others. In general, if someone asks you to stop, then stop.
+- **When we disagree, try to understand why.** Disagreements, both social and technical, happen all the time and UT Registration Plus is no exception. It is important that we resolve disagreements and differing views constructively. Remember that we’re different. The strength of UT Registration Plus comes from its varied community, people from a wide range of backgrounds. Different people have different perspectives on issues. Being unable to understand why someone holds a viewpoint doesn’t mean that they’re wrong. Don’t forget that it is human to err and blaming each other doesn’t get us anywhere. Instead, focus on helping to resolve issues and learning from mistakes.
+
+Original text courtesy of the [Speak Up! project](http://web.archive.org/web/20141109123859/http://speakup.io/coc.html).
+
+## Questions?
+
+If you have questions, please see . If that doesn't answer your questions, feel free to [contact us](mailto:contact@longhorns.dev).

DOCKER_DEV_SETUP.md

@@ -2,8 +2,8 @@
 
 ## Prerequisites
 
--   Docker installed on your machine
+- Docker installed on your machine
--   Git (to clone the repository)
+- Git (to clone the repository)
 
 ## Getting Started
 
@@ -70,9 +70,9 @@ docker run -it --rm -v $(pwd)/dist:/extension/dist -p 5173:5173 -e BUILD_MODE=de
 
 ## Accessing the Built Extension
 
--   For build mode, the extension files will be in the `dist` directory on your host machine.
+- For build mode, the extension files will be in the `dist` directory on your host machine.
--   For zip mode, the zipped extension will be in the `package` directory on your host machine.
+- For zip mode, the zipped extension will be in the `package` directory on your host machine.
--   For dev mode, the extension will be continuously built in the `dist` directory, and you can load it as an unpacked extension in Chrome.
+- For dev mode, the extension will be continuously built in the `dist` directory, and you can load it as an unpacked extension in Chrome.
 
 ## Docker Development Workflow
 
@@ -85,5 +85,5 @@ When working on the extension:
 
 ## Troubleshooting
 
--   If you encounter permission issues with the output directories, ensure that the directories exist on your host machine and have the correct permissions.
+- If you encounter permission issues with the output directories, ensure that the directories exist on your host machine and have the correct permissions.
--   For any other issues, please check the Docker logs or open an issue in the GitHub repository.
+- For any other issues, please check the Docker logs or open an issue in the GitHub repository.

LICENSE.md

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -6,7 +6,7 @@
 ![Downloads](https://img.shields.io/chrome-web-store/d/hboadpjkoaieogjimneceaahlppnipaa)
 ![License](https://img.shields.io/github/license/Longhorn-Developers/UT-Registration-Plus)
 
-**UT Registration Plus (UTRP)** streamlines the process of registering for classes at UT Austin by reducing the chaos of juggling multiple tabs like Rate My Professor, Google Sheets, and the UT Course Schedule. With UTRP, you can simplify class selection and schedule management. We've all been there. 20 tabs of Rate My Professor, Google Spreadsheet, and the UT Course Schedule open and you still don't know what classes to take. 
+**UT Registration Plus (UTRP)** streamlines the process of registering for classes at UT Austin by reducing the chaos of juggling multiple tabs like Rate My Professor, Google Sheets, and the UT Course Schedule. With UTRP, you can simplify class selection and schedule management. We've all been there. 20 tabs of Rate My Professor, Google Spreadsheet, and the UT Course Schedule open and you still don't know what classes to take.
 
 ## Demo
 
@@ -14,36 +14,37 @@
 
 ## Features
 
--   **Quick Access to Class Info**: For each class in the UT Course Schedule, UTRP provides a "breakdown" popup with direct links to RateMyProfessor, Course Evaluation Surveys (CES), and past syllabi.
+- **Quick Access to Class Info**: For each class in the UT Course Schedule, UTRP provides a "breakdown" popup with direct links to RateMyProfessor, Course Evaluation Surveys (CES), and past syllabi.
--   **Prerequisite & Restriction Highlights**: Displays course descriptions with highlighted details on prerequisites, restrictions, and other important info.
+- **Prerequisite & Restriction Highlights**: Displays course descriptions with highlighted details on prerequisites, restrictions, and other important info.
--   **Grade Distribution Graphs**: View an aggregate and semester-specific graph of grade distributions for each course.
+- **Grade Distribution Graphs**: View an aggregate and semester-specific graph of grade distributions for each course.
--   **Saved Courses List**: Easily add courses to a list and view them in the extension popup. Copy unique numbers with a single click.
+- **Saved Courses List**: Easily add courses to a list and view them in the extension popup. Copy unique numbers with a single click.
--   **Conflict Detection**: Automatically highlights and strikes out courses that conflict with your saved courses in the UT Course Catalog.
+- **Conflict Detection**: Automatically highlights and strikes out courses that conflict with your saved courses in the UT Course Catalog.
--   **Weekly Schedule View**: Displays your saved courses in a weekly schedule format for easier planning.
+- **Weekly Schedule View**: Displays your saved courses in a weekly schedule format for easier planning.
--   **Multiple Schedule Support**: Create multiple schedules to plan for different registration scenarios.
+- **Multiple Schedule Support**: Create multiple schedules to plan for different registration scenarios.
--   **And much more!**
+- **And much more!**
 
 ## Toolchain
 
--   React v20.9.0 (LTS)
+- React v20.9.0 (LTS)
--   TypeScript
+- TypeScript v5.x
--   Vite 5
+- Vite v5.x
--   UnoCSS
+- pnpm v10.x
--   ESLint
+- UnoCSS
--   Prettier
+- ESLint
--   Storybook
+- Prettier
--   Figma
+- Storybook
--   Semantic-Release
+- Figma
--   Custom Messaging & Storage Wrappers
+- Semantic-Release
+- Custom Messaging & Storage Wrappers
 
 ## VSCode Extensions
 
 We recommend using the following VSCode extensions to improve your development experience:
 
--   **[ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)**: For identifying and fixing linting issues.
+- **[ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)**: For identifying and fixing linting issues.
--   **[Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)**: For automatic code formatting.
+- **[Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)**: For automatic code formatting.
--   **[Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**: For Tailwind CSS class autocomplete and IntelliSense.
+- **[Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**: For Tailwind CSS class autocomplete and IntelliSense.
--   **[UnoCSS](https://marketplace.visualstudio.com/items?itemName=antfu.unocss)**: For better support with UnoCSS utilities.
+- **[UnoCSS](https://marketplace.visualstudio.com/items?itemName=antfu.unocss)**: For better support with UnoCSS utilities.
 
 ## Contributing
 
@@ -78,7 +79,7 @@ Once set up, the extension can be built to the `dist/` directory using the follo
 
 ### Development Builds
 
--   Run the development server:
+- Run the development server:
     ```bash
     pnpm dev
     ```
@@ -91,7 +92,7 @@ Once set up, the extension can be built to the `dist/` directory using the follo
 
 ### Production Builds
 
--   To generate production builds:
+- To generate production builds:
     ```bash
     pnpm build
     ```
@@ -120,10 +121,10 @@ To load the extension manually in Chrome:
 
 If you encounter bugs or issues, please report them in the [Issues](https://github.com/Longhorn-Developers/UT-Registration-Plus/issues) section, including:
 
--   A clear, descriptive title
+- A clear, descriptive title
--   Steps to reproduce the issue
+- Steps to reproduce the issue
--   Expected behavior
+- Expected behavior
--   Screenshots or logs (if applicable)
+- Screenshots or logs (if applicable)
 
 We aim to address issues promptly.
 
@@ -141,14 +142,14 @@ Follow this structure for commit messages:
 
 Where:
 
--   **type**: One of the following:
+- **type**: One of the following:
-    -   `feat`: A new feature
+    - `feat`: A new feature
-    -   `fix`: A bug fix
+    - `fix`: A bug fix
-    -   `docs`: Documentation updates
+    - `docs`: Documentation updates
-    -   `style`: Code formatting changes (whitespace, semicolons, etc.)
+    - `style`: Code formatting changes (whitespace, semicolons, etc.)
-    -   `refactor`: Code restructuring (without adding features or fixing bugs)
+    - `refactor`: Code restructuring (without adding features or fixing bugs)
-    -   `test`: Adding or modifying tests
+    - `test`: Adding or modifying tests
-    -   `chore`: Maintenance tasks or build process changes
+    - `chore`: Maintenance tasks or build process changes
 
 Example:
 
@@ -167,9 +168,9 @@ Branch names should follow the format:
 
 Examples:
 
--   `feat/user-login`
+- `feat/user-login`
--   `fix/navbar-layout`
+- `fix/navbar-layout`
--   `docs/update-readme`
+- `docs/update-readme`
 
 ## License
 
@@ -183,27 +184,28 @@ We maintain a strict code of conduct. By contributing, you agree to adhere to th
 
 Special thanks to the developers and contributors behind these amazing tools and libraries:
 
--   React v20.9.0 (LTS)
+- React v20.9.0 (LTS)
--   TypeScript
+- TypeScript v5.x
--   Vite 5
+- Vite v5.x
--   UnoCSS
+- pnpm v10.x
--   ESLint
+- UnoCSS
--   Prettier
+- ESLint
--   Storybook
+- Prettier
--   Figma
+- Storybook
--   Semantic-Release
+- Figma
--   [chrome-extension-toolkit](https://github.com/sghsri/chrome-extension-toolkit)
+- Semantic-Release
--   [UT_Grade_Parser](https://github.com/doprz/UT_Grade_Parser)
+- [chrome-extension-toolkit](https://github.com/sghsri/chrome-extension-toolkit)
--   [eslint-plugin-import-essentials](https://github.com/doprz/eslint-plugin-import-essentials)
+- [UT_Grade_Parser](https://github.com/doprz/UT_Grade_Parser)
--   [UT Registration Plus v1.2.2.7](https://github.com/Longhorn-Developers/UT-Registration-Plus/tree/legacy) by @sghsri
+- [eslint-plugin-import-essentials](https://github.com/doprz/eslint-plugin-import-essentials)
--   [UT Registration Planner](https://github.com/doprz/UT-Registration-Planner) by @doprz
+- [UT Registration Plus v1.2.2.7](https://github.com/Longhorn-Developers/UT-Registration-Plus/tree/legacy) by @sghsri
--   [Figma Designs](https://www.figma.com/design/8tsCay2FRqctrdcZ3r9Ahw/UTRP) by @IsaDavRod
+- [UT Registration Planner](https://github.com/doprz/UT-Registration-Planner) by @doprz
--   [Longhorn Developers](https://github.com/Longhorn-Developers) - established in 2024
+- [Figma Designs](https://www.figma.com/design/8tsCay2FRqctrdcZ3r9Ahw/UTRP) by @IsaDavRod
--   The UTRP devs, beta testers, and all supporters of the project!
+- [Longhorn Developers](https://github.com/Longhorn-Developers) - established in 2024
+- The UTRP devs, beta testers, and all supporters of the project!
 
 ## Activity
 
-![UT-Registration-Plus Activity](https://repobeats.axiom.co/api/embed/47930fa3916ac1b475cd63a05948c449eb5ad502.svg "UT-Registration-Plus Repobeats analytics image")
+![UT-Registration-Plus Activity](https://repobeats.axiom.co/api/embed/47930fa3916ac1b475cd63a05948c449eb5ad502.svg 'UT-Registration-Plus Repobeats analytics image')
 
 ## Star History
 

chromatic.config.json

@@ -1,5 +1,5 @@
 {
-  "onlyChanged": true,
+    "onlyChanged": true,
-  "projectId": "Project:65c5172964f36dcf207985bf",
+    "projectId": "Project:65c5172964f36dcf207985bf",
-  "zip": true
+    "zip": true
 }

default.nix

@@ -0,0 +1,10 @@
+(import (
+  let
+    rev = "v1.1.0";
+    sha256 = "sha256:19d2z6xsvpxm184m41qrpi1bplilwipgnzv9jy17fgw421785q1m";
+  in
+  fetchTarball {
+    inherit sha256;
+    url = "https://github.com/NixOS/flake-compat/archive/${rev}.tar.gz";
+  }
+) { src = ./.; }).defaultNix

docker-entrypoint.sh

@@ -24,7 +24,7 @@ else
 fi
 
 # Validate the mode
-if [[ ! " ${SUPPORTED_MODES[*]} " =~ " ${mode} " ]]; then
+if [[ ! " ${SUPPORTED_MODES[*]} " =~  ${mode}  ]]; then
     echo "Error: Invalid mode '${mode}'" >&2
     usage
 fi

flake.lock

@@ -0,0 +1,96 @@
+{
+  "nodes": {
+    "flake-parts": {
+      "inputs": {
+        "nixpkgs-lib": "nixpkgs-lib"
+      },
+      "locked": {
+        "lastModified": 1767609335,
+        "narHash": "sha256-feveD98mQpptwrAEggBQKJTYbvwwglSbOv53uCfH9PY=",
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "rev": "250481aafeb741edfe23d29195671c19b36b6dca",
+        "type": "github"
+      },
+      "original": {
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1767640445,
+        "narHash": "sha256-UWYqmD7JFBEDBHWYcqE6s6c77pWdcU/i+bwD6XxMb8A=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "9f0c42f8bc7151b8e7e5840fb3bd454ad850d8c5",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs-lib": {
+      "locked": {
+        "lastModified": 1765674936,
+        "narHash": "sha256-k00uTP4JNfmejrCLJOwdObYC9jHRrr/5M/a/8L2EIdo=",
+        "owner": "nix-community",
+        "repo": "nixpkgs.lib",
+        "rev": "2075416fcb47225d9b68ac469a5c4801a9c4dd85",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-community",
+        "repo": "nixpkgs.lib",
+        "type": "github"
+      }
+    },
+    "nixpkgs_2": {
+      "locked": {
+        "lastModified": 1761236834,
+        "narHash": "sha256-+pthv6hrL5VLW2UqPdISGuLiUZ6SnAXdd2DdUE+fV2Q=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "d5faa84122bc0a1fd5d378492efce4e289f8eac1",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-parts": "flake-parts",
+        "nixpkgs": "nixpkgs",
+        "treefmt-nix": "treefmt-nix"
+      }
+    },
+    "treefmt-nix": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_2"
+      },
+      "locked": {
+        "lastModified": 1767468822,
+        "narHash": "sha256-MpffQxHxmjVKMiQd0Tg2IM/bSjjdQAM+NDcX6yxj7rE=",
+        "owner": "numtide",
+        "repo": "treefmt-nix",
+        "rev": "d56486eb9493ad9c4777c65932618e9c2d0468fc",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "treefmt-nix",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,33 @@
+{
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-parts.url = "github:hercules-ci/flake-parts";
+    treefmt-nix.url = "github:numtide/treefmt-nix";
+  };
+
+  outputs =
+    inputs@{ flake-parts, ... }:
+    flake-parts.lib.mkFlake { inherit inputs; } {
+      systems = inputs.nixpkgs.lib.systems.flakeExposed;
+
+      imports = [
+        ./nix/packages.nix
+        ./nix/devShells.nix
+        ./nix/treefmt.nix
+      ];
+
+      perSystem =
+        { system, ... }:
+        {
+          _module.args.pkgs = import inputs.nixpkgs {
+            inherit system;
+            overlays = [
+              (final: prev: {
+                nodejs = prev.nodejs_20; # v20.19.5
+              })
+            ];
+            config = { };
+          };
+        };
+    };
+}

nix/devShells.nix

@@ -0,0 +1,30 @@
+{
+  perSystem =
+    {
+      pkgs,
+      ...
+    }:
+    let
+      commonPackages = with pkgs; [
+        nodejs # Defined in overlay
+        pnpm_10 # v10.18.2
+      ];
+
+      additionalPackages = with pkgs; [
+        bun
+        nodePackages.conventional-changelog-cli
+        sentry-cli
+      ];
+    in
+    {
+      devShells.default = pkgs.mkShell {
+        name = "utrp-dev";
+        packages = commonPackages;
+      };
+
+      devShells.full = pkgs.mkShell {
+        name = "utrp-dev-full";
+        packages = commonPackages ++ additionalPackages;
+      };
+    };
+}

nix/package.nix

@@ -0,0 +1,51 @@
+{
+  stdenv,
+  lib,
+  nodejs,
+  pnpm_10,
+  git,
+  version ? "dev",
+  gitRev ? "unknown",
+  gitBranch ? "unknown",
+  buildScript ? "build",
+}:
+
+stdenv.mkDerivation (finalAttrs: {
+  inherit version;
+  pname = "ut-registration-plus";
+
+  src = ../.;
+
+  nativeBuildInputs = [
+    nodejs
+    pnpm_10.configHook
+    git
+  ];
+
+  pnpmDeps = pnpm_10.fetchDeps {
+    inherit (finalAttrs) pname version src;
+    fetcherVersion = 2;
+    hash = "sha256-UqHymJWvlTV4glra/6DkxuCxbG5dpPkFcnvq3vuxsJ8=";
+  };
+
+  # Pass git info to the build
+  VITE_GIT_COMMIT = gitRev;
+  VITE_GIT_BRANCH = gitBranch;
+
+  buildPhase = ''
+    pnpm run ${buildScript}
+  '';
+
+  installPhase = ''
+    mkdir -p $out
+    cp -r dist/* $out/
+  '';
+
+  meta = {
+    description = "UT Registration Plus";
+    homepage = "https://github.com/Longhorn-Developers/UT-Registration-Plus";
+    license = lib.licenses.mit;
+    maintainers = lib.maintainers.doprz;
+    platforms = lib.platforms.unix;
+  };
+})

nix/packages.nix

@@ -0,0 +1,40 @@
+{ inputs, ... }:
+{
+  perSystem =
+    { pkgs, ... }:
+    let
+      packageJson = builtins.fromJSON (builtins.readFile ../package.json);
+      gitRev = inputs.self.shortRev or inputs.self.dirtyShortRev or "dev";
+      gitBranch = if inputs.self ? ref then inputs.self.ref else "unknown";
+      baseVersion = packageJson.version;
+
+      commonArgs = {
+        inherit gitRev gitBranch;
+      };
+
+      # Prod variant
+      ut-registration-plus = pkgs.callPackage ./package.nix (
+        commonArgs
+        // {
+          version = "${baseVersion}+git.${gitRev}";
+          buildScript = "build";
+        }
+      );
+
+      # Dev variant
+      ut-registration-plus-dev = pkgs.callPackage ./package.nix (
+        commonArgs
+        // {
+          version = "${baseVersion}-dev+git.${gitRev}";
+          buildScript = "build:dev";
+        }
+      );
+    in
+    {
+      packages = {
+        inherit ut-registration-plus ut-registration-plus-dev;
+        default = ut-registration-plus;
+        dev = ut-registration-plus-dev;
+      };
+    };
+}

nix/treefmt.nix

@@ -0,0 +1,63 @@
+{ inputs, ... }:
+{
+  imports = [
+    inputs.treefmt-nix.flakeModule
+  ];
+
+  perSystem =
+    { pkgs, ... }:
+    {
+      treefmt = {
+        projectRootFile = "flake.nix";
+        programs.nixfmt.enable = pkgs.lib.meta.availableOn pkgs.stdenv.buildPlatform pkgs.nixfmt-rfc-style.compiler;
+        programs.nixfmt.package = pkgs.nixfmt-rfc-style;
+
+        # NOTE: Make sure the prettier version in package.json and the one used by treefmt are the same for consistent results
+        programs.prettier.enable = true;
+        programs.shellcheck.enable = true;
+        programs.yamlfmt.enable = true;
+        programs.dockerfmt.enable = true;
+
+        settings.formatter.prettier.excludes = [ "pnpm-lock.yaml" ];
+        settings.formatter.shellcheck.excludes = [ ".envrc" ];
+        settings.formatter.yamlfmt.excludes = [ "pnpm-lock.yaml" ];
+      };
+
+      checks = {
+        prettier-version-match =
+          pkgs.runCommand "check-prettier-version"
+            {
+              buildInputs = [ pkgs.jq ];
+            }
+            ''
+              # Extract prettier version from package.json
+              packageJsonVersion=$(jq -r '.devDependencies.prettier // empty' ${../package.json})
+
+              if [ -z "$packageJsonVersion" ]; then
+                echo "Error: prettier not found in package.json devDependencies"
+                exit 1
+              fi
+
+              # Remove any semver prefix characters (^, ~, etc...)
+              packageJsonVersion=$(echo "$packageJsonVersion" | sed 's/^[\^~>=<]*//')
+
+              # Get prettier version from nixpkgs
+              nixVersion="${pkgs.nodePackages.prettier.version}"
+
+              if [ "$packageJsonVersion" != "$nixVersion" ]; then
+                echo ""
+                echo "ERROR: Prettier version mismatch!"
+                echo "  package.json: $packageJsonVersion"
+                echo "  nixpkgs:      $nixVersion"
+                echo ""
+                echo "Please update one of the following:"
+                echo "  - Update prettier in package.json to match nixpkgs: $nixVersion"
+                echo "  - Override prettier in your flake to match package.json"
+                exit 1
+              fi
+
+              touch $out
+            '';
+      };
+    };
+}

package.json

@@ -1,7 +1,7 @@
 {
     "name": "ut-registration-plus",
     "displayName": "UT Registration Plus",
-    "version": "2.2.1",
+    "version": "2.3.0",
     "description": "UT Registration Plus is a Chrome extension that allows students to easily register for classes.",
     "private": true,
     "homepage": "https://github.com/Longhorn-Developers/UT-Registration-Plus",
@@ -39,9 +39,11 @@
         "@phosphor-icons/react": "^2.1.7",
         "@sentry/react": "^8.55.0",
         "@tanstack/react-query": "^5.69.0",
+        "@tsparticles/engine": "^3.9.1",
+        "@tsparticles/react": "^3.0.0",
+        "@tsparticles/slim": "^3.9.1",
         "@unocss/vite": "^0.63.6",
         "@vitejs/plugin-react": "^4.3.4",
-        "chrome-extension-toolkit": "^0.0.54",
         "clsx": "^2.1.1",
         "conventional-changelog": "^6.0.0",
         "date-fns": "^4.1.0",
@@ -134,17 +136,18 @@
         "gulp": "^5.0.0",
         "gulp-execa": "^7.0.1",
         "gulp-zip": "^6.1.0",
+        "jsdom": "^28.0.0",
         "path": "^0.12.7",
         "postcss": "^8.5.3",
-        "prettier": "^3.5.2",
+        "prettier": "3.6.2",
         "react-dev-utils": "^12.0.1",
         "semantic-release": "^24.2.3",
-        "storybook": "^8.6.0",
+        "storybook": "^8.6.15",
         "typescript": "^5.7.3",
         "unocss": "^0.63.6",
         "unocss-preset-primitives": "0.0.2-beta.1",
         "unplugin-icons": "^0.19.3",
-        "vite": "^5.4.14",
+        "vite": "^5.4.20",
         "vite-plugin-inspect": "^0.8.9",
         "vitest": "^2.1.9"
     },
@@ -159,10 +162,13 @@
         },
         "overrides": {
             "es-module-lexer": "^1.5.4"
-        }
+        },
+        "onlyBuiltDependencies": [
+            "@tsparticles/engine"
+        ]
     },
     "volta": {
-        "node": "20.9.0",
+        "node": "20.19.4",
-        "pnpm": "10.6.5"
+        "pnpm": "10.14.0"
     }
 }

public/json/departments.json

@@ -218,4 +218,4 @@
     "WRT",
     "YID",
     "YOR"
-]
+]

shell.nix

@@ -0,0 +1,10 @@
+(import (
+  let
+    rev = "v1.1.0";
+    sha256 = "sha256:19d2z6xsvpxm184m41qrpi1bplilwipgnzv9jy17fgw421785q1m";
+  in
+  fetchTarball {
+    inherit sha256;
+    url = "https://github.com/NixOS/flake-compat/archive/${rev}.tar.gz";
+  }
+) { src = ./.; }).shellNix

src/lib/chrome-extension-toolkit/README.md

@@ -0,0 +1,8 @@
+# chrome-extension-toolkit
+
+Repo: https://github.com/sghsri/chrome-extension-toolkit
+Author: sghsri
+License: MIT
+Version: 0.0.96
+
+This library has been inlined into UTRP due to the package being removed from npm.

src/lib/chrome-extension-toolkit/context/ContextInvalidated.tsx

@@ -0,0 +1,62 @@
+import React, { useState } from 'react';
+
+const containerStyle: React.CSSProperties = {
+    position: 'fixed',
+    bottom: 0,
+    left: 0,
+    right: 0,
+    padding: '8px',
+    fontSize: '20px',
+    textAlign: 'center',
+    borderTopLeftRadius: '20px',
+    borderTopRightRadius: '20px',
+    zIndex: 999999999999,
+    cursor: 'pointer',
+};
+
+const closeButtonStyle: React.CSSProperties = {
+    position: 'absolute',
+    top: 0,
+    right: 0,
+    padding: '8px',
+    paddingRight: '20px',
+    fontSize: '20px',
+    cursor: 'pointer',
+};
+
+interface Props {
+    className?: string;
+    onClick?: () => void;
+}
+
+/**
+ * A component that displays a message onto a content script when the context extension is invalidated.
+ */
+export function ContextInvalidated(props: Props): JSX.Element | null {
+    const [isShowing, setIsShowing] = useState(true);
+
+    const hide = (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => {
+        e.stopPropagation();
+        setIsShowing(false);
+    };
+
+    const reload = () => {
+        window.location.reload();
+    };
+
+    return isShowing ? (
+        <div
+            style={{
+                ...containerStyle,
+            }}
+            id='extension-context-invalidated'
+            className={props.className}
+            onClick={props.onClick ?? reload}
+        >
+            Context Extension Context invalidated. Click to reload
+            <div style={closeButtonStyle} onClick={hide}>
+                ✕
+            </div>
+        </div>
+    ) : null;
+}

src/lib/chrome-extension-toolkit/context/index.ts

@@ -0,0 +1,2 @@
+export * from './ContextInvalidated';
+export * from './onContextInvalidated';

src/lib/chrome-extension-toolkit/context/onContextInvalidated.ts

@@ -0,0 +1,14 @@
+/**
+ * A content script can be invalidated if a chrome extension is reloaded / updated.
+ * This function is used to detect when the extension's context has been invalidated, and to call a callback.
+ * @param callback A callback to be called when the extension's context has been invalidated
+ */
+export function onContextInvalidated(callback: () => void) {
+    const interval = setInterval(() => {
+        // this means the current tab's context has been invalidated
+        if (!chrome.runtime.id) {
+            clearInterval(interval);
+            callback();
+        }
+    }, 1 * 1000);
+}

src/lib/chrome-extension-toolkit/dom/createShadowRoot.ts

@@ -0,0 +1,55 @@
+/**
+ * An extension of HTMLDivElement that represents a shadow root for use within an Extension Content Script.
+ */
+interface HTMLShadowDOMElement extends HTMLDivElement {
+    shadowRoot: ShadowRoot & {
+        INJECTION_POINT: HTMLDivElement;
+    };
+    /**
+     * Adds a style sheet to the shadow root.
+     * @param path the path to the style sheet relative to the extension's root directory. uses chrome.runtime.getURL to get the absolute path.
+     */
+    addStyle(path: string): Promise<void>;
+}
+
+/**
+ * In extension content scripts, often times the parent site's styles will override the styles of the extension.
+ * To get around this, we create a shadow DOM and isolate the extension's html and styles in the shadow DOM.
+ * from the parent site's styles to prevent conflicts.
+ * @param id the id of the shadow root.
+ * @param options the optional options for the shadow root.
+ * @param isolate whether or not to isolate the extension's document flow from the parent site's document flow.
+ * @returns A Div that represents the shadow root with some additional methods added to it.
+ */
+export function createShadowDOM(id: string, options?: ShadowRootInit, isolate = false): HTMLShadowDOMElement {
+    const html = document.querySelector('html');
+    if (!html) {
+        throw new Error('Could not find html element');
+    }
+    const div = document.createElement('div') as HTMLShadowDOMElement;
+    div.id = id;
+    div.style.all = 'initial';
+    div.attachShadow({
+        mode: 'open',
+        ...(options || {}),
+    });
+
+    const INJECTION_POINT = document.createElement('div');
+    INJECTION_POINT.id = 'INJECTION_POINT';
+    div.shadowRoot.appendChild(INJECTION_POINT);
+    div.shadowRoot.INJECTION_POINT = INJECTION_POINT;
+
+    div.addStyle = async (path: string) => {
+        const style = await fetch(chrome.runtime.getURL(path));
+        const styleNode = document.createElement('style');
+        const parsedStyle = await style.text();
+        styleNode.textContent = parsedStyle;
+        div.shadowRoot.appendChild(styleNode);
+    };
+
+    html.appendChild(div);
+
+    if (isolate) document.body.style.isolation = 'isolate';
+
+    return div as HTMLShadowDOMElement;
+}

src/lib/chrome-extension-toolkit/dom/index.ts

@@ -0,0 +1 @@
+export * from './createShadowRoot';

src/lib/chrome-extension-toolkit/getScriptType.ts

@@ -0,0 +1,70 @@
+/**
+ * Possible contexts in which a chrome extension can run.
+ */
+export enum ScriptType {
+    CONTENT_SCRIPT = 'content_script',
+    BACKGROUND_SCRIPT = 'background_script',
+    EXTENSION_POPUP = 'extension_popup',
+    EXTENSION_PAGE = 'extension_page',
+}
+
+/**
+ * Chrome extension code can run in different contexts.
+ * These different contexts have different capabilities and access to certain parts of the chrome extensions API.
+ * For example, the chrome.tabs api is not readily available in the content scripts.
+ * This function is used to identify the context in which the code is running.
+ * @returns The context in which the code is running, or null if the code is not running in a chrome extension.
+ */
+export default function getScriptType(): ScriptType | null {
+    if (!chrome?.runtime?.id) {
+        // we are not in a chrome extension
+        return null;
+    }
+    const manifest = chrome.runtime.getManifest();
+    if (globalThis.window === undefined) {
+        return ScriptType.BACKGROUND_SCRIPT;
+    }
+
+    if (window.location.href.startsWith(`chrome-extension://${chrome.runtime.id}`)) {
+        if (manifest.action?.default_popup && window.location.href.includes(manifest.action.default_popup)) {
+            return ScriptType.EXTENSION_POPUP;
+        }
+        return ScriptType.EXTENSION_PAGE;
+    }
+
+    return ScriptType.CONTENT_SCRIPT;
+}
+
+/**
+ * A helper function to check if the code is running in a content script.
+ * @returns true if the code is running in a content script, false otherwise.
+ */
+export function isContentScript(): boolean {
+    return getScriptType() === ScriptType.CONTENT_SCRIPT;
+}
+
+/**
+ * A helper function to check if the code is running in the background script.
+ * @returns true if the code is running in the background script, false otherwise.
+ */
+export function isBackgroundScript(): boolean {
+    return getScriptType() === ScriptType.BACKGROUND_SCRIPT;
+}
+
+/**
+ * A helper function to check if the code is running in the extension popup.
+ * @returns true if the code is running in the extension popup, false otherwise.
+ */
+export function isExtensionPopup(): boolean {
+    return getScriptType() === ScriptType.EXTENSION_POPUP;
+}
+
+/**
+ * A helper function to check if the code is running in an extension page (popup, options, etc.).
+ * @returns true if the code is running in an extension page (popup, options, etc.), false otherwise.
+ * @param pageName The name of the page to check for. ex: 'options.html'
+ */
+export function isExtensionPage(pageName?: string): boolean {
+    const isPage = getScriptType() === ScriptType.EXTENSION_PAGE;
+    return isPage && pageName ? window.location.href.includes(pageName) : isPage;
+}

src/lib/chrome-extension-toolkit/index.ts

@@ -0,0 +1,6 @@
+export * from './context';
+export * from './dom';
+export * from './getScriptType';
+export * from './messaging';
+export * from './storage';
+export * from './types';

src/lib/chrome-extension-toolkit/messaging/MessageListener.ts

@@ -0,0 +1,127 @@
+import getScriptType, { ScriptType } from '../getScriptType';
+import type { IMessageListener, Message, MessageHandler, Serializable } from '../types';
+import { MessageEndpoint } from '../types';
+
+/**
+ * Options for configuring a message listener.
+ */
+export interface MessageListenerOptions {
+    /**
+     * A callback function that will be called when an error occurs.
+     * Useful if you want to log errors to a service like Sentry or Bugsnag.
+     * @param error The error that occurred.
+     */
+    onError?: (error: Error) => void;
+
+    /**
+     * A flag indicating whether verbose logging should be enabled.
+     */
+    verbose?: boolean;
+}
+
+/**
+ * An object that can be used to listen for and handle messages coming from another extension context.
+ */
+export class MessageListener<M> implements IMessageListener<M> {
+    private handlers: MessageHandler<M>;
+    private scriptType: ScriptType;
+    private myEndpoint: MessageEndpoint;
+    private listeningFor: MessageEndpoint;
+
+    private onError?: (error: Error) => void;
+
+    private isVerbose: boolean = false;
+
+    /**
+     * An object that can be used to listen for and handle messages coming from another extension context.
+     * @param handlers the message handlers for the messages that this listener will handle. When a message is received, the corresponding message handler is called.
+     */
+    constructor(handlers: MessageHandler<M>) {
+        this.handlers = handlers;
+
+        // we want to know what type of script we are running in so we can determine what endpoint we are (background or foreground)
+        const scriptType = getScriptType();
+        if (!scriptType) {
+            throw new Error('[crx-kit]: Unable to determine extension script type.');
+        }
+        this.scriptType = scriptType;
+
+        if (this.scriptType === ScriptType.BACKGROUND_SCRIPT) {
+            this.myEndpoint = MessageEndpoint.BACKGROUND;
+            this.listeningFor = MessageEndpoint.FOREGROUND;
+        } else {
+            this.myEndpoint = MessageEndpoint.FOREGROUND;
+            this.listeningFor = MessageEndpoint.BACKGROUND;
+        }
+    }
+
+    private handleMessage = (
+        message: Message<M>,
+        sender: chrome.runtime.MessageSender,
+        sendResponse: (response: any) => void
+    ): boolean => {
+        if (message.to !== this.myEndpoint && message.from !== this.listeningFor) {
+            // this message is not for my current context, so ignore it
+            return true;
+        }
+        const messageName = message.name as string;
+
+        // @ts-expect-error
+        const handler = this.handlers[messageName];
+        if (!handler) {
+            // this message is for my current context, but I don't have a handler for it, so ignore it
+            return true;
+        }
+        try {
+            if (this.isVerbose) {
+                console.log(`[crx-kit]: message received: ${messageName}`, {
+                    name: messageName,
+                    data: message.data,
+                    sender,
+                });
+            }
+            // this message is for my current context, and I have a handler for it, so handle it
+            handler({
+                data: message.data as Serializable<typeof message.data>,
+                sendResponse,
+                sender,
+            });
+        } catch (error) {
+            console.error(`[crx-kit]: Error handling message ${messageName}`, {
+                name: messageName,
+                error,
+                message,
+                sender,
+            });
+            if (this.onError) {
+                // @ts-expect-error
+                this.onError(error);
+            }
+        }
+
+        return true;
+    };
+
+    /**
+     * Listens for messages from the specified source.
+     * @param options - The options for the message listener.
+     */
+    public listen(options: MessageListenerOptions = { verbose: false }) {
+        this.isVerbose = options.verbose ?? false;
+        this.onError = options.onError;
+        console.log(`[crx-kit]: ${this.toString()} listening for messages from ${this.listeningFor}`);
+        chrome.runtime.onMessage.addListener(this.handleMessage);
+    }
+
+    /**
+     * Stops listening for messages
+     */
+    public unlisten() {
+        console.log(`[crx-kit]: ${this.toString()} no longer listening for messages from ${this.listeningFor}`);
+        chrome.runtime.onMessage.removeListener(this.handleMessage);
+    }
+
+    private toString() {
+        return `MessageListener(${this.myEndpoint})`;
+    }
+}

src/lib/chrome-extension-toolkit/messaging/createMessenger.ts

@@ -0,0 +1,94 @@
+import type { Message, MessageData, MessageResponse } from '../types';
+import { MessageEndpoint } from '../types';
+/**
+ * An object that can be used to send messages to the background script.
+ */ export type BackgroundMessenger<M> = {
+    [K in keyof M]: MessageData<M, K> extends undefined
+        ? () => Promise<MessageResponse<M, K>>
+        : (data: MessageData<M, K>) => Promise<MessageResponse<M, K>>;
+};
+
+/**
+ * Where the foreground message is being sent to specifically (which tab or frame)
+ */
+type ForegroundMessageOptions =
+    | {
+          tabId: number;
+          frameId?: number;
+      }
+    | {
+          tabId: 'ALL' | 'ACTIVE_TAB';
+      };
+
+/**
+ * an object that can be used to send messages to the foreground (tabs OR extension pages (popup, options, etc.))
+ */
+export type ForegroundMessenger<M> = {
+    [K in keyof M]: MessageData<M, K> extends undefined
+        ? (options: ForegroundMessageOptions) => Promise<MessageResponse<M, K>>
+        : (data: MessageData<M, K>, options: ForegroundMessageOptions) => Promise<MessageResponse<M, K>>;
+};
+
+/**
+ * A wrapper for chrome extension messaging with a type-safe API.
+ * @type To which context the messages are sent.
+ * @returns A proxy object that can be used to send messages to the foreground (tabs or extension pages (popup, options, etc.))
+ */
+export function createMessenger<M>(destination: 'foreground'): ForegroundMessenger<M>;
+/**
+ *  A wrapper for chrome extension messaging with a type-safe API.
+ * @param type To which context the messages are sent.
+ * @returns A proxy object that can be used to send messages to the background script.
+ */
+export function createMessenger<M>(destination: 'background'): BackgroundMessenger<M>;
+/**
+ *  A wrapper for chrome extension messaging with a type-safe API.
+ * @param destination To which context the messages are sent.
+ * @returns A proxy object that can be used to send messages to the background script.
+ */
+export function createMessenger<M>(destination: 'background' | 'foreground') {
+    let to: MessageEndpoint = MessageEndpoint.BACKGROUND;
+    let from: MessageEndpoint = MessageEndpoint.FOREGROUND;
+
+    if (destination === 'foreground') {
+        to = MessageEndpoint.FOREGROUND;
+        from = MessageEndpoint.BACKGROUND;
+    }
+
+    const sender = new Proxy({} as any, {
+        get(target, prop) {
+            const name = prop as keyof M;
+            return async (data: MessageData<M, any>, options?: ForegroundMessageOptions) => {
+                const message: Message<M> = {
+                    name,
+                    data,
+                    from,
+                    to,
+                };
+
+                if (to === MessageEndpoint.FOREGROUND && options) {
+                    // for messages sent to the tabs, we want to send to the tabs using chrome.tabs.sendMessage,
+                    const { tabId } = options;
+                    if (typeof tabId === 'number') {
+                        return chrome.tabs.sendMessage(tabId, message, { frameId: options.frameId });
+                    }
+                    if (tabId === 'ACTIVE_TAB') {
+                        const tab = (await chrome.tabs.query({ active: true, currentWindow: true }))[0];
+                        if (tab && tab.id) {
+                            return chrome.tabs.sendMessage(tab.id, message);
+                        }
+                    }
+                    if (tabId === 'ALL') {
+                        const tabs = (await chrome.tabs.query({})).filter(tab => tab.id !== undefined && tab.url);
+                        return Promise.any([
+                            ...tabs.map(tab => chrome.tabs.sendMessage(tab.id!, message)),
+                            chrome.runtime.sendMessage(message),
+                        ]);
+                    }
+                }
+                return chrome.runtime.sendMessage(message);
+            };
+        },
+    });
+    return sender;
+}

src/lib/chrome-extension-toolkit/messaging/createUseMessage.ts

@@ -0,0 +1,30 @@
+import { useEffect } from 'react';
+
+import type { Message, MessageData } from '../types';
+
+/**
+ * A helper function to create a hook that can listen for messages coming through chrome.runtime.onMessage
+ * with e2e type safety
+ * @returns a hook that can be used to listen for messages from the background script.
+ */
+export function createUseMessage<M>() {
+    return function useMessage<N extends keyof M, D extends MessageData<M, N>>(
+        name: N,
+        callback: (data: D) => void
+    ): void {
+        useEffect(() => {
+            const onMessage = (message: Message<M>) => {
+                if (message.name === name) {
+                    callback(message.data);
+                }
+                return true;
+            };
+
+            chrome.runtime.onMessage.addListener(onMessage);
+
+            return () => {
+                chrome.runtime.onMessage.removeListener(onMessage);
+            };
+        }, [name, callback]);
+    };
+}

src/lib/chrome-extension-toolkit/messaging/index.ts

@@ -0,0 +1,3 @@
+export * from './createMessenger';
+export * from './createUseMessage';
+export * from './MessageListener';

src/lib/chrome-extension-toolkit/modules.d.ts

@@ -0,0 +1,15 @@
+declare global {
+    namespace NodeJS {
+        interface ProcessEnv {
+            NODE_ENV: 'development' | 'production' | 'test';
+            CI?: string;
+            EXTENSION_STORAGE_PASSWORD?: string;
+        }
+    }
+
+    type Environment = typeof process.env.NODE_ENV;
+}
+
+// If this file has no import/export statements (i.e. is a script)
+// convert it into a module by adding an empty export statement.
+export {};

src/lib/chrome-extension-toolkit/storage/Security.ts

@@ -0,0 +1,214 @@
+/* eslint-disable max-classes-per-file */
+const { crypto } = globalThis;
+
+/** the number of times the key_algo will be run on the password */
+const ITERATIONS = 470_000;
+/** the algorithm used to derive the password key from the password */
+const KEY_ALGO = 'PBKDF2';
+/** the algorithm used to derive the cipher key from the password key */
+const HASH_ALGO = 'SHA-256';
+/** the algorithm used to encrypt the data */
+const CIPHER_MODE = 'AES-GCM';
+
+/** the size of the cipher key */
+const CIPHER_SIZE = 256;
+
+/**
+ * A class that provides encryption and decryption methods for use when storing data in the Stores provided by this library.
+ */
+export class Security {
+    private encoder = new TextEncoder();
+    private decoder = new TextDecoder();
+
+    private cachedPasswordKey?: CryptoKey;
+
+    public static MISSING_PASSWORD_ERROR_MESSAGE =
+        'You must set the EXTENSION_STORAGE_PASSWORD environment variable to use encrypted storage.';
+
+    /**
+     * @returns the password key, either from the cache or by generating a new one from the password environment variable
+     */
+    private async getPasswordKey(): Promise<CryptoKey> {
+        if (this.cachedPasswordKey) return this.cachedPasswordKey;
+
+        if (!process.env.EXTENSION_STORAGE_PASSWORD) {
+            throw new Error(Security.MISSING_PASSWORD_ERROR_MESSAGE);
+        }
+
+        const passwordBuffer = this.encoder.encode(process.env.EXTENSION_STORAGE_PASSWORD);
+        this.cachedPasswordKey = await crypto.subtle.importKey(
+            'raw',
+            passwordBuffer,
+            { name: KEY_ALGO },
+            false, // Not exportable
+            ['deriveKey']
+        );
+        return this.cachedPasswordKey;
+    }
+
+    /**
+     *  Derives a cipher key from the password key and salt
+     * @param salt the salt to use when deriving the cipher key
+     * @param passKey the password key to use when deriving the cipher key
+     * @param KeyUsage the key usage for the cipher key (encrypt or decrypt)
+     * @returns the cipher key which can be used to encrypt or decrypt data
+     */
+    private async deriveCipherKey(salt: Uint8Array, passKey: CryptoKey, KeyUsage: KeyUsage[]): Promise<CryptoKey> {
+        return crypto.subtle.deriveKey(
+            {
+                name: KEY_ALGO,
+                hash: HASH_ALGO,
+                salt,
+                iterations: ITERATIONS,
+            },
+            passKey,
+            {
+                name: CIPHER_MODE,
+                length: CIPHER_SIZE,
+            },
+            false,
+            KeyUsage
+        );
+    }
+
+    /**
+     * @returns a random salt buffer for use in encryption
+     */
+    private deriveSalt(): Uint8Array {
+        return crypto.getRandomValues(new Uint8Array(BoxBuffer.SALT_SIZE));
+    }
+
+    /**
+     * @returns a random IV buffer for use in encryption
+     */
+    private deriveIv(): Uint8Array {
+        return crypto.getRandomValues(new Uint8Array(BoxBuffer.IV_SIZE));
+    }
+
+    /**
+     * Decrypts a value that has been encrypted using the encrypt method
+     * @param value the encrypted value to decrypt
+     * @returns the decrypted value
+     */
+    async decrypt(value: any) {
+        if (!value) return value;
+        if (!isString(value)) return value;
+
+        const passKey = await this.getPasswordKey();
+
+        // read in the string into a boxBuffer, and separate the salt, iv and encrypted data from it
+        const boxBuffer = BoxBuffer.fromBase64String(value);
+        const salt = boxBuffer.getSalt();
+        const iv = boxBuffer.getIv();
+        const encryptedData = boxBuffer.getEncryptedData();
+
+        // generate the decryption key
+        const decryptionKey = await this.deriveCipherKey(salt, passKey, ['decrypt']);
+
+        // decrypt the data using the decryption key
+        const decryptedDataBuffer = await crypto.subtle.decrypt(
+            {
+                name: CIPHER_MODE,
+                iv,
+            },
+            decryptionKey,
+            encryptedData
+        );
+
+        // parse the decrypted data into a JSON object and return it
+        return decryptedDataBuffer.byteLength === 0 ? undefined : JSON.parse(this.decoder.decode(decryptedDataBuffer));
+    }
+
+    /**
+     * Encrypts a value using the password key derived from the EXTENSION_STORAGE_PASSWORD environment variable
+     * @param value the value to encrypt
+     * @returns the encrypted value as a base64 string
+     */
+    async encrypt(value: any): Promise<string> {
+        let valueString = JSON.stringify(value);
+
+        const passKey = await this.getPasswordKey();
+
+        const salt = this.deriveSalt();
+        const iv = this.deriveIv();
+
+        const encryptionKey = await this.deriveCipherKey(salt, passKey, ['encrypt']);
+
+        const encryptedData = new Uint8Array(
+            await crypto.subtle.encrypt(
+                {
+                    name: CIPHER_MODE,
+                    iv,
+                },
+                encryptionKey,
+                this.encoder.encode(valueString)
+            )
+        );
+
+        // create a boxBuffer to store the salt, iv and encrypted data together in a single buffer
+        const bufferSize = BoxBuffer.PREFIX_SIZE + encryptedData.byteLength;
+
+        const boxBuffer = new BoxBuffer(new Uint8Array(bufferSize));
+        boxBuffer.setSalt(salt);
+        boxBuffer.setIv(iv);
+        boxBuffer.setEncryptedData(encryptedData);
+
+        // return the boxBuffer as a base64 string (to make it easier to store)
+        return boxBuffer.toBase64String();
+    }
+}
+
+/**
+ * A class representation of a buffer box in memory of the form:
+ * [salt][iv][encrypted data]
+ */
+class BoxBuffer {
+    private buffer: Uint8Array;
+    static SALT_SIZE = 16;
+    static IV_SIZE = 32;
+
+    static get PREFIX_SIZE() {
+        return BoxBuffer.SALT_SIZE + BoxBuffer.IV_SIZE;
+    }
+
+    constructor(buffer: Uint8Array) {
+        this.buffer = buffer;
+    }
+
+    setSalt(salt: Uint8Array) {
+        this.buffer.set(salt, 0);
+    }
+
+    setIv(iv: Uint8Array) {
+        this.buffer.set(iv, BoxBuffer.SALT_SIZE);
+    }
+
+    setEncryptedData(encryptedData: Uint8Array) {
+        this.buffer.set(encryptedData, BoxBuffer.PREFIX_SIZE);
+    }
+
+    getSalt(): Uint8Array {
+        return this.buffer.slice(0, BoxBuffer.SALT_SIZE);
+    }
+
+    getIv(): Uint8Array {
+        return this.buffer.slice(BoxBuffer.SALT_SIZE, BoxBuffer.PREFIX_SIZE);
+    }
+
+    getEncryptedData(): Uint8Array {
+        return this.buffer.slice(BoxBuffer.PREFIX_SIZE);
+    }
+
+    toBase64String() {
+        return globalThis.btoa(String.fromCharCode.apply(null, this.buffer as any));
+    }
+
+    static fromBase64String(base64String: string): BoxBuffer {
+        const rawBuffer = Uint8Array.from(globalThis.atob(base64String), c => c.charCodeAt(0));
+        return new BoxBuffer(rawBuffer);
+    }
+}
+
+function isString(value: any): value is string {
+    return typeof value === 'string' || value instanceof String;
+}

src/lib/chrome-extension-toolkit/storage/createStore.ts

@@ -0,0 +1,447 @@
+/* eslint-disable no-await-in-loop */
+import { useEffect, useState } from 'react';
+
+import type { Serializable } from '../types';
+import { Security } from './Security';
+
+/** A utility type that forces you to declare all the values specified in the type interface for a module. */
+export type StoreDefaults<T> = {
+    [P in keyof Required<T>]: Pick<T, P> extends Required<Pick<T, P>> ? T[P] : T[P] | undefined;
+};
+
+/**
+ * Represents a change in data within the store.
+ */
+export type DataChange<T> = {
+    key: string;
+    /**
+     * The old value of the data. This will be undefined if the data was just initialized.
+     */
+    oldValue?: Serializable<T>;
+    /**
+     * The new value of the data.
+     */
+    newValue: Serializable<T>;
+};
+
+/**
+ * A function that is called when the data in the store changes.
+ */
+export type OnChangedFunction<T> = (changes: DataChange<T>) => void;
+
+/**
+ * A virtual wrapper around the chrome.storage API that allows you to segment and compartmentalize your data.
+ * The data is all stored at the top level of the storage area, so you should namespace your keys to avoid collisions.
+ */
+export type Store<T = {}> = {
+    /**
+     * A unique identifier for the store. This will be prepended to all keys in the store to avoid collisions.
+     */
+    readonly storeId: string;
+    /**
+     * The options that were passed to the createStore function
+     */
+    readonly options: StoreOptions;
+
+    /**
+     * The default values for the store. These were passed to the createStore function and will be used to initialize the store if the key is not already set.
+     */
+    readonly defaults: StoreDefaults<T>;
+    /**
+     * Initializes the store by setting any keys that are not already set to their default values. This will be called automatically when you first access a getter or setter.
+     */
+    initialize(): Promise<void>;
+
+    /**
+     * Gets the value of the specified key from the store.
+     * @param key the key to get the value of
+     * @returns a promise that resolves to the value of the specified key (wrapped in a Serialized type)
+     */
+    get<K extends keyof T>(key: K): Promise<Serializable<T[K]>>;
+
+    /**
+     * Sets the value of the specified key in the store.
+     * @param key the key to set the value of
+     * @param value the value to set the key to
+     */
+    set<K extends keyof T>(key: K, value: Serializable<T[K]>): Promise<void>;
+
+    /**
+     * Sets the store with the values in the object passed in.
+     * @param values an object containing the keys and values to set in the store
+     */
+    set(values: Partial<Serializable<T>>): Promise<void>;
+
+    /**
+     * Removes a specific key from the store.
+     * @param key the key to remove from the store
+     */
+    remove<K extends keyof T>(key: K): Promise<void>;
+
+    /**
+     * Returns a promise that resolves to the entire contents of the store.
+     */
+    all(): Promise<Serializable<T>>;
+
+    /**
+     * Returns an array of all the keys in the store.
+     */
+    keys(): (keyof T & string)[];
+
+    /**
+     * A react hook that allows you to get and set the value of the specified key in the store from a functional component.
+     * @param key the key to get the value of or null to get the entire store
+     * @returns a tuple containing the value of the specified key, and a function to set the value
+     */
+    use<K extends keyof T | null>(
+        key: K
+    ): [
+        K extends keyof T ? Serializable<T[K]> : Serializable<T>,
+        (value: K extends keyof T ? Serializable<T[K]> : Partial<Serializable<T>>) => Promise<void>,
+    ];
+
+    /**
+     * A react hook that allows you to get and set the value of the specified key in the store from a functional component.
+     * @param key the key to get the value of or null to get the entire store
+     * @param defaultValue the default value to use if the key is not already set
+     */
+    use<K extends keyof T | null>(
+        key: K,
+        defaultValue: K extends keyof T ? Serializable<T[K]> : Serializable<T>
+    ): [
+        K extends keyof T ? Serializable<T[K]> : Serializable<T>,
+        (value: K extends keyof T ? Serializable<T[K]> : Partial<Serializable<T>>) => Promise<void>,
+    ];
+
+    /**
+     * Subscribes to changes in the specified key in the store, and calls the specified function when the key changes.
+     * @param key the key to subscribe to
+     * @param callback the function to call when the key changes
+     */
+    // @ts-expect-error
+    subscribe<K extends keyof T>(key: K, callback: OnChangedFunction<T[K]>): (changes, area) => void;
+    // @ts-expect-error
+    subscribe<K extends keyof T>(key: K[], callback: OnChangedFunction<T[K]>): (changes, area) => void;
+
+    /**
+     * Removes a subscription that was added with the subscribe function.
+     * @param sub the subscription function that was added
+     */
+    // @ts-expect-error
+    unsubscribe(sub: (changes, area) => void): void;
+};
+
+/**
+ * Options that modify the behavior of the store
+ */
+type StoreOptions = {
+    /**
+     * Whether or not to encrypt the data before storing it, and decrypt it when retrieving it. Defaults to false.
+     */
+    isEncrypted?: boolean;
+};
+
+const security = new Security();
+
+/**
+ * A function that creates a virtual storage bucket within the chrome.storage API.
+ *
+ * @param defaults the default values for the store (these will be used to initialize the store if the key is not already set, and will be used as the type for the getters and setters)
+ * @param area the storage area to use. Defaults to 'local'
+ * @returns an object which contains getters/setters for the keys in the defaults object, as well as an initialize function and an onChanged functions
+ */
+function createStore<T>(
+    storeId: string,
+    defaults: StoreDefaults<T>,
+    area: 'sync' | 'local' | 'session' | 'managed',
+    options?: StoreOptions
+): Store<T> {
+    const keys = Object.keys(defaults) as string[];
+    const actualKeys = keys.map(key => `${storeId}:${key}`);
+
+    let isEncrypted = options?.isEncrypted || false;
+
+    if (isEncrypted && !process.env.EXTENSION_STORAGE_PASSWORD) {
+        throw new Error(Security.MISSING_PASSWORD_ERROR_MESSAGE);
+    }
+
+    const store = {
+        defaults,
+        storeId,
+        options,
+    } as Store<T>;
+
+    let hasInitialized = false;
+    store.initialize = async () => {
+        const data = await chrome.storage[area].get(actualKeys);
+        const missingKeys = actualKeys.filter(key => data[key] === undefined);
+
+        if (missingKeys.length) {
+            const defaultsToSet = {};
+
+            for (const key of missingKeys) {
+                // @ts-expect-error
+                const value = defaults[key.replace(`${storeId}:`, '')];
+                // @ts-expect-error
+                defaultsToSet[key] = isEncrypted ? await security.encrypt(value) : value;
+            }
+
+            await chrome.storage[area].set(defaultsToSet);
+        }
+        hasInitialized = true;
+    };
+
+    store.get = async (key: any) => {
+        if (!hasInitialized) {
+            await store.initialize();
+        }
+
+        const actualKey = `${storeId}:${key}`;
+
+        const value = (await chrome.storage[area].get(actualKey))[actualKey];
+        return isEncrypted ? await security.decrypt(value) : value;
+    };
+
+    store.set = async (key: any, value?: any) => {
+        if (!hasInitialized) {
+            await store.initialize();
+        }
+
+        // Handle the case where key is an object
+        if (typeof key === 'object' && value === undefined) {
+            const entriesToRemove: string[] = [];
+            const entriesToSet = {};
+
+            for (const [k, v] of Object.entries(key)) {
+                const actualKey = `${storeId}:${k}`;
+                if (v === undefined) {
+                    // Prepare to remove this key
+                    entriesToRemove.push(actualKey);
+                } else {
+                    // @ts-expect-error
+                    entriesToSet[actualKey] = isEncrypted ? await security.encrypt(v) : v;
+                }
+            }
+
+            // Remove keys with undefined values
+            if (entriesToRemove.length > 0) {
+                await chrome.storage[area].remove(entriesToRemove);
+            }
+
+            // Set keys with defined values
+            if (Object.keys(entriesToSet).length > 0) {
+                await chrome.storage[area].set(entriesToSet);
+            }
+
+            return;
+        }
+        // now we know key is a string, so lets either set or remove it directly
+
+        const actualKey = `${storeId}:${key}`;
+        if (value === undefined) {
+            // Remove if value is explicitly undefined
+            return await chrome.storage[area].remove(actualKey);
+        }
+
+        // Set the value, applying encryption if necessary
+        await chrome.storage[area].set({
+            [actualKey]: isEncrypted ? await security.encrypt(value) : value,
+        });
+    };
+
+    store.remove = async (key: any) => {
+        if (!hasInitialized) {
+            await store.initialize();
+        }
+
+        const actualKey = `${storeId}:${key}`;
+        await chrome.storage[area].remove(actualKey);
+    };
+
+    store.all = async () => {
+        if (!hasInitialized) {
+            await store.initialize();
+        }
+        const fullStore = await chrome.storage[area].get(actualKeys);
+        if (isEncrypted) {
+            await Promise.all(
+                keys.map(async key => {
+                    const actualKey = `${storeId}:${key}`;
+                    fullStore[key] = await security.decrypt(fullStore[actualKey]);
+                })
+            );
+        }
+        // now we need to remove the storeId from the keys
+        Object.keys(fullStore).forEach(actualKey => {
+            const newKey = actualKey.replace(`${storeId}:`, '');
+            fullStore[newKey] = fullStore[actualKey];
+            delete fullStore[actualKey];
+        });
+        return fullStore as Serializable<T>;
+    };
+
+    store.keys = () => keys as (keyof T & string)[];
+
+    store.subscribe = (key: string | string[], callback) => {
+        // @ts-expect-error
+        const sub = async (changes, areaName) => {
+            const keys = Array.isArray(key) ? key : [key];
+            const actualKeys = keys.map(k => `${storeId}:${k}`);
+
+            if (areaName !== area) return;
+
+            // make sure that there are keys is in the changes object
+            const subKeys = Object.keys(changes).filter(k => actualKeys.includes(k));
+            if (!subKeys.length) return;
+
+            subKeys.forEach(async actualKey => {
+                const key = actualKey.replace(`${storeId}:`, '');
+                const [oldValue, newValue] = await Promise.all([
+                    isEncrypted ? security.decrypt(changes[actualKey].oldValue) : changes[actualKey].oldValue,
+                    isEncrypted ? security.decrypt(changes[actualKey].newValue) : changes[actualKey].newValue,
+                ]);
+
+                callback({
+                    key,
+                    oldValue,
+                    newValue,
+                });
+            });
+        };
+
+        chrome.storage.onChanged.addListener(sub);
+        return sub;
+    };
+
+    store.unsubscribe = sub => {
+        chrome.storage.onChanged.removeListener(sub);
+    };
+
+    // @ts-ignore
+    store.use = (key: keyof T | null, defaultValue?: key extends null ? T : T[typeof key]) => {
+        const initialValue: any = (() => {
+            // an explicit default value was passed, use it
+            if (arguments.length === 2) {
+                return defaultValue;
+            }
+            // a key was passed, but no default value was passed, use the default value from the defaults object
+            if (key === null) {
+                return defaults;
+            }
+            // no key was passed, use the default value from the defaults object
+            return defaults[key];
+        })();
+
+        const [value, setValue] = useState(initialValue);
+
+        const onChange = ({ key: k, newValue }: DataChange<T>) => {
+            if (key === null) {
+                // @ts-expect-error
+                setValue(prev => ({ ...prev, [k]: newValue }) as any);
+            } else {
+                setValue(newValue as any);
+            }
+        };
+
+        useEffect(() => {
+            if (key === null) {
+                store
+                    .all()
+                    .then(setValue)
+                    .then(() => {
+                        store.subscribe(store.keys(), onChange as any);
+                    });
+            } else {
+                store
+                    .get(key)
+                    .then(setValue)
+                    .then(() => {
+                        store.subscribe(key, onChange as any);
+                    });
+            }
+            return () => {
+                store.unsubscribe(onChange as any);
+            };
+        }, []);
+
+        // @ts-expect-error
+        const set = async newValue => {
+            if (key === null) {
+                await store.set(newValue as any);
+            } else {
+                await store.set(key, newValue as any);
+            }
+        };
+
+        return [value, set] as any;
+    };
+
+    return store;
+}
+
+/**
+ * A function that creates a virtual storage bucket within the chrome.storage.local API.
+ * This store will persist across browser sessions and be stored on the user's computer.
+ *
+ * @param storeId A unique key to use for this store. This will be prepended to all keys in the store to avoid collisions. ex: 'my-store' -> 'my-store:myKey'
+ * @param defaults the default values for the store (these will be used to initialize the store if the key is not already set, and will be used as the type for the getters and setters)
+ * @param computed an optional function that allows you to override the generated getters and setters with your own. Provides a reference to the store itself so you can access this store's getters and setters.
+ * @param area the storage area to use. Defaults to 'local'
+ * @returns an object which contains getters/setters for the keys in the defaults object, as well as an initialize function and an onChanged functions
+ */
+export function createLocalStore<T>(storeId: string, defaults: StoreDefaults<T>, options?: StoreOptions): Store<T> {
+    return createStore(storeId, defaults, 'local', options);
+}
+
+/**
+ * A function that creates a virtual storage bucket within the chrome.storage.sync API.
+ * This store will persist across browser sessions and be stored on the user's Google account (if they are logged in).
+ * This means that the data will be synced across all of the user's devices.
+ *
+ * @param storeId A unique key to use for this store. This will be prepended to all keys in the store to avoid collisions. ex: 'my-store' -> 'my-store:myKey'
+ * @param defaults the default values for the store (these will be used to initialize the store if the key is not already set, and will be used as the type for the getters and setters)
+ * @param options options that modify the behavior of the store
+ * @returns an object which contains getters/setters for the keys in the defaults object, as well as an initialize function and an onChanged functions
+ */
+export function createSyncStore<T>(storeId: string, defaults: StoreDefaults<T>, options?: StoreOptions): Store<T> {
+    return createStore(storeId, defaults, 'sync', options);
+}
+
+/**
+ * A function that creates a virtual storage bucket within the chrome.storage.managed API.
+ * This store will persist across browser sessions and managed by the administrator of the user's computer.
+ *
+ * @param storeId A unique key to use for this store. This will be prepended to all keys in the store to avoid collisions. ex: 'my-store' -> 'my-store:myKey'
+ * @param defaults the default values for the store (these will be used to initialize the store if the key is not already set, and will be used as the type for the getters and setters)
+ * @param options options that modify the behavior of the store
+ * @returns an object which contains getters/setters for the keys in the defaults object, as well as an initialize function and an onChanged functions
+ * @see https://developer.chrome.com/docs/extensions/reference/storage/#type-ManagedStorageArea
+ *
+ */
+export function createManagedStore<T>(storeId: string, defaults: StoreDefaults<T>, options?: StoreOptions): Store<T> {
+    return createStore(storeId, defaults, 'managed', options);
+}
+
+/**
+ * A function that creates a virtual storage bucket within the chrome.storage.session API.
+ * This store will NOT persist across browser sessions and will be stored in memory. This will reset when the browser is closed.
+ *
+ * @param storeId A unique key to use for this store. This will be prepended to all keys in the store to avoid collisions. ex: 'my-store' -> 'my-store:myKey'
+ * @param defaults the default values for the store (these will be used to initialize the store if the key is not already set, and will be used as the type for the getters and setters)
+ * @param options options that modify the behavior of the store
+ * @returns an object which contains getters/setters for the keys in the defaults object, as well as an initialize function and an onChanged functions
+ */
+export function createSessionStore<T>(storeId: string, defaults: StoreDefaults<T>, options?: StoreOptions): Store<T> {
+    return createStore(storeId, defaults, 'session', options);
+}
+
+// interface MyStore {
+//     name: string;
+//     age: number;
+//     isCool?: boolean;
+// }
+// const store = createLocalStore<MyStore>('my-store', {
+//     age: 0,
+//     isCool: false,
+//     name: 'John Doe',
+// });

src/lib/chrome-extension-toolkit/storage/index.ts

@@ -0,0 +1,2 @@
+export * from './createStore';
+export * from './Security';

src/lib/chrome-extension-toolkit/types/Messaging.ts

@@ -0,0 +1,70 @@
+import type { Serializable } from './Serialization';
+
+/**
+ * MessageDefinition is a record of message names and their data types.
+ * The data type is the type of the first argument of the message handler.
+ * The return type of the message handler is the resolved type of the promise returned by the message sender.
+ */
+export type MessageDefinition<T extends Record<string, (data: Record<string, any> | undefined) => any>> = T;
+
+/**
+ * A helper type to extract the data type of a message handler.
+ */
+export type MessageData<M, K extends keyof M> = Serializable<
+    Parameters<M[K] extends (...args: any) => any ? M[K] : never>[0]
+>;
+
+/**
+ * A helper type to extract the resolved type of a message handler.
+ */
+export type MessageResponse<M, K extends keyof M> = Serializable<
+    ReturnType<M[K] extends (...args: any) => any ? M[K] : never>
+>;
+/**
+ * The internal object representing a message sent between chrome extension contexts.
+ */
+export type Message<M> = {
+    name: keyof M;
+    data: MessageData<M, keyof M>;
+    from: MessageEndpoint;
+    to: MessageEndpoint;
+};
+
+/**
+ * Represents the extension context in which a message is either sent or received.
+ * The context is either the background script/service worker or a tab.
+ */
+export enum MessageEndpoint {
+    /** The background script or service worker. */
+    BACKGROUND = 'BACKGROUND',
+    /** A foreground or extension page (popup, options, etc) */
+    FOREGROUND = 'FOREGROUND',
+}
+
+/**
+ * An object that implements the message handlers for each of the messages in the message definition.
+ */
+export type MessageHandler<M> = {
+    [K in keyof M]: (context: {
+        /** The data sent with the message. */
+        data: MessageData<M, K>;
+        /** The tab or page or background service worker that sent the message. */
+        sender: chrome.runtime.MessageSender;
+        /** A function that can be used to send a response asynchronously to the sender. */
+        sendResponse: (response: MessageResponse<M, K>) => void;
+    }) => Promise<void> | void;
+};
+
+/**
+ * An object that can be used to handle messages coming from another extension context.
+ */
+export interface IMessageListener<M> {
+    /**
+     * Starts listening for messages. When a message is received, the corresponding message handler is called.
+     */
+    listen: (handler: MessageHandler<M>) => void;
+    /**
+     * Stops listening for messages.
+     */
+    unlisten: () => void;
+}

src/lib/chrome-extension-toolkit/types/Serialization.ts

@@ -0,0 +1,69 @@
+type Primitive = string | number | boolean | null | undefined;
+
+/**
+ * A type that represents a serialized object. This is a recursive type that will serialize all properties of an object, except for functions which are ignored (and thus not serialized)
+ */
+export type Serialized<T> = {
+    [K in keyof T as T[K] extends Function ? never : K]: Serializable<T[K]>;
+};
+
+/**
+ * Represents a type that can be serialized to JSON. This could either be a primitive type, an array of serializable types, or a complex object
+ * Recursively serializes an object to a JSON-compatible object.
+ */
+export type Serializable<T> = T extends Primitive
+    ? T
+    : T extends Array<infer U>
+      ? Array<Serializable<U>>
+      : T extends object
+        ? Serialized<T>
+        : T;
+
+/**
+ * Serializes a value to a JSON-compatible object (i.e. a Serializable<T>)
+ * @returns A JSON-compatible object that represents the value passed in with all functions removed and all objects recursively serialized
+ */
+export function serialize<T>(value: T): Serializable<T> {
+    return JSON.parse(JSON.stringify(value)) as Serializable<T>;
+}
+
+// THIS IS FOR TESTINWG THE TYPING
+
+// type Test2 = {
+//     test: string;
+//     openNewTab: (url: string) => void;
+//     url?: URL;
+// };
+
+// type Test1 = {
+//     openNewTab: (url: string) => void;
+//     count: number;
+//     url: URL;
+//     urls?: URL[];
+//     foo: Test2;
+//     bar?: Test2;
+// };
+
+// let x: Serialized<Test1>;
+// //  ^?
+
+// type SerializedData = Serializable<Data>;
+
+// let data: SerializedData = {} as any;
+
+// data.url = undefined;
+
+// data = {
+//     a: 'test',
+//     b: 1,
+//     c: true,
+//     d: {
+//         e: 'test',
+//         t: undefined,
+//     },
+//     urls: [],
+// };
+
+// data.d = {
+//     e: 'test',
+// };

src/lib/chrome-extension-toolkit/types/Test.ts

@@ -0,0 +1,47 @@
+type Primitive = string | number | boolean | null | undefined;
+
+type Serialized<T> = {
+    [K in keyof T as T[K] extends Function ? never : K]: Serializable<T[K]>;
+};
+
+type Serializable<T> = T extends Primitive
+    ? T
+    : T extends Array<infer U>
+      ? Array<Serializable<U>>
+      : T extends object
+        ? Serialized<T>
+        : T;
+
+type Data = {
+    a: string;
+    b: number;
+    c: boolean;
+    url?: URL;
+    d: {
+        e: string;
+        t?: URL;
+    };
+    get: () => void;
+    urls: URL[];
+};
+
+type SerializedData = Serializable<Data>;
+
+let x: SerializedData = {} as any;
+
+x.url = undefined;
+
+x = {
+    a: 'test',
+    b: 1,
+    c: true,
+    d: {
+        e: 'test',
+        t: undefined,
+    },
+    urls: [],
+};
+
+x.d = {
+    e: 'test',
+};

src/lib/chrome-extension-toolkit/types/index.ts

@@ -0,0 +1,6 @@
+export * from './Messaging';
+export * from './Serialization';
+
+export type AddParameters<TFunction extends (...args: any) => any, TParameters extends [...args: any]> = (
+    ...args: [...Parameters<TFunction>, ...TParameters]
+) => ReturnType<TFunction>;

src/lib/chrome-extension-toolkit/utils/Console.ts

@@ -0,0 +1,48 @@
+const LOG_BACKGROUND_COLOR = '#2196F3';
+const LOG_TEXT_COLOR = '#fff';
+
+const SUCCESS_BACKGROUND_COLOR = '#4CAF50';
+const SUCCESS_TEXT_COLOR = '#fff';
+
+const ERROR_BACKGROUND_COLOR = '#F44336';
+const ERROR_TEXT_COLOR = '#fff';
+
+const WARNING_BACKGROUND_COLOR = '#FFC107';
+const WARNING_TEXT_COLOR = '#fff';
+
+/**
+ * Utility class for logging messages with different styles.
+ */
+export class Console {
+    static log(...args: any[]) {
+        console.log(
+            `%c ${args[0]} `,
+            `background: ${LOG_BACKGROUND_COLOR}; color: ${LOG_TEXT_COLOR}`,
+            ...args.slice(1)
+        );
+    }
+
+    static success(...args: any[]) {
+        console.log(
+            `%c ${args[0]} `,
+            `background: ${SUCCESS_BACKGROUND_COLOR}; color: ${SUCCESS_TEXT_COLOR}`,
+            ...args.slice(1)
+        );
+    }
+
+    static error(...args: any[]) {
+        console.error(
+            `%c ${args[0]} `,
+            `background: ${ERROR_BACKGROUND_COLOR}; color: ${ERROR_TEXT_COLOR}`,
+            ...args.slice(1)
+        );
+    }
+
+    static warn(...args: any[]) {
+        console.warn(
+            `%c ${args[0]} `,
+            `background: ${WARNING_BACKGROUND_COLOR}; color: ${WARNING_TEXT_COLOR}`,
+            ...args.slice(1)
+        );
+    }
+}

src/lib/chrome-extension-toolkit/utils/string.ts

@@ -0,0 +1,8 @@
+/**
+ * Capitalizes the first letter of a string
+ * @param str the string to capitalize
+ * @returns the capitalized string
+ */
+export function capitalize(str: string): string {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}

src/pages/404/Page404.tsx

@@ -271,12 +271,12 @@ export default function Page404(): JSX.Element {
         }
         function _0x5629d1() {
             let _0x13c635 = _0xdd3699;
-            _0x5b7f43(),
+            (_0x5b7f43(),
                 _0x16f39e[_0x13c635(0x81)](
                     _0x228047,
                     0x9c + -0x1 * 0x23ab + 0x230f * 0x1,
                     -0x1c26 + 0x7bf + -0x6cd * -0x3
-                );
+                ));
         }
         let _0x93f360 = 0x64 * 0x49 + 0x1e1e + -0x3aa2;
         function _0x5b7f43() {
@@ -373,12 +373,12 @@ export default function Page404(): JSX.Element {
                                         (-0x2469 + 0x156a * -0x1 + 0x39e2)) +
                                     (-0x1 * 0x13f8 + 0x6df + -0x1 * -0xd29);
                                 if (_0x3e178a == 0x1 * -0x1a87 + 0x1fdd + -0x555 * 0x1) {
-                                    (_0x546fb5 =
+                                    ((_0x546fb5 =
                                         (_0x227002 * (-0x10d7 + 0x1 * 0x15ad + -0x2 * 0x263)) &
                                         (-0x25ca * 0x1 + 0x8 * 0x278 + -0x1 * -0x1219)),
                                         (_0x1667c5 =
                                             (_0x32116b * (0x4d3 + 0x1c09 * -0x1 + 0x3 * 0x7c2)) &
-                                            (-0xf06 * 0x2 + -0x144f * -0x1 + -0x344 * -0x3));
+                                            (-0xf06 * 0x2 + -0x144f * -0x1 + -0x344 * -0x3)));
                                     if (_0x5b3085 < -0xa * 0xed + -0xd19 + 0x1 * 0x165b)
                                         _0x1667c5 += -0xd48 + 0xf6c + 0xc * -0x2b;
                                 }
@@ -410,10 +410,10 @@ export default function Page404(): JSX.Element {
                                         (-0x2709 + -0x6 * -0x312 + -0x39a * -0x6)),
                                     (_0x267dd3 = _0x38c463));
                             }
-                            (_0x227002 += _0x4b089b),
+                            ((_0x227002 += _0x4b089b),
                                 (_0x2aec99 += _0x5b3085),
                                 (_0x32116b += _0x1eaaad),
-                                (_0x38c463 += _0x57383c);
+                                (_0x38c463 += _0x57383c));
                         }
                     }
                     let _0x5cba48 =
@@ -430,7 +430,7 @@ export default function Page404(): JSX.Element {
                     let _0xdf8389 =
                         ((_0x13f1b0 & (-0x247a + -0x4 * -0x9c2 + -0x39 * 0x7)) * _0x2062a9 * _0x5c387a) /
                         ((0x1d5 * 0xa + -0x250a + -0x31 * -0x67) * (-0x7 * 0x25f + -0xae7 + 0x1c7f * 0x1));
-                    (_0x228047[_0x4626de(0x8e)][
+                    ((_0x228047[_0x4626de(0x8e)][
                         (_0x132623 + _0x1a573d * _0x124180) * (0x29 * -0xa9 + -0x94 * -0x2b + -0x239 * -0x1) +
                             (0x55d * 0x2 + 0xeed * 0x1 + -0xc7 * 0x21)
                     ] = _0x5cba48),
@@ -441,7 +441,7 @@ export default function Page404(): JSX.Element {
                         (_0x228047[_0x4626de(0x8e)][
                             (_0x132623 + _0x1a573d * _0x124180) * (0x1e2a + -0x21df + -0x1 * -0x3b9) +
                                 (0x1e79 + 0x860 * -0x2 + 0x1 * -0xdb7)
-                        ] = _0xdf8389);
+                        ] = _0xdf8389));
                 }
             }
         }

src/pages/background/background.ts

@@ -1,7 +1,7 @@
+import { MessageListener } from '@chrome-extension-toolkit';
 import type { BACKGROUND_MESSAGES } from '@shared/messages';
 import { UserScheduleStore } from '@shared/storage/UserScheduleStore';
 import updateBadgeText from '@shared/util/updateBadgeText';
-import { MessageListener } from 'chrome-extension-toolkit';
 
 import onInstall from './events/onInstall';
 import onServiceWorkerAlive from './events/onServiceWorkerAlive';
@@ -9,6 +9,7 @@ import onUpdate from './events/onUpdate';
 import browserActionHandler from './handler/browserActionHandler';
 import calendarBackgroundHandler from './handler/calendarBackgroundHandler';
 import CESHandler from './handler/CESHandler';
+import gitHubStatsHandler from './handler/gitHubStatsHandler';
 import tabManagementHandler from './handler/tabManagementHandler';
 import userScheduleHandler from './handler/userScheduleHandler';
 
@@ -52,17 +53,18 @@ const messageListener = new MessageListener<BACKGROUND_MESSAGES>({
     ...userScheduleHandler,
     ...CESHandler,
     ...calendarBackgroundHandler,
+    ...gitHubStatsHandler,
 });
 
 messageListener.listen();
 
-UserScheduleStore.listen('schedules', async schedules => {
+UserScheduleStore.subscribe('schedules', async schedules => {
     const index = await UserScheduleStore.get('activeIndex');
     const numCourses = schedules.newValue[index]?.courses?.length;
     updateBadgeText(numCourses || 0);
 });
 
-UserScheduleStore.listen('activeIndex', async ({ newValue }) => {
+UserScheduleStore.subscribe('activeIndex', async ({ newValue }) => {
     const schedules = await UserScheduleStore.get('schedules');
     const numCourses = schedules[newValue]?.courses?.length;
     updateBadgeText(numCourses || 0);

src/pages/background/handler/CESHandler.ts

@@ -1,6 +1,6 @@
 import openNewTab from '@background/util/openNewTab';
+import type { MessageHandler } from '@chrome-extension-toolkit';
 import type CESMessage from '@shared/messages/CESMessage';
-import type { MessageHandler } from 'chrome-extension-toolkit';
 
 const CESFall2023Url = 'https://utexas.bluera.com/utexas/rpvl.aspx?rid=d3db767b-049f-46c5-9a67-29c21c29c580&regl=en-US';
 

src/pages/background/handler/browserActionHandler.ts

@@ -1,5 +1,5 @@
+import type { MessageHandler } from '@chrome-extension-toolkit';
 import type BrowserActionMessages from '@shared/messages/BrowserActionMessages';
-import type { MessageHandler } from 'chrome-extension-toolkit';
 
 const browserActionHandler: MessageHandler<BrowserActionMessages> = {
     disableBrowserAction({ sender, sendResponse }) {

src/pages/background/handler/calendarBackgroundHandler.ts

@@ -1,14 +1,14 @@
 import type { TabWithId } from '@background/util/openNewTab';
 import openNewTab from '@background/util/openNewTab';
+import type { MessageHandler } from '@chrome-extension-toolkit';
 import { tabs } from '@shared/messages';
 import type { CalendarBackgroundMessages } from '@shared/messages/CalendarMessages';
 import { OptionsStore } from '@shared/storage/OptionsStore';
 import { CRX_PAGES } from '@shared/types/CRXPages';
-import type { MessageHandler } from 'chrome-extension-toolkit';
 
 const getAllTabInfos = async () => {
     const openTabs = (await chrome.tabs.query({})).filter((tab): tab is TabWithId => tab.id !== undefined);
-    const results = await Promise.allSettled(openTabs.map(tab => tabs.getTabInfo(undefined, tab.id)));
+    const results = await Promise.allSettled(openTabs.map(tab => tabs.getTabInfo({ tabId: tab.id })));
 
     type TabInfo = PromiseFulfilledResult<Awaited<ReturnType<typeof tabs.getTabInfo>>>;
     return results
@@ -34,7 +34,7 @@ const calendarBackgroundHandler: MessageHandler<CalendarBackgroundMessages> = {
 
             await chrome.tabs.update(tabid, { active: true });
             await chrome.windows.update(openCalendarTabInfo.tab.windowId, { focused: true, drawAttention: true });
-            if (uniqueId !== undefined) await tabs.openCoursePopup({ uniqueId }, tabid);
+            if (uniqueId !== undefined) await tabs.openCoursePopup({ uniqueId }, { tabId: tabid });
 
             sendResponse(openCalendarTabInfo.tab);
         } else {

src/pages/background/handler/gitHubStatsHandler.ts

@@ -0,0 +1,31 @@
+import type { MessageHandler } from '@chrome-extension-toolkit';
+import type GitHubStatsMessages from '@shared/messages/GitHubStatsMessages';
+import { GitHubStatsService } from '@views/lib/getGitHubStats';
+
+const gitHubStatsService = new GitHubStatsService();
+
+/**
+ * Handler for GitHub stats related messages
+ */
+const gitHubStatsHandler: MessageHandler<GitHubStatsMessages> = {
+    async fetchGitHubStats({ data, sendResponse }) {
+        try {
+            const includeMergedPRs = data ?? false;
+            const stats = await gitHubStatsService.fetchGitHubStats({ includeMergedPRs });
+            sendResponse(stats);
+        } catch (error) {
+            console.error('Error fetching GitHub stats in background:', error);
+            sendResponse({
+                adminGitHubStats: {},
+                userGitHubStats: {},
+                contributors: [],
+                names: {},
+                dataFetched: new Date(),
+                lastUpdated: new Date(),
+                isCached: false,
+            });
+        }
+    },
+};
+
+export default gitHubStatsHandler;

src/pages/background/handler/tabManagementHandler.ts

@@ -1,6 +1,6 @@
+import type { MessageHandler } from '@chrome-extension-toolkit';
 import openNewTab from '@pages/background/util/openNewTab';
 import type TabManagementMessages from '@shared/messages/TabManagementMessages';
-import type { MessageHandler } from 'chrome-extension-toolkit';
 
 const tabManagementHandler: MessageHandler<TabManagementMessages> = {
     getTabId({ sendResponse, sender }) {

src/pages/background/handler/userScheduleHandler.ts

@@ -1,3 +1,4 @@
+import type { MessageHandler } from '@chrome-extension-toolkit';
 import addCourse from '@pages/background/lib/addCourse';
 import clearCourses from '@pages/background/lib/clearCourses';
 import createSchedule from '@pages/background/lib/createSchedule';
@@ -9,7 +10,6 @@ import switchSchedule from '@pages/background/lib/switchSchedule';
 import type { UserScheduleMessages } from '@shared/messages/UserScheduleMessages';
 import { Course } from '@shared/types/Course';
 import { validateLoginStatus } from '@shared/util/checkLoginStatus';
-import type { MessageHandler } from 'chrome-extension-toolkit';
 
 const userScheduleHandler: MessageHandler<UserScheduleMessages> = {
     addCourse({ data, sendResponse }) {

src/pages/background/lib/createSchedule.ts

@@ -1,7 +1,7 @@
+import type { Serialized } from '@chrome-extension-toolkit';
 import { UserScheduleStore } from '@shared/storage/UserScheduleStore';
 import type { UserSchedule } from '@shared/types/UserSchedule';
 import { generateRandomId } from '@shared/util/random';
-import type { Serialized } from 'chrome-extension-toolkit';
 
 /**
  * Creates a new schedule with the given name
@@ -37,6 +37,9 @@ export default async function createSchedule(scheduleName: string) {
 
     await UserScheduleStore.set('schedules', schedules);
 
+    // Automatically switch to the new schedule
+    await UserScheduleStore.set('activeIndex', schedules.length - 1);
+
     // If there is only one schedule, set the active index to the new schedule
     if (schedules.length <= 1) {
         await UserScheduleStore.set('activeIndex', 0);

src/pages/background/lib/duplicateSchedule.ts

@@ -31,5 +31,9 @@ export default async function duplicateSchedule(scheduleId: string): Promise<str
     } satisfies typeof schedule);
 
     await UserScheduleStore.set('schedules', schedules);
+
+    // Automatically switch to the duplicated schedule
+    await UserScheduleStore.set('activeIndex', scheduleIndex + 1);
+
     return undefined;
 }

src/pages/background/lib/importSchedule.ts

@@ -1,6 +1,6 @@
+import type { Serialized } from '@chrome-extension-toolkit';
 import { Course } from '@shared/types/Course';
 import type { UserSchedule } from '@shared/types/UserSchedule';
-import type { Serialized } from 'chrome-extension-toolkit';
 
 import addCourse from './addCourse';
 import createSchedule from './createSchedule';

src/pages/calendar/CalendarMain.tsx

@@ -1,3 +1,4 @@
+import { MessageListener } from '@chrome-extension-toolkit';
 import type TabInfoMessages from '@shared/messages/TabInfoMessages';
 import Calendar from '@views/components/calendar/Calendar';
 import DialogProvider from '@views/components/common/DialogProvider/DialogProvider';
@@ -5,7 +6,6 @@ import ExtensionRoot from '@views/components/common/ExtensionRoot/ExtensionRoot'
 import { MigrationDialog } from '@views/components/common/MigrationDialog';
 import { WhatsNewDialog } from '@views/components/common/WhatsNewPopup';
 import SentryProvider from '@views/contexts/SentryContext';
-import { MessageListener } from 'chrome-extension-toolkit';
 import useKC_DABR_WASM from 'kc-dabr-wasm';
 import React, { useEffect } from 'react';
 

src/pages/content/index.tsx

@@ -1,6 +1,7 @@
 import CourseCatalogMain from '@views/components/CourseCatalogMain';
 import InjectedButton from '@views/components/injected/AddAllButton';
 import DaysCheckbox from '@views/components/injected/DaysCheckbox';
+import ShadedResults from '@views/components/injected/SearchResultShader';
 import getSiteSupport, { SiteSupport } from '@views/lib/getSiteSupport';
 import React from 'react';
 import { createRoot } from 'react-dom/client';
@@ -30,3 +31,7 @@ if (support === SiteSupport.MY_UT) {
 if (support === SiteSupport.COURSE_CATALOG_SEARCH) {
     renderComponent(DaysCheckbox);
 }
+
+if (support === SiteSupport.COURSE_CATALOG_KWS) {
+    renderComponent(ShadedResults);
+}

src/shared/messages/GitHubStatsMessages.ts

@@ -0,0 +1,12 @@
+import type { GitHubStatsResult } from '@shared/types/GitHubStats';
+
+/* eslint-disable jsdoc/require-jsdoc */
+
+export default interface GitHubStatsMessages {
+    /**
+     * Fetch GitHub statistics for all contributors
+     * @param includeMergedPRs - Whether to include merged PR counts (optional, default: false)
+     * @returns GitHub stats including commits, lines added/deleted, and optionally merged PRs
+     */
+    fetchGitHubStats: (includeMergedPRs?: boolean) => GitHubStatsResult;
+}

src/shared/messages/index.ts

@@ -1,8 +1,9 @@
-import { createMessenger } from 'chrome-extension-toolkit';
+import { createMessenger } from '@chrome-extension-toolkit';
 
 import type BrowserActionMessages from './BrowserActionMessages';
 import type { CalendarBackgroundMessages, CalendarTabMessages } from './CalendarMessages';
 import type CESMessage from './CESMessage';
+import type GitHubStatsMessages from './GitHubStatsMessages';
 import type TabInfoMessages from './TabInfoMessages';
 import type TabManagementMessages from './TabManagementMessages';
 import type { UserScheduleMessages } from './UserScheduleMessages';
@@ -14,7 +15,8 @@ export type BACKGROUND_MESSAGES = BrowserActionMessages &
     TabManagementMessages &
     UserScheduleMessages &
     CESMessage &
-    CalendarBackgroundMessages;
+    CalendarBackgroundMessages &
+    GitHubStatsMessages;
 
 /**
  * This is a type with all the message definitions that can be sent TO specific tabs

src/shared/storage/CacheStore.ts

@@ -1,5 +1,5 @@
+import { createLocalStore } from '@chrome-extension-toolkit';
 import type { CachedData } from '@shared/types/CachedData';
-import { createLocalStore, debugStore } from 'chrome-extension-toolkit';
 
 interface ICacheStore {
     github: Record<string, CachedData<unknown>>;
@@ -8,8 +8,8 @@ interface ICacheStore {
 /**
  * A store that is used for storing cached data such as GitHub contributors
  */
-export const CacheStore = createLocalStore<ICacheStore>({
+export const CacheStore = createLocalStore<ICacheStore>('CacheStore', {
     github: {},
 });
 
-debugStore({ cacheStore: CacheStore });
+// debugStore({ cacheStore: CacheStore });

src/shared/storage/DevStore.ts

@@ -1,4 +1,4 @@
-import { createLocalStore, debugStore } from 'chrome-extension-toolkit';
+import { createLocalStore } from '@chrome-extension-toolkit';
 
 /**
  * A store that is used to store data that is only relevant during development
@@ -18,7 +18,7 @@ interface IDevStore {
     reloadTabId?: number;
 }
 
-export const DevStore = createLocalStore<IDevStore>({
+export const DevStore = createLocalStore<IDevStore>('DevStore', {
     isDeveloper: false,
     debugTabId: undefined,
     isTabReloading: true,
@@ -27,4 +27,4 @@ export const DevStore = createLocalStore<IDevStore>({
     reloadTabId: undefined,
 });
 
-debugStore({ devStore: DevStore });
+// debugStore({ devStore: DevStore });

src/shared/storage/ExtensionStore.ts

@@ -1,4 +1,4 @@
-import { createLocalStore, debugStore } from 'chrome-extension-toolkit';
+import { createLocalStore } from '@chrome-extension-toolkit';
 
 /**
  * A store that is used for storing user options
@@ -12,10 +12,10 @@ interface IExtensionStore {
     lastWhatsNewPopupVersion: number;
 }
 
-export const ExtensionStore = createLocalStore<IExtensionStore>({
+export const ExtensionStore = createLocalStore<IExtensionStore>('ExtensionStore', {
     version: chrome.runtime.getManifest().version,
     lastUpdate: Date.now(),
     lastWhatsNewPopupVersion: 0,
 });
 
-debugStore({ ExtensionStore });
+// debugStore({ ExtensionStore });

src/shared/storage/OptionsStore.ts

@@ -1,4 +1,4 @@
-import { createSyncStore, debugStore } from 'chrome-extension-toolkit';
+import { createSyncStore } from '@chrome-extension-toolkit';
 
 /**
  * A store that is used for storing user options
@@ -24,9 +24,11 @@ export interface IOptionsStore {
 
     /** whether the promo should be shown */
     showUTDiningPromo: boolean;
+    /** whether users are allowed to bypass the 10 schedule limit */
+    allowMoreSchedules: boolean;
 }
 
-export const OptionsStore = createSyncStore<IOptionsStore>({
+export const OptionsStore = createSyncStore<IOptionsStore>('OptionsStore', {
     enableCourseStatusChips: false,
     enableHighlightConflicts: true,
     enableScrollToLoad: true,
@@ -34,6 +36,7 @@ export const OptionsStore = createSyncStore<IOptionsStore>({
     alwaysOpenCalendarInNewTab: false,
     showCalendarSidebar: true,
     showUTDiningPromo: true,
+    allowMoreSchedules: false,
 });
 
 /**
@@ -50,8 +53,9 @@ export const initSettings = async () =>
         alwaysOpenCalendarInNewTab: await OptionsStore.get('alwaysOpenCalendarInNewTab'),
         showCalendarSidebar: await OptionsStore.get('showCalendarSidebar'),
         showUTDiningPromo: await OptionsStore.get('showUTDiningPromo'),
+        allowMoreSchedules: await OptionsStore.get('allowMoreSchedules'),
     }) satisfies IOptionsStore;
 
 // Clothing retailer right
 
-debugStore({ OptionsStore });
+// debugStore({ OptionsStore });

src/shared/storage/UserScheduleStore.ts

@@ -1,5 +1,5 @@
+import { createLocalStore } from '@chrome-extension-toolkit';
 import { UserSchedule } from '@shared/types/UserSchedule';
-import { createLocalStore, debugStore } from 'chrome-extension-toolkit';
 
 import { generateRandomId } from '../util/random';
 
@@ -11,7 +11,7 @@ interface IUserScheduleStore {
 /**
  * A store that is used for storing user schedules (and the active schedule)
  */
-export const UserScheduleStore = createLocalStore<IUserScheduleStore>({
+export const UserScheduleStore = createLocalStore<IUserScheduleStore>('UserScheduleStore', {
     schedules: [
         new UserSchedule({
             courses: [],
@@ -24,4 +24,4 @@ export const UserScheduleStore = createLocalStore<IUserScheduleStore>({
     activeIndex: 0,
 });
 
-debugStore({ userScheduleStore: UserScheduleStore });
+// debugStore({ userScheduleStore: UserScheduleStore });

src/shared/types/Course.ts

@@ -1,5 +1,5 @@
+import type { Serialized } from '@chrome-extension-toolkit';
 import { getCourseColors } from '@shared/util/colors';
-import type { Serialized } from 'chrome-extension-toolkit';
 
 import type { CourseMeeting } from './CourseMeeting';
 import { CourseSchedule } from './CourseSchedule';
@@ -44,7 +44,12 @@ export type Semester = {
 export class Course {
     /** Every course has a uniqueId within UT's registrar system corresponding to each course section */
     uniqueId!: number;
-    /** This is the course number for a course, i.e CS 314 would be 314, MAL 306H would be 306H */
+    /**
+     * This is the course number for a course, i.e CS 314 would be 314, MAL 306H would be 306H.
+     * UT prefixes summer courses with f, s, n, or w:
+     * [f]irst term, [s]econd term, [n]ine week term, [w]hole term.
+     * So, the first term of PSY 301 over the summer would be 'f301'
+     */
     number!: string;
     /** The full name of the course, i.e. CS 314 Data Structures and Algorithms */
     fullName!: string;
@@ -91,6 +96,46 @@ export class Course {
         }
         this.colors = course.colors ? structuredClone(course.colors) : getCourseColors('emerald', 500);
         this.core = course.core ?? [];
+        if (course.semester.season === 'Summer') {
+            // A bug from and old version put the summer term in the course,
+            // so we need to handle that case
+            const { department, number } = Course.cleanSummerTerm(course.department, course.number);
+            this.department = department;
+            this.number = number;
+        }
+    }
+
+    /**
+     * Due to a bug in an older version, the summer term was included in the course department code,
+     * instead of the course number.
+     * UT prefixes summer courses with f, s, n, or w:
+     * [f]irst term, [s]econd term, [n]ine week term, [w]hole term
+     *
+     * @param department - The course department code, like 'C S'
+     * @param number - The course number, like '314H'
+     * @returns The properly formatted department and course number
+     * @example
+     * ```ts
+     * cleanSummerTerm('C S',  '314H') // { department: 'C S', number: '314H' }
+     * cleanSummerTerm('P R',  'f378') // { department: 'P R', number: 'f378' }
+     * cleanSummerTerm('P R f', '378') // { department: 'P R', number: 'f378' }
+     * cleanSummerTerm('P S',  'n303') // { department: 'P S', number: 'n303' }
+     * cleanSummerTerm('P S n', '303') // { department: 'P S', number: 'n303' }
+     * ```
+     */
+    static cleanSummerTerm(department: string, number: string): { department: string; number: string } {
+        // UT prefixes summer courses with f, s, n, or w:
+        // [f]irst term, [s]econd term, [n]ine week term, [w]hole term
+        const summerTerm = department.match(/[fsnw]$/);
+
+        if (!summerTerm) {
+            return { department, number };
+        }
+
+        return {
+            department: department.slice(0, -1).trim(),
+            number: summerTerm[0] + number,
+        };
     }
 
     /**
@@ -111,6 +156,18 @@ export class Course {
 
         return conflicts;
     }
+
+    /**
+     * @returns The course number without the summer term
+     * @example
+     * ```ts
+     * const c = new Course({ number: 'f301', ... });
+     * c.getNumberWithoutTerm() // '301'
+     * ```
+     */
+    getNumberWithoutTerm(): string {
+        return this.number.replace(/^\D/, ''); // Remove nondigit at start, if it exists
+    }
 }
 
 /**

src/shared/types/CourseMeeting.ts

@@ -1,4 +1,4 @@
-import type { Serialized } from 'chrome-extension-toolkit';
+import type { Serialized } from '@chrome-extension-toolkit';
 
 /**
  * a map of the days of the week that a class is taught, and the corresponding abbreviation

src/shared/types/CourseSchedule.ts

@@ -1,4 +1,4 @@
-import type { Serialized } from 'chrome-extension-toolkit';
+import type { Serialized } from '@chrome-extension-toolkit';
 
 import type { Day } from './CourseMeeting';
 import { CourseMeeting, DAY_MAP } from './CourseMeeting';

src/shared/types/GitHubStats.ts

@@ -0,0 +1,40 @@
+/* eslint-disable jsdoc/require-jsdoc */
+export type TeamMember = {
+    name: string;
+    role: string[];
+    githubUsername: string;
+};
+
+export type GitHubStats = {
+    commits: number;
+    linesAdded: number;
+    linesDeleted: number;
+    mergedPRs?: number;
+};
+
+export type GitHubStatsResult = {
+    adminGitHubStats: Record<string, GitHubStats>;
+    userGitHubStats: Record<string, GitHubStats>;
+    contributors: string[];
+    names: Record<string, string>;
+    dataFetched: Date;
+    lastUpdated: Date;
+    isCached: boolean;
+};
+
+export type ContributorStats = {
+    total: number;
+    weeks: { w: number; a: number; d: number; c: number }[];
+    author: { login: string };
+};
+
+export type ContributorUser = {
+    name: string | undefined;
+};
+
+export type FetchResult<T> = {
+    data: T;
+    dataFetched: Date;
+    lastUpdated: Date;
+    isCached: boolean;
+};

src/shared/types/Instructor.ts

@@ -1,5 +1,5 @@
+import type { Serialized } from '@chrome-extension-toolkit';
 import { capitalize } from '@shared/util/string';
-import type { Serialized } from 'chrome-extension-toolkit';
 
 /**
  * A type representing an instructor for a course (who teaches it)

src/shared/types/UserSchedule.ts

@@ -1,4 +1,4 @@
-import type { Serialized } from 'chrome-extension-toolkit';
+import type { Serialized } from '@chrome-extension-toolkit';
 
 import { generateRandomId } from '../util/random';
 import { Course } from './Course';

src/shared/types/tests/Course.test.ts

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest';
+
+import { Course } from '../Course';
+
+describe('Course::cleanSummerTerm', () => {
+    it("shouldn't affect already cleaned summer terms", () => {
+        const inputs = [
+            ['C S', '314H'],
+            ['P R', 'f378'],
+            ['P S', 'f303'],
+            ['WGS', 's301'],
+            ['S W', 'n360K'],
+            ['GOV', 'w312L'],
+            ['J', 's311F'],
+            ['J S', '311F'],
+        ] as const;
+        const expected = [
+            { department: 'C S', number: '314H' },
+            { department: 'P R', number: 'f378' },
+            { department: 'P S', number: 'f303' },
+            { department: 'WGS', number: 's301' },
+            { department: 'S W', number: 'n360K' },
+            { department: 'GOV', number: 'w312L' },
+            { department: 'J', number: 's311F' },
+            { department: 'J S', number: '311F' },
+        ];
+
+        const results = inputs.map(input => Course.cleanSummerTerm(input[0], input[1]));
+
+        expect(results).toEqual(expected);
+    });
+
+    it('should move summer term indicator to course number', () => {
+        const inputs = [
+            ['P R f', '378'],
+            ['P S f', '303'],
+            ['WGS s', '301'],
+            ['S W n', '360K'],
+            ['GOV w', '312L'],
+            ['J s', '311F'],
+            ['J S', '311F'],
+        ] as const;
+        const expected = [
+            { department: 'P R', number: 'f378' },
+            { department: 'P S', number: 'f303' },
+            { department: 'WGS', number: 's301' },
+            { department: 'S W', number: 'n360K' },
+            { department: 'GOV', number: 'w312L' },
+            { department: 'J', number: 's311F' },
+            { department: 'J S', number: '311F' },
+        ];
+
+        const results = inputs.map(input => Course.cleanSummerTerm(input[0], input[1]));
+
+        expect(results).toEqual(expected);
+    });
+});

src/shared/util/colors.ts

@@ -1,4 +1,4 @@
-import type { Serialized } from 'chrome-extension-toolkit';
+import type { Serialized } from '@chrome-extension-toolkit';
 import { theme } from 'unocss/preset-mini';
 
 import type { HexColor, HSL, Lab, RGB, sRGB } from '../types/Color';

src/stories/components/CalendarFooter.stories.tsx

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import CalendarFooter from '@views/components/calendar/CalendarFooter';
+import React from 'react';
+
+const meta = {
+    title: 'Components/Calendar/CalendarFooter',
+    component: CalendarFooter,
+    parameters: {
+        layout: 'centered',
+    },
+    tags: ['autodocs'],
+} satisfies Meta<typeof CalendarFooter>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+    args: {},
+};

src/stories/components/Dropdown.stories.tsx

@@ -1,3 +1,4 @@
+import type { Serialized } from '@chrome-extension-toolkit';
 import { UserScheduleStore } from '@shared/storage/UserScheduleStore';
 import { UserSchedule } from '@shared/types/UserSchedule';
 import { generateRandomId } from '@shared/util/random';
@@ -7,7 +8,6 @@ import ScheduleDropdown from '@views/components/common/ScheduleDropdown';
 import ScheduleListItem from '@views/components/common/ScheduleListItem';
 import { SortableList } from '@views/components/common/SortableList';
 import useSchedules, { getActiveSchedule, switchSchedule } from '@views/hooks/useSchedules';
-import type { Serialized } from 'chrome-extension-toolkit';
 import React, { useEffect } from 'react';
 
 import { exampleSchedule } from '../injected/mocked';

src/stories/components/SortableList.stories.tsx

@@ -73,7 +73,7 @@ const generateCourses = (count: number): Course[] => {
 
 const exampleCourses = generateCourses(numberOfCourses);
 
-type CourseWithId = Course & BaseItem;
+type CourseWithId = { course: Course } & BaseItem;
 
 const meta = {
     title: 'Components/Common/SortableList',
@@ -91,11 +91,10 @@ export const Default: Story = {
     args: {
         draggables: exampleCourses.map(course => ({
             id: course.uniqueId,
-            ...course,
+            course,
-            getConflicts: course.getConflicts,
         })),
         onChange: () => {},
-        renderItem: course => <PopupCourseBlock key={course.id} course={course} colors={course.colors} />,
+        renderItem: ({ id, course }) => <PopupCourseBlock key={id} course={course} colors={course.colors} />,
     },
     render: args => (
         <div className='h-3xl w-3xl transform-none'>

src/views/components/CourseCatalogMain.tsx

@@ -15,6 +15,8 @@ import type { SiteSupportType } from '@views/lib/getSiteSupport';
 import { populateSearchInputs } from '@views/lib/populateSearchInputs';
 import React, { useEffect, useRef, useState } from 'react';
 
+import DialogProvider from './common/DialogProvider/DialogProvider';
+
 interface Props {
     support: Extract<SiteSupportType, 'COURSE_CATALOG_DETAILS' | 'COURSE_CATALOG_LIST'>;
 }
@@ -82,28 +84,30 @@ export default function CourseCatalogMain({ support }: Props): JSX.Element | nul
 
     return (
         <ExtensionRoot>
-            <NewSearchLink />
+            <DialogProvider>
-            <RecruitmentBanner />
+                <NewSearchLink />
-            <TableHead>Plus</TableHead>
+                <RecruitmentBanner />
-            {rows.map(
+                <TableHead>Plus</TableHead>
-                row =>
+                {rows.map(
-                    row.course && (
+                    row =>
-                        <TableRow
+                        row.course && (
-                            key={row.course.uniqueId}
+                            <TableRow
-                            row={row}
+                                key={row.course.uniqueId}
-                            isSelected={row.course.uniqueId === selectedCourse?.uniqueId}
+                                row={row}
-                            activeSchedule={activeSchedule}
+                                isSelected={row.course.uniqueId === selectedCourse?.uniqueId}
-                            onClick={handleRowButtonClick(row.course)}
+                                activeSchedule={activeSchedule}
-                        />
+                                onClick={handleRowButtonClick(row.course)}
-                    )
+                            />
-            )}
+                        )
-            <CourseCatalogInjectedPopup
+                )}
-                course={selectedCourse!} // always defined when showPopup is true
+                <CourseCatalogInjectedPopup
-                show={showPopup}
+                    course={selectedCourse!} // always defined when showPopup is true
-                onClose={() => setShowPopup(false)}
+                    show={showPopup}
-                afterLeave={() => setSelectedCourse(null)}
+                    onClose={() => setShowPopup(false)}
-            />
+                    afterLeave={() => setSelectedCourse(null)}
-            {enableScrollToLoad && <AutoLoad addRows={addRows} />}
+                />
+                {enableScrollToLoad && <AutoLoad addRows={addRows} />}
+            </DialogProvider>
         </ExtensionRoot>
     );
 }

src/views/components/PopupMain.tsx

@@ -37,7 +37,7 @@ export default function PopupMain(): JSX.Element {
 
         initAllSettings();
 
-        const l1 = OptionsStore.listen('enableCourseStatusChips', async ({ newValue }) => {
+        const l1 = OptionsStore.subscribe('enableCourseStatusChips', async ({ newValue }) => {
             setEnableCourseStatusChips(newValue);
             // console.log('enableCourseStatusChips', newValue);
         });
@@ -48,7 +48,7 @@ export default function PopupMain(): JSX.Element {
         // });
 
         return () => {
-            OptionsStore.removeListener(l1);
+            OptionsStore.unsubscribe(l1);
             // OptionsStore.removeListener(l2);
         };
     }, []);
@@ -155,15 +155,14 @@ export default function PopupMain(): JSX.Element {
                     <SortableList
                         draggables={activeSchedule.courses.map(course => ({
                             id: course.uniqueId,
-                            ...course,
+                            course,
-                            getConflicts: course.getConflicts,
                         }))}
                         onChange={reordered => {
-                            activeSchedule.courses = reordered.map(({ id: _id, ...course }) => course);
+                            activeSchedule.courses = reordered.map(({ course }) => course);
                             replaceSchedule(getActiveSchedule(), activeSchedule);
                         }}
-                        renderItem={course => (
+                        renderItem={({ id, course }) => (
-                            <PopupCourseBlock key={course.id} course={course} colors={course.colors} />
+                            <PopupCourseBlock key={id} course={course} colors={course.colors} />
                         )}
                     />
                 )}

src/views/components/calendar/Calendar.tsx

@@ -1,3 +1,4 @@
+import { MessageListener } from '@chrome-extension-toolkit';
 import { Sidebar } from '@phosphor-icons/react';
 import type { CalendarTabMessages } from '@shared/messages/CalendarMessages';
 import { OptionsStore } from '@shared/storage/OptionsStore';
@@ -16,7 +17,6 @@ import { CalendarContext } from '@views/contexts/CalendarContext';
 import useCourseFromUrl from '@views/hooks/useCourseFromUrl';
 import { useFlattenedCourseSchedule } from '@views/hooks/useFlattenedCourseSchedule';
 import useWhatsNewPopUp from '@views/hooks/useWhatsNew';
-import { MessageListener } from 'chrome-extension-toolkit';
 import clsx from 'clsx';
 import type { ReactNode } from 'react';
 import React, { useEffect, useState } from 'react';
@@ -114,11 +114,12 @@ export default function Calendar(): ReactNode {
                             <LargeLogo />
                             <Button
                                 variant='minimal'
+                                size='small'
                                 color='theme-black'
                                 onClick={() => {
                                     setShowSidebar(!showSidebar);
                                 }}
-                                className='h-fit screenshot:hidden !p-0'
+                                className='screenshot:hidden'
                                 icon={Sidebar}
                             />
                         </div>

src/views/components/calendar/CalendarCourseCell.tsx

@@ -61,13 +61,13 @@ export default function CalendarCourseCell({
     useEffect(() => {
         initSettings().then(({ enableCourseStatusChips }) => setEnableCourseStatusChips(enableCourseStatusChips));
 
-        const l1 = OptionsStore.listen('enableCourseStatusChips', async ({ newValue }) => {
+        const l1 = OptionsStore.subscribe('enableCourseStatusChips', async ({ newValue }) => {
             setEnableCourseStatusChips(newValue);
             // console.log('enableCourseStatusChips', newValue);
         });
 
         return () => {
-            OptionsStore.removeListener(l1);
+            OptionsStore.unsubscribe(l1);
         };
     }, []);
 

src/views/components/calendar/CalendarCourseCellColorPicker/CourseCellColorPicker.tsx

@@ -124,17 +124,15 @@ export default function CourseCellColorPicker({ defaultColor }: CourseCellColorP
                 <>
                     <Divider orientation='horizontal' size='100%' className='my-1' />
                     <div className='grid grid-cols-6 gap-1'>
-                        {colorPatchColors
+                        {colorPatchColors.get(selectedBaseColor)?.map(shadeColor => (
-                            .get(selectedBaseColor)
+                            <ColorPatch
-                            ?.map(shadeColor => (
+                                key={shadeColor}
-                                <ColorPatch
+                                color={shadeColor}
-                                    key={shadeColor}
+                                isSelected={shadeColor === hexCodeWithHash}
-                                    color={shadeColor}
+                                handleSelectColorPatch={handleSelectColorPatch}
-                                    isSelected={shadeColor === hexCodeWithHash}
+                                defaultColor={defaultColor}
-                                    handleSelectColorPatch={handleSelectColorPatch}
+                            />
-                                    defaultColor={defaultColor}
+                        ))}
-                                />
-                            ))}
                     </div>
                 </>
             )}

src/views/components/calendar/CalendarCourseCellColorPicker/HexColorEditor.tsx

@@ -27,12 +27,10 @@ export default function HexColorEditor({ hexCode, setHexCode }: HexColorEditorPr
     const tagColor = pickFontColor(previewColor.slice(1) as `#${string}`);
 
     const [localHexCode, setLocalHexCode] = React.useState(hexCode);
-    const debouncedSetHexCode = useDebounce((value: string) => setHexCode(value), 500);
+    const debouncedSetHexCode = useDebounce(setHexCode, 500);
 
     React.useEffect(() => {
-        if (hexCode !== localHexCode) {
+        setLocalHexCode(hexCode);
-            setLocalHexCode(hexCode);
-        }
     }, [hexCode]);
 
     React.useEffect(() => {

src/views/components/calendar/CalendarFooter.tsx

@@ -58,13 +58,7 @@ export default function CalendarFooter(): JSX.Element {
                 ))}
             </div>
             <div>
-                <Button
+                <Button variant='minimal' size='small' icon={GearSix} color='ut-black' onClick={handleOpenOptions} />
-                    className='h-fit w-fit !p-0'
-                    variant='minimal'
-                    icon={GearSix}
-                    color='ut-black'
-                    onClick={handleOpenOptions}
-                />
             </div>
         </footer>
     );

src/views/components/calendar/CalendarHeader/CalendarHeader.tsx

@@ -1,5 +1,5 @@
 import { Menu, MenuButton, MenuItem, MenuItems } from '@headlessui/react';
-import { CalendarDots, Export, FilePng, Sidebar } from '@phosphor-icons/react';
+import { CalendarDots, Export, FileCode, FilePng, FileText, Sidebar } from '@phosphor-icons/react';
 import styles from '@views/components/calendar/CalendarHeader/CalendarHeader.module.scss';
 import { Button } from '@views/components/common/Button';
 import DialogProvider from '@views/components/common/DialogProvider/DialogProvider';
@@ -11,7 +11,7 @@ import useSchedules from '@views/hooks/useSchedules';
 import clsx from 'clsx';
 import React from 'react';
 
-import { saveAsCal, saveCalAsPng } from '../utils';
+import { handleExportJson, saveAsCal, saveAsText, saveCalAsPng } from '../utils';
 
 interface CalendarHeaderProps {
     sidebarOpen?: boolean;
@@ -28,14 +28,15 @@ export default function CalendarHeader({ sidebarOpen, onSidebarToggle }: Calenda
     return (
         <div
             style={{ scrollbarGutter: 'stable' }}
-            className='sticky left-0 right-0 top-0 z-10 min-h-[85px] flex items-center gap-5 overflow-x-scroll overflow-y-hidden bg-white pl-spacing-7 pt-spacing-5'
+            className='sticky left-0 right-0 top-0 z-10 min-h-[85px] flex items-center gap-5 overflow-x-auto overflow-y-hidden bg-white pl-spacing-7 pt-spacing-5'
         >
             {!sidebarOpen && (
                 <Button
                     variant='minimal'
+                    size='small'
                     color='theme-black'
                     onClick={onSidebarToggle}
-                    className='h-fit w-fit screenshot:hidden !p-0'
+                    className='screenshot:hidden'
                     icon={Sidebar}
                 />
             )}
@@ -98,6 +99,30 @@ export default function CalendarHeader({ sidebarOpen, onSidebarToggle }: Calenda
                                         Save as .cal
                                     </Button>
                                 </MenuItem>
+                                <MenuItem>
+                                    <Button
+                                        className='w-full flex justify-start'
+                                        onClick={() => handleExportJson(activeSchedule.id)}
+                                        color='ut-black'
+                                        size='small'
+                                        variant='minimal'
+                                        icon={FileCode}
+                                    >
+                                        Save as .json
+                                    </Button>
+                                </MenuItem>
+                                <MenuItem>
+                                    <Button
+                                        className='w-full flex justify-start'
+                                        onClick={saveAsText}
+                                        color='ut-black'
+                                        size='small'
+                                        variant='minimal'
+                                        icon={FileText}
+                                    >
+                                        Save as .txt
+                                    </Button>
+                                </MenuItem>
                                 {/* <MenuItem>
                                     <Button color='ut-black' size='small' variant='minimal' icon={FileTxt}>
                                         Export Unique IDs

src/views/components/calendar/CalendarSchedules.tsx

@@ -26,15 +26,16 @@ export function CalendarSchedules() {
     };
 
     return (
-        <div className='min-w-full w-0 flex flex-col items-center gap-y-spacing-3'>
+        <div className='min-w-full w-0 flex flex-col items-center gap-y-spacing-2'>
-            <div className='m0 w-full flex justify-between'>
+            <div className='m0 w-full flex items-center justify-between'>
                 <Text variant='h3' className='text-nowrap text-theme-black'>
                     MY SCHEDULES
                 </Text>
                 <Button
                     variant='minimal'
+                    size='small'
                     color='theme-black'
-                    className='h-fit w-fit !p-0 btn'
+                    className='!p-0 btn'
                     onClick={handleAddSchedule}
                     icon={Plus}
                 />