Migrate docs to Nextra v4 (#449)

Author: sdserranog

.gitignore

@@ -5,3 +5,4 @@ node_modules
 .env.local
 public/sitemap*.xml
 .env
+_pagefind/

.husky/pre-commit

@@ -1 +1,70 @@
-npx lint-staged
+pnpm dlx lint-staged
+
+#!/bin/sh
+# Exit on any error
+set -e
+
+# Check if there are any staged files
+if [ -z "$(git diff --cached --name-only)" ]; then
+  echo "No staged files to format"
+  exit 0
+fi
+
+# Store the hash of staged changes to detect modifications
+STAGED_HASH=$(git diff --cached | sha256sum | cut -d' ' -f1)
+
+# Save list of staged files (handling all file states)
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
+PARTIALLY_STAGED=$(git diff --name-only)
+
+# Stash unstaged changes to preserve working directory
+# --keep-index keeps staged changes in working tree
+git stash push --quiet --keep-index --message "pre-commit-stash" || true
+STASHED=$?
+
+# Run formatter on the staged files
+pnpm dlx ultracite fix
+FORMAT_EXIT_CODE=$?
+
+# Restore working directory state
+if [ $STASHED -eq 0 ]; then
+  # Re-stage the formatted files
+  if [ -n "$STAGED_FILES" ]; then
+    echo "$STAGED_FILES" | while IFS= read -r file; do
+      if [ -f "$file" ]; then
+        git add "$file"
+      fi
+    done
+  fi
+  
+  # Restore unstaged changes
+  git stash pop --quiet || true
+  
+  # Restore partial staging if files were partially staged
+  if [ -n "$PARTIALLY_STAGED" ]; then
+    for file in $PARTIALLY_STAGED; do
+      if [ -f "$file" ] && echo "$STAGED_FILES" | grep -q "^$file$"; then
+        # File was partially staged - need to unstage the unstaged parts
+        git restore --staged "$file" 2>/dev/null || true
+        git add -p "$file" < /dev/null 2>/dev/null || git add "$file"
+      fi
+    done
+  fi
+else
+  # No stash was created, just re-add the formatted files
+  if [ -n "$STAGED_FILES" ]; then
+    echo "$STAGED_FILES" | while IFS= read -r file; do
+      if [ -f "$file" ]; then
+        git add "$file"
+      fi
+    done
+  fi
+fi
+
+# Check if staged files actually changed
+NEW_STAGED_HASH=$(git diff --cached | sha256sum | cut -d' ' -f1)
+if [ "$STAGED_HASH" != "$NEW_STAGED_HASH" ]; then
+  echo "✨ Files formatted by Ultracite"
+fi
+
+exit $FORMAT_EXIT_CODE

.huskyrc

@@ -0,0 +1,10 @@
+{
+  "es": {
+    "_meta.ts": "bfff435958824a340b2f6f78af9edaa62bab68b2e0db4c7980c37fb29a170a1f",
+    "page.mdx": "9489dd67ec525393d4cb3864edb26db843f20c57544b812b8b98637706cea666"
+  },
+  "pt-BR": {
+    "_meta.ts": "bfff435958824a340b2f6f78af9edaa62bab68b2e0db4c7980c37fb29a170a1f",
+    "page.mdx": "9489dd67ec525393d4cb3864edb26db843f20c57544b812b8b98637706cea666"
+  }
+}

.i18n-cache/hashes.json

@@ -1,10 +1,46 @@
 {
-  "cSpell.words": ["httpx", "nextra", "posthog", "toolkits"],
+  "cSpell.words": [
+    "httpx",
+    "nextra",
+    "posthog",
+    "toolkits"
+  ],
   "editor.wordWrap": "bounded",
   "editor.wordWrapColumn": 120,
-  "editor.formatOnSave": false,
+  "editor.formatOnSave": true,
   "[javascript][typescript][json][jsonc][tsx][jsx][css]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode",
     "editor.formatOnSave": true
+  },
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[graphql]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "editor.formatOnPaste": true,
+  "emmet.showExpandedAbbreviation": "never",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
   }
-}
+}

.lintstagedrc

@@ -0,0 +1,14 @@
+export default {
+  dark: "Dark",
+  light: "Light",
+  system: "System",
+  toc: {
+    title: "On this page",
+    backToTop: "Scroll to top",
+  },
+  lastUpdated: "Last updated on",
+  notFound: "This page could not be found",
+  poweredBy: "Powered by",
+  editPage: "Edit this page on GitHub →",
+  by: "by",
+};