Initial commit

.github/renovate.json

@@ -0,0 +1,3 @@
+{
+    "extends": ["config:recommended", "schedule:weekly", ":prConcurrentLimitNone", ":prHourlyLimitNone"]
+}

.github/workflows/book.yml

@@ -0,0 +1,103 @@
+name: Book
+on:
+    push:
+        branches:
+            - main
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: false
+
+jobs:
+    test:
+        name: Test
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Set up Rust toolchain
+              run: |
+                  rustup toolchain install stable --no-self-update --profile minimal
+                  rustup target add wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Install latest mdbook
+              run: |
+                  tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+                  url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+                  mkdir bin
+                  curl -sSL $url | tar -xz --directory=bin
+                  echo "$(pwd)/bin" >> $GITHUB_PATH
+
+            - name: Install mdBook plugins
+              run: cargo install mdbook-trunk
+
+            - name: Run tests
+              run: mdbook test
+              working-directory: book
+
+    deploy:
+        needs: test
+        name: Deploy
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            pages: write
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            - name: Set up Rust toolchain
+              run: |
+                  rustup toolchain install stable --no-self-update --profile minimal
+                  rustup target add wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Install Trunk
+              run: cargo install trunk
+
+            - name: Install latest mdbook
+              run: |
+                  tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+                  url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+                  mkdir mdbook
+                  curl -sSL $url | tar -xz --directory=./mdbook
+                  echo `pwd`/mdbook >> $GITHUB_PATH
+
+            - name: Install mdBook plugins
+              run: cargo install mdbook-tabs mdbook-trunk
+
+            - name: Install Node.js dependencies
+              run: npm install
+
+            - name: Build Book
+              run: mdbook build
+              working-directory: book
+
+            - name: Combine Book Outputs
+              run: mdbook-trunk combine
+              working-directory: book
+
+            - name: Setup Pages
+              uses: actions/configure-pages@v4
+
+            - name: Upload artifact
+              uses: actions/upload-pages-artifact@v3
+              with:
+                  path: 'book/dist'
+
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+    pull_request: {}
+    push:
+        branches:
+            - main
+
+env:
+    RUSTFLAGS: '-Dwarnings'
+
+jobs:
+    test:
+        name: Test
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Set up Rust toolchain
+              run: rustup toolchain install stable --no-self-update --profile default --target wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Check formatting
+              run: cargo fmt --all --check
+
+            - name: Lint
+              run: cargo clippy --all-features
+
+            - name: Test
+              run: cargo test --all-features

.gitignore

@@ -0,0 +1,166 @@
+# Created by https://www.toptal.com/developers/gitignore/api/rust,node
+# Edit at https://www.toptal.com/developers/gitignore?templates=rust,node
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+### Rust ###
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+# Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# End of https://www.toptal.com/developers/gitignore/api/rust,node
+
+# mdBook
+book/book/
+
+# Tailwind CSS ouput
+tailwind.output.css

.pre-commit-config.yaml

@@ -0,0 +1,13 @@
+repos:
+    - repo: https://github.com/pre-commit/mirrors-prettier
+      rev: v3.1.0
+      hooks:
+          - id: prettier
+            additional_dependencies:
+                - prettier@^3.2.5
+                - prettier-plugin-tailwindcss@^0.5.12
+    - repo: https://github.com/doublify/pre-commit-rust
+      rev: v1.0
+      hooks:
+          - id: fmt
+          - id: clippy

.prettierignore

@@ -0,0 +1,2 @@
+.vite/
+target/

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+    "bracketSpacing": false,
+    "printWidth": 120,
+    "singleQuote": true,
+    "tabWidth": 4,
+    "trailingComma": "none"
+}