site: update agda docs

Author: will-break-it

site/agda-docs.config.json

@@ -0,0 +1,7 @@
+{
+  "backButtonUrl": "/formal-spec/",
+  "inputDir": "./static/formal-spec",
+  "modules": ["Leios", "Cardano", "Ouroboros", "Ledger", "Ledger-Spec"],
+  "githubUrl": "https://github.com/input-output-hk/ouroboros-leios-formal-spec",
+  "searchGranularity": "comprehensive"
+} 

site/package.json

@@ -12,7 +12,8 @@
     "serve": "docusaurus serve",
     "write-translations": "docusaurus write-translations",
     "write-heading-ids": "docusaurus write-heading-ids",
-    "typecheck": "tsc"
+    "typecheck": "tsc",
+    "build-agda-docs": "bash scripts/build-and-process-agda-docs.sh"
   },
   "dependencies": {
     "@docusaurus/core": "3.4.0",
@@ -22,7 +23,8 @@
     "prism-react-renderer": "^2.3.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
-    "undici": "^7.2.3"
+    "undici": "^7.2.3",
+    "agda-web-docs-lib": "^0.3.1"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.4.0",

site/scripts/build-agda-docs.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+# Exit on error
+set -e
+
+# Get the absolute paths
+SITE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+FORMAL_SPEC_DIR="$SITE_DIR/static/formal-spec"
+FORMAL_SPEC_ROOT="$(cd "$SITE_DIR/../../ouroboros-leios-formal-spec" && pwd)"
+
+echo "Building Agda documentation..."
+
+# Build Agda documentation
+(cd "$FORMAL_SPEC_ROOT" && nix build .#leiosDocs)
+
+# Create formal-spec directory if it doesn't exist and set permissions
+mkdir -p "$FORMAL_SPEC_DIR"
+chmod 755 "$FORMAL_SPEC_DIR"
+
+# Remove existing files if any
+rm -rf "$FORMAL_SPEC_DIR"/*
+
+# Copy files with proper permissions (macOS compatible)
+cp -R "$FORMAL_SPEC_ROOT/result/html/"* "$FORMAL_SPEC_DIR/"
+chmod -R 755 "$FORMAL_SPEC_DIR"
+
+echo "Processing HTML files..."
+
+# Check if config file exists
+CONFIG_PATH="$SITE_DIR/agda-docs.config.json"
+if [ ! -f "$CONFIG_PATH" ]; then
+    echo "Error: agda-docs.config.json not found"
+    exit 1
+fi
+
+# Process HTML files using the agda-web-docs-lib
+cd "$SITE_DIR" && NODE_OPTIONS="--max-old-space-size=16384" npx agda-web-docs-lib process "$FORMAL_SPEC_DIR" "$CONFIG_PATH"