refactor: migrate docs to docs-kit and replace concurrently with mprocs

.gitignore

@@ -22,3 +22,7 @@ junit-vitest.xml
 !.trunk/
 
 
+/docs/static/social-cards
+docs/static/og-default.png
+docs/static/twitter-default.png
+mprocs.log

.ncuskip

@@ -1,4 +0,0 @@
-
-# Eslint went thru a major version bump, so we need to skip it
-eslint
-@eslint/js

.trunk/trunk.yaml

@@ -7,7 +7,7 @@ cli:
 plugins:
     sources:
         - id: trunk
-          ref: v1.7.4
+          ref: v1.7.5
           uri: https://github.com/trunk-io/plugins
 # Many linters and tools depend on runtimes - configure them here. (https://docs.trunk.io/runtimes)
 runtimes:
@@ -17,18 +17,23 @@ runtimes:
         - python@3.10.8
 # This is the section where you manage your linters. (https://docs.trunk.io/check/configuration)
 lint:
+    ignore:
+        - linters: [ALL]
+          paths:
+              - '**/worker-configuration.d.ts'
+              - convex/_generated/**
     enabled:
         - shellcheck@0.11.0
         - shfmt@3.6.0
-        - actionlint@1.7.10
-        - checkov@3.2.501
-        - eslint@9.39.2
+        - actionlint@1.7.11
+        - checkov@3.2.506
+        - eslint@10.0.2
         - git-diff-check
-        - markdownlint@0.47.0
+        - markdownlint@0.48.0
         - osv-scanner@2.3.3
         - prettier@3.8.1
-        - svgo@4.0.0
-        - trufflehog@3.93.3
+        - svgo@4.0.1
+        - trufflehog@3.93.7
         - yamllint@1.38.0
 actions:
     disabled:

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2024-2025 Humanspeak, Inc.
+Copyright (c) 2024-2026 Humanspeak, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

docs/.ncuskip

@@ -1,4 +0,0 @@
-
-# Eslint went thru a major version bump, so we need to skip it
-eslint
-@eslint/js

docs/eslint.config.mjs

@@ -3,10 +3,12 @@ import js from '@eslint/js'
 import prettier from 'eslint-config-prettier'
 import svelte from 'eslint-plugin-svelte'
 import globals from 'globals'
+import { dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import ts from 'typescript-eslint'
 
 const gitignorePath = fileURLToPath(new URL('../.gitignore', import.meta.url))
+const tsconfigRootDir = dirname(fileURLToPath(import.meta.url))
 
 export default [
     includeIgnoreFile(gitignorePath),
@@ -32,6 +34,9 @@ export default [
             globals: {
                 ...globals.browser,
                 ...globals.node
+            },
+            parserOptions: {
+                tsconfigRootDir
             }
         },
         rules: {

docs/package.json

@@ -4,59 +4,63 @@
     "private": true,
     "type": "module",
     "scripts": {
-        "build": "vite build",
+        "build": "tsx ./scripts/fetch-github-stats.ts && node ./scripts/generate-sitemap-manifest.mjs && tsx ./scripts/generate-social-cards.ts && vite build",
         "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
         "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
         "deploy": "npm run build && wrangler pages deploy",
         "dev": "vite dev",
+        "generate-social": "tsx ./scripts/generate-social-cards.ts",
         "sitemap:manifest": "node ./scripts/generate-sitemap-manifest.mjs",
         "sitemap:watch": "chokidar 'src/routes/**/*.svelte' 'src/routes/**/*.svx' 'src/routes/**/*.md' --ignore 'src/routes/examples/+page.ts' -c 'node ./scripts/generate-sitemap-manifest.mjs' --initial --silent",
+        "social:watch": "chokidar 'src/lib/components/OG.svelte' 'scripts/generate-social-cards.ts' -c 'tsx ./scripts/generate-social-cards.ts' --initial --silent",
         "format": "prettier --write .",
         "lint": "prettier --check . && eslint .",
         "lint:fix": "npm run format && eslint . --fix",
         "preview": "vite preview"
     },
     "dependencies": {
+        "@humanspeak/docs-kit": "github:humanspeak/docs-kit#2026.3.11",
         "@humanspeak/memory-cache": "workspace:*",
         "github-slugger": "^2.0.0",
         "runed": "^0.37.1"
     },
     "devDependencies": {
-        "@cloudflare/workers-types": "^4.20260217.0",
+        "@cloudflare/workers-types": "^4.20260301.1",
         "@eslint/compat": "^2.0.2",
-        "@eslint/js": "^9.39.2",
-        "@humanspeak/svelte-motion": "^0.1.21",
-        "@sveltejs/adapter-cloudflare": "^7.2.7",
-        "@sveltejs/kit": "^2.52.0",
+        "@eslint/js": "^10.0.1",
+        "@humanspeak/svelte-motion": "^0.1.31",
+        "@sveltejs/adapter-cloudflare": "^7.2.8",
+        "@sveltejs/kit": "^2.53.4",
         "@sveltejs/vite-plugin-svelte": "^6.2.4",
-        "@tailwindcss/postcss": "^4.1.18",
+        "@tailwindcss/postcss": "^4.2.1",
         "@tailwindcss/typography": "^0.5.19",
-        "@tailwindcss/vite": "^4.1.18",
-        "@typescript-eslint/eslint-plugin": "^8.56.0",
-        "@typescript-eslint/parser": "^8.56.0",
-        "autoprefixer": "^10.4.24",
+        "@tailwindcss/vite": "^4.2.1",
+        "@typescript-eslint/eslint-plugin": "^8.56.1",
+        "@typescript-eslint/parser": "^8.56.1",
+        "autoprefixer": "^10.4.27",
         "chokidar-cli": "^3.0.0",
-        "eslint": "^9.39.2",
+        "eslint": "^10.0.2",
         "eslint-config-prettier": "10.1.8",
         "eslint-plugin-svelte": "3.15.0",
-        "globals": "^17.3.0",
-        "lucide-svelte": "^0.574.0",
+        "globals": "^17.4.0",
+        "@lucide/svelte": "^0.577.0",
         "mdsvex": "^0.12.6",
         "mode-watcher": "^1.1.0",
         "prettier": "^3.8.1",
         "prettier-plugin-organize-imports": "^4.3.0",
         "prettier-plugin-sort-json": "^4.2.0",
-        "prettier-plugin-svelte": "^3.4.1",
+        "prettier-plugin-svelte": "^3.5.1",
         "prettier-plugin-tailwindcss": "^0.7.2",
-        "shiki": "^3.22.0",
-        "svelte": "^5.51.3",
-        "svelte-check": "^4.4.0",
-        "tailwind-merge": "^3.4.1",
-        "tailwindcss": "^4.1.18",
+        "shiki": "^4.0.1",
+        "svelte": "^5.53.7",
+        "svelte-check": "^4.4.4",
+        "tailwind-merge": "^3.5.0",
+        "tailwindcss": "^4.2.1",
+        "tsx": "^4.21.0",
         "typescript": "^5.9.3",
-        "typescript-eslint": "^8.56.0",
+        "typescript-eslint": "^8.56.1",
         "vite": "^7.3.1",
-        "wrangler": "^4.66.0"
+        "wrangler": "^4.70.0"
     },
     "volta": {
         "node": "24.13.0"

docs/scripts/fetch-github-stats.ts

@@ -0,0 +1,12 @@
+import { fetchGitHubStats } from '@humanspeak/docs-kit/scripts/fetch-github-stats'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { docsConfig } from '../src/lib/docs-config'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+await fetchGitHubStats({
+    repo: docsConfig.repo,
+    fallbackStars: docsConfig.fallbackStars,
+    outputPath: path.resolve(__dirname, '..', 'src', 'lib', 'github-stats.json')
+})

docs/scripts/generate-social-cards.ts

@@ -0,0 +1,16 @@
+import { generateSocialCards } from '@humanspeak/docs-kit/scripts/generate-social-cards'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { docsConfig } from '../src/lib/docs-config'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const ROOT = path.resolve(__dirname, '..')
+
+await generateSocialCards({
+    npmPackage: docsConfig.npmPackage,
+    defaultTitle: docsConfig.name,
+    defaultDescription: docsConfig.description,
+    defaultFeatures: docsConfig.defaultFeatures,
+    rootDir: ROOT,
+    fontsDir: path.join(ROOT, 'node_modules/@humanspeak/docs-kit/dist/fonts')
+})