@loveluthien/carta-frontend 6.0.0-dev

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots or videos**
+If applicable, add screenshots/videos to help explain your problem.
+
+**Platform info (please complete the following information):**
+ - OS [e.g. macOS Monterey]: 
+ - Browser [e.g. chrome, safari, electron app]: 
+ - Browser version [e.g. 22]: 
+ - Backend branch [e.g. dev, v3b2 release]:
+ - Frontend branch [e.g. dev, v3b2 release]:
+
+**Additional context**
+Add any other context about the problem here.

package/.github/pull_request_template.md

@@ -0,0 +1,23 @@
+**Description**
+
+linked issues and companion PRs (if there are), what is implemented or fixed, how to test it, …
+
+**Checklist**
+
+For linked issues (if there are):
+- [ ] assignee and label added
+- [ ] GitHub Project estimate added
+
+For the pull request:
+- [ ] reviewers and assignee added
+- [ ] GitHub Project estimate added
+- [ ] changelog updated / no changelog update needed
+- [ ] unit test added (for functions with no dependenies)
+- [ ] API documentation added (for public variables and methods in stores)
+
+For dependencies:
+- [ ] e2e test passing / corresponding fix added / new e2e test created
+- [ ] protobuf version bumped / no protobuf version bumped needed
+- [ ] protobuf updated to the latest dev commit / no protobuf update needed
+- [ ] corresponding ICD test fix added (`BackendService` changed) / no ICD test fix needed (`BackendService` unchanged)
+- [ ] user manual prepared (for large new features)

package/.github/workflows/continuous_integration.yml

@@ -0,0 +1,139 @@
+name: CI
+on: [push]
+jobs:
+
+  format-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+      - run: npm install
+      - run: npm run checkformat
+
+  doc-format-check:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./docs_website
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run checkformat
+
+  test-doc:
+    name: Test deployment of the documentation website
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./docs_website
+    needs: doc-format-check
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+      - name: Test build website
+        run: npm run build
+
+  node-v22:
+    runs-on: [self-hosted, Linux, X64, Docker]
+    needs: format-check
+    container:
+      image: carta/frontend-builder
+      options: --security-opt seccomp=unconfined
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Fix ownership
+        run: |
+          chown -R $(id -u):$(id -g) $PWD
+
+      - name: Build libs
+        shell: bash
+        run: |
+          source /emsdk/emsdk_env.sh
+          ./wasm_libs/build_libs.sh
+
+      - name: npm install with node 22
+        shell: bash
+        run: |
+          n 22
+          n exec 22 node -v
+          n exec 22 npm install
+
+      - name: Production build with node 22
+        shell: bash
+        run: |
+          source /emsdk/emsdk_env.sh
+          n exec 22 npm run build
+
+      - name: Run unit tests
+        shell: bash
+        run: n exec 22 npm test
+
+  node-v20:
+    runs-on: [self-hosted, Linux, X64, Docker]
+    needs: format-check
+    container:
+      image: carta/frontend-builder
+      options: --security-opt seccomp=unconfined
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Fix ownership
+        run: |
+          chown -R $(id -u):$(id -g) $PWD
+
+      - name: Build libs
+        shell: bash
+        run: |
+          source /emsdk/emsdk_env.sh
+          ./wasm_libs/build_libs.sh
+
+      - name: npm install with node 20
+        shell: bash
+        run: |
+          n 20
+          n exec 20 node -v
+          n exec 20 npm install
+
+      - name: Production build with node 20
+        shell: bash
+        run: |
+          source /emsdk/emsdk_env.sh
+          n exec 20 npm run build
+
+      - name: Run unit tests
+        shell: bash
+        run: n exec 20 npm test
+
+  Notify:
+    name: Send notifications
+    runs-on: ubuntu-latest
+    needs: [format-check, node-v20, node-v22]
+    if: always()
+    steps:
+      - name: Notify Slack
+        uses: baijunyao/action-slack-notify@v3.1.0
+        if: ${{ github.event_name == 'push' }}
+        with:
+          slack_channel_id: actions-build-status
+          slack_bot_token: ${{ secrets.SLACK_BOT_TOKEN }}
+          github_context: ${{ toJson(github) }}

package/.github/workflows/deploy.yml

@@ -0,0 +1,30 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - dev
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./docs_website
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm install
+      - name: Build website
+        run: npm run build
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs_website/build

package/.husky/pre-commit

@@ -0,0 +1,16 @@
+#!/usr/bin/env sh
+
+set -e
+
+docs_prettier="docs_website/node_modules/.bin/prettier"
+
+if git diff --cached --name-only --diff-filter=ACMR | grep -q '^docs_website/'; then
+    if [ ! -e "$docs_prettier" ]; then
+        echo "[pre-commit] docs_website changes detected but docs dependencies are missing."
+        echo "[pre-commit] Run: npm --prefix docs_website install"
+        exit 1
+    fi
+fi
+
+echo "[pre-commit] Running lint-staged..."
+npx lint-staged

package/.husky/pre-push

@@ -0,0 +1,42 @@
+#!/usr/bin/env sh
+
+set -e
+
+zero_hash="0000000000000000000000000000000000000000"
+docs_changed=0
+docs_prettier="docs_website/node_modules/.bin/prettier"
+
+echo "[pre-push] Running root checks..."
+npm run check-eslint
+npm run checkformat
+
+while read -r local_ref local_sha remote_ref remote_sha; do
+    [ -z "$local_sha" ] && continue
+    [ "$local_sha" = "$zero_hash" ] && continue
+
+    if [ "$remote_sha" = "$zero_hash" ]; then
+        commits="$(git rev-list "$local_sha" --not --remotes)"
+    else
+        commits="$(git rev-list "$remote_sha..$local_sha")"
+    fi
+
+    [ -z "$commits" ] && continue
+
+    if echo "$commits" | xargs git diff-tree --no-commit-id --name-only -r | grep -q '^docs_website/'; then
+        docs_changed=1
+        break
+    fi
+done
+
+if [ "$docs_changed" -eq 1 ]; then
+    if [ ! -e "$docs_prettier" ]; then
+        echo "[pre-push] docs_website changes detected but docs dependencies are missing."
+        echo "[pre-push] Run: npm --prefix docs_website install"
+        exit 1
+    fi
+
+    echo "[pre-push] docs_website changes detected. Running docs checkformat..."
+    npm --prefix docs_website run checkformat
+else
+    echo "[pre-push] No docs_website changes detected. Skipping docs checkformat."
+fi

package/.prettierignore

@@ -0,0 +1 @@
+src/static/gitInfo.ts

package/.prettierrc.json

@@ -0,0 +1,18 @@
+{
+    "arrowParens": "avoid",
+    "bracketSpacing": false,
+    "embeddedLanguageFormatting": "auto",
+    "htmlWhitespaceSensitivity": "css",
+    "insertPragma": false,
+    "bracketSameLine": false,
+    "jsxSingleQuote": false,
+    "proseWrap": "preserve",
+    "quoteProps": "as-needed",
+    "requirePragma": false,
+    "semi": true,
+    "singleQuote": false,
+    "trailingComma": "none",
+    "useTabs": false,
+    "printWidth": 240,
+    "tabWidth": 4
+}