feat: port GDPR/Cookie components from Nexus to be used on Docs page

.github/workflows/pre-release.yml

@@ -8,14 +8,14 @@ on:
         - '!main'   # excludes main
 
 jobs:
-  release:
+  pre_release:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-            node-version: 20
+            node-version: 22
             cache: 'npm'
             # Path to the lock file needs to be specified explicitly as it is not in the root of the repository
             cache-dependency-path: 'documentation-ui/package-lock.json'

.github/workflows/release.yml

@@ -18,7 +18,7 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-            node-version: 20
+            node-version: 22
             cache: 'npm'
             # Path to the lock file needs to be specified explicitly as it is not in the root of the repository
             cache-dependency-path: 'documentation-ui/package-lock.json'
@@ -48,13 +48,15 @@ jobs:
           python-version: "3.12"
       - name: Generate UI Assets
         working-directory: sphinx-ui/react
+        env:
+          NEXT_PUBLIC_GA_ID: "G-YPQ1FTGDL3"
         run: |
           echo "🔨 Generating UI assets..."
           npm update @quantinuum/documentation-ui
           npm install
           npm run build
-          cp ./build/injectNav.global.js ../quantinuum_sphinx/static/injectNav.global.js
-          cp ./build/syncTheme.global.js ../quantinuum_sphinx/static/syncTheme.global.js
+          cp ./build/injectNav.iife.js ../quantinuum_sphinx/static/injectNav.iife.js
+          cp ./build/syncTheme.iife.js ../quantinuum_sphinx/static/syncTheme.iife.js
           cp ./node_modules/@quantinuum/quantinuum-ui/dist/tokens.css ../quantinuum_sphinx/static/styles/quantinuum-ui-tokens.css
           npx tailwindcss --postcss ./postcss.config.cjs -i ./index.css -o ../quantinuum_sphinx/static/styles/quantinuum-ui-tailwind.css
           echo ✅ "Done. Generated UI assets."

.pre-commit-config.yaml

@@ -1,6 +1,34 @@
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+
 repos:
+  - repo: builtin
+    hooks:
+      - id: trailing-whitespace
+        exclude: '^sphinx-ui/demo/'
+      - id: end-of-file-fixer
+        exclude: '^sphinx-ui/demo/'
+      - id: check-yaml
+      - id: check-json
+        exclude: 'tsconfig.*\.json$'
+
   - repo: local
     hooks:
+      - id: no-tabs
+        name: No tabs in source files
+        language: pygrep
+        entry: '\t'
+        types_or: [ts, tsx, javascript, jsx, python, css]
+        exclude: '(node_modules|sphinx-ui/demo/build)'
+
+      - id: documentation-ui-format
+        name: Biome format check (documentation-ui)
+        language: system
+        entry: bash -c 'cd documentation-ui && npx biome format src stories'
+        pass_filenames: false
+        files: '^documentation-ui/(src|stories)/.*\.(ts|tsx|js|jsx|css|json)$'
+
       - id: commitlint
         name: commitlint
         language: system

README.md

@@ -0,0 +1,54 @@
+# documentation-ui
+
+Monorepo containing the Quantinuum documentation UI component library
+(`documentation-ui/`) and the Sphinx theme (`sphinx-ui/`).
+
+## Pre-commit hooks
+
+This repository uses [prek](https://prek.j178.dev/) to enforce formatting and
+commit message conventions before each commit. prek is a fast, dependency-free
+alternative to `pre-commit`, written in Rust.
+
+### Prerequisites
+
+- **Node.js / npm** — required by the Biome format check and commitlint hooks.
+
+No Python or other runtime is needed to run prek itself.
+
+### Installation
+
+1. Install prek using the standalone installer:
+
+   ```sh
+   curl -LsSf https://prek.j178.dev/install.sh | sh
+   ```
+
+   Or via pip / pipx if you prefer a Python-managed install:
+
+   ```sh
+   pipx install prek
+   ```
+
+2. Install the git hooks into the repository:
+
+   ```sh
+   prek install
+   ```
+
+   Because the config sets `default_install_hook_types`, this single command
+   installs both the `pre-commit` and `commit-msg` shims automatically.
+
+### Running hooks manually
+
+To run all hooks against every file (useful after initial setup or to check
+the full codebase):
+
+```sh
+prek run --all-files
+```
+
+To run a single hook by id:
+
+```sh
+prek run no-tabs --all-files
+```

documentation-ui/biome.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.10/schema.json",
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": false
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "asNeeded",
+      "trailingCommas": "es5"
+    }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
+  "files": {
+    "includes": [
+      "**",
+      "!dist/**",
+      "!storybook-static/**",
+      "!coverage/**",
+      "!node_modules/**"
+    ]
+  }
+}

documentation-ui/eslint.config.js

@@ -0,0 +1,45 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  {
+    ignores: ["dist", "node_modules", "storybook-static", "coverage"],
+  },
+  {
+    files: ["**/*.{ts,tsx}"],
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: "module",
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      "react-hooks": reactHooks,
+      "react-refresh": reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+    },
+  },
+  {
+    files: ["**/*.{js,mjs,cjs}"],
+    extends: [js.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: "module",
+      globals: {
+        ...globals.node,
+      },
+    },
+  }
+);