camelmind 0.1.0

package/template/lib/config.ts

@@ -0,0 +1,29 @@
+import siteConfig from "@/camelmind.config"
+import type { AuthConfig, CamelMindConfig } from "./config-types"
+
+export type { AuthConfig, AuthProvider, CamelMindConfig, OidcConfig } from "./config-types"
+
+let _config: CamelMindConfig | null = null
+
+export function getConfig(): CamelMindConfig {
+  if (!_config) _config = siteConfig
+  return _config
+}
+
+export function isAuthEnabled(): boolean {
+  if (process.env.OFFLINE_MODE === "true") return false
+  return getConfig().auth.enabled
+}
+
+export function isPrivateSite(): boolean {
+  return isAuthEnabled() && getConfig().auth.requireLogin
+}
+
+export function getAuthConfig(): AuthConfig {
+  return getConfig().auth
+}
+
+export function isPublicPath(pathname: string): boolean {
+  const { publicPaths } = getAuthConfig()
+  return publicPaths.some((p) => pathname === p || pathname.startsWith(p + "/"))
+}

package/template/lib/mdx.ts

@@ -0,0 +1,53 @@
+import fs from "fs"
+import path from "path"
+import matter from "gray-matter"
+
+export type FrontMatter = {
+  title: string
+  description?: string
+  roles?: string[]
+  tags?: string[]
+  download_pdf?: string
+}
+
+export type TocEntry = {
+  id: string
+  text: string
+  level: number
+}
+
+export type DocContent = {
+  frontmatter: FrontMatter
+  source: string
+  toc: TocEntry[]
+}
+
+function extractToc(source: string): TocEntry[] {
+  const headingRegex = /^(#{2,3})\s+(.+)$/gm
+  const entries: TocEntry[] = []
+  let match
+
+  while ((match = headingRegex.exec(source)) !== null) {
+    const level = match[1].length
+    const text = match[2].trim()
+    const id = text
+      .toLowerCase()
+      .replace(/[^\w\s-]/g, "")
+      .replace(/\s+/g, "-")
+    entries.push({ id, text, level })
+  }
+
+  return entries
+}
+
+export function loadMdxFile(filePath: string): DocContent {
+  const fullPath = path.join(process.cwd(), filePath)
+  const raw = fs.readFileSync(fullPath, "utf-8")
+  const { data, content } = matter(raw)
+
+  return {
+    frontmatter: data as FrontMatter,
+    source: content,
+    toc: extractToc(content),
+  }
+}

package/template/lib/nav-types.ts

@@ -0,0 +1,31 @@
+export type NavChild = {
+  label: string
+  slug: string
+  file: string
+  roles: string[]
+  children?: NavChild[]
+}
+
+export type NavEntry = {
+  label: string
+  slug: string
+  file: string
+  roles: string[]
+  section?: NavChild[]
+}
+
+export type NavGroup = {
+  label: string
+  dropdown: boolean
+  noDropdown?: boolean  // show as direct link in top nav, not a dropdown button
+  slug?: string         // href for the direct link when noDropdown is true
+  items: NavEntry[]
+}
+
+export type NavConfig = {
+  nav: (NavEntry | NavGroup)[]
+}
+
+export function isNavGroup(item: NavEntry | NavGroup): item is NavGroup {
+  return "dropdown" in item
+}

package/template/lib/nav.ts

@@ -0,0 +1,125 @@
+import fs from "fs"
+import path from "path"
+import yaml from "js-yaml"
+import type { NavConfig, NavEntry, NavGroup, NavChild } from "./nav-types"
+
+export type { NavConfig, NavEntry, NavGroup, NavChild }
+export { isNavGroup } from "./nav-types"
+
+let _navCache: NavConfig | null = null
+
+export function loadNav(): NavConfig {
+  if (process.env.NODE_ENV !== "development" && _navCache) return _navCache
+  const navPath = path.join(process.cwd(), "nav", "nav.yml")
+  const raw = fs.readFileSync(navPath, "utf-8")
+  _navCache = yaml.load(raw) as NavConfig
+  return _navCache
+}
+
+export function flattenChildren(children: NavChild[]): NavChild[] {
+  return children.flatMap((c) => [c, ...(c.children ? flattenChildren(c.children) : [])])
+}
+
+// Extract all slugs from any NavConfig (default or versioned)
+export function getSlugsFromConfig(nav: NavConfig): string[] {
+  const slugs: string[] = []
+  for (const item of nav.nav) {
+    if ("dropdown" in item) {
+      const group = item as NavGroup
+      // noDropdown groups have a top-level slug (the direct link target)
+      if (group.noDropdown && group.slug) slugs.push(group.slug)
+      for (const entry of (group.items ?? [])) {
+        slugs.push(entry.slug)
+        if (entry.section) {
+          for (const child of flattenChildren(entry.section)) {
+            slugs.push(child.slug)
+          }
+        }
+      }
+    } else if ("slug" in item) {
+      slugs.push((item as NavEntry).slug)
+    }
+  }
+  return slugs
+}
+
+export function getAllSlugs(): string[] {
+  return getSlugsFromConfig(loadNav())
+}
+
+// Search any NavConfig for a slug — used for both default and versioned navs
+export function getEntryBySlugFromConfig(nav: NavConfig, slug: string): (NavEntry | NavChild) | null {
+  const normalized = slug.startsWith("/") ? slug : `/${slug}`
+
+  for (const item of nav.nav) {
+    if ("dropdown" in item) {
+      const group = item as NavGroup
+      // noDropdown group: its top-level slug maps to the first item in the group
+      if (group.noDropdown && group.slug === normalized && group.items?.length) {
+        return group.items[0]
+      }
+      for (const entry of (group.items ?? [])) {
+        if (entry.slug === normalized) return entry
+        if (entry.section) {
+          const match = flattenChildren(entry.section).find((c) => c.slug === normalized)
+          if (match) return match
+        }
+      }
+    } else if ("slug" in item) {
+      const entry = item as NavEntry
+      if (entry.slug === normalized) return entry
+    }
+  }
+
+  return null
+}
+
+export function getNavEntryBySlug(slug: string): (NavEntry | NavChild) | null {
+  return getEntryBySlugFromConfig(loadNav(), slug)
+}
+
+// Return the NavGroup that contains the given slug in any NavConfig
+export function getGroupForSlugFromConfig(nav: NavConfig, slug: string): NavGroup | null {
+  const normalized = slug.startsWith("/") ? slug : `/${slug}`
+
+  for (const item of nav.nav) {
+    if (!("dropdown" in item)) continue
+    const group = item as NavGroup
+    if (group.noDropdown && group.slug === normalized) return group
+    for (const entry of (group.items ?? [])) {
+      if (entry.slug === normalized) return group
+      if (entry.section) {
+        const match = flattenChildren(entry.section).find((c) => c.slug === normalized)
+        if (match) return group
+      }
+    }
+  }
+
+  return null
+}
+
+export function getGroupForSlug(slug: string): NavGroup | null {
+  return getGroupForSlugFromConfig(loadNav(), slug)
+}
+
+// Return the section-root NavEntry for a slug in any NavConfig
+export function getSectionForSlugFromConfig(nav: NavConfig, slug: string): NavEntry | null {
+  const normalized = slug.startsWith("/") ? slug : `/${slug}`
+
+  for (const item of nav.nav) {
+    if (!("dropdown" in item)) continue
+    for (const entry of ((item as NavGroup).items ?? [])) {
+      if (entry.slug === normalized) return entry
+      if (entry.section) {
+        const match = flattenChildren(entry.section).find((c) => c.slug === normalized)
+        if (match) return entry
+      }
+    }
+  }
+
+  return null
+}
+
+export function getSectionForSlug(slug: string): NavEntry | null {
+  return getSectionForSlugFromConfig(loadNav(), slug)
+}

package/template/lib/versions.ts

@@ -0,0 +1,61 @@
+import fs from "fs"
+import path from "path"
+import yaml from "js-yaml"
+import { loadNav } from "./nav"
+import type { NavConfig } from "./nav-types"
+
+export type Version = {
+  id: string
+  label: string
+  stable: boolean
+  badge?: string
+  nav: string
+}
+
+export type VersionsConfig = {
+  versions: Version[]
+}
+
+let _versionsCache: VersionsConfig | null = null
+
+export function loadVersions(): VersionsConfig {
+  if (_versionsCache) return _versionsCache
+  const raw = fs.readFileSync(path.join(process.cwd(), "versions.yml"), "utf-8")
+  _versionsCache = yaml.load(raw) as VersionsConfig
+  return _versionsCache
+}
+
+export function getVersionFromSlug(slug: string): string | null {
+  const { versions } = loadVersions()
+  for (const v of versions) {
+    if (slug.startsWith(`/${v.id}/`) || slug === `/${v.id}`) return v.id
+  }
+  // no version prefix = default (latest)
+  return null
+}
+
+export function getNavForVersion(versionId: string | null): NavConfig {
+  if (!versionId) return loadNav()
+  const { versions } = loadVersions()
+  const v = versions.find((v) => v.id === versionId)
+  if (!v) return loadNav()
+
+  const raw = fs.readFileSync(path.join(process.cwd(), v.nav), "utf-8")
+  return yaml.load(raw) as NavConfig
+}
+
+export function getLatestVersion(): Version {
+  const { versions } = loadVersions()
+  return versions[0]
+}
+
+// Given a slug like /v1.9/getting-started/overview, return /getting-started/overview
+export function stripVersionPrefix(slug: string, versionId: string): string {
+  return slug.replace(new RegExp(`^/${versionId}`), "") || "/"
+}
+
+// Given /getting-started/overview and a target version, return /v1.9/getting-started/overview
+export function swapVersion(slug: string, currentVersionId: string | null, targetVersionId: string): string {
+  const bare = currentVersionId ? stripVersionPrefix(slug, currentVersionId) : slug
+  return `/${targetVersionId}${bare}`
+}

package/template/nav/nav.yml

@@ -0,0 +1,20 @@
+nav:
+  - label: "Getting Started"
+    dropdown: true
+    items:
+      - label: "Overview"
+        slug: /getting-started/overview
+        file: content/getting-started/overview.mdx
+        roles: []
+      - label: "Installation"
+        slug: /getting-started/installation
+        file: content/getting-started/installation.mdx
+        roles: []
+
+  - label: "Guides"
+    dropdown: true
+    items:
+      - label: "Writing Docs"
+        slug: /guides/writing-docs
+        file: content/guides/writing-docs.mdx
+        roles: []

package/template/next.config.ts

@@ -0,0 +1,35 @@
+import type { NextConfig } from "next";
+
+const isOffline = process.env.OFFLINE_MODE === "true"
+
+const securityHeaders = [
+  { key: "X-Frame-Options", value: "DENY" },
+  { key: "X-Content-Type-Options", value: "nosniff" },
+  { key: "Referrer-Policy", value: "strict-origin-when-cross-origin" },
+  { key: "Permissions-Policy", value: "camera=(), microphone=(), geolocation=()" },
+  {
+    key: "Content-Security-Policy",
+    value: [
+      "default-src 'self'",
+      "script-src 'self' 'unsafe-inline'",
+      "style-src 'self' 'unsafe-inline'",
+      "img-src 'self' data:",
+      "font-src 'self'",
+      "connect-src 'self'",
+      "frame-ancestors 'none'",
+    ].join("; "),
+  },
+]
+
+const nextConfig: NextConfig = {
+  // Static export for offline builds — no server required
+  ...(isOffline ? { output: "export", trailingSlash: true } : {}),
+  // Security headers are only meaningful when running as a server (not static export)
+  ...(!isOffline ? {
+    async headers() {
+      return [{ source: "/(.*)", headers: securityHeaders }]
+    },
+  } : {}),
+};
+
+export default nextConfig;

package/template/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template/proxy.ts

@@ -0,0 +1,50 @@
+import { NextRequest, NextResponse } from "next/server"
+import { jwtVerify } from "jose"
+import { COOKIE_NAME, getSecret } from "@/lib/auth"
+import { isAuthEnabled, isPrivateSite, isPublicPath } from "@/lib/config"
+
+export async function proxy(req: NextRequest) {
+  const { pathname } = req.nextUrl
+
+  // Auth disabled — all traffic passes through
+  if (!isAuthEnabled()) {
+    return NextResponse.next()
+  }
+
+  // Always allow public paths and Next.js internals
+  if (
+    isPublicPath(pathname) ||
+    pathname.startsWith("/_next") ||
+    pathname.startsWith("/favicon")
+  ) {
+    return NextResponse.next()
+  }
+
+  // RBAC-only mode: per-page enforcement happens in page.tsx
+  if (!isPrivateSite()) {
+    return NextResponse.next()
+  }
+
+  // Private site mode: require valid session for all non-public paths
+  const token = req.cookies.get(COOKIE_NAME)?.value
+  if (!token) {
+    const loginUrl = new URL("/login", req.url)
+    loginUrl.searchParams.set("returnTo", pathname)
+    return NextResponse.redirect(loginUrl)
+  }
+
+  try {
+    await jwtVerify(token, getSecret())
+    return NextResponse.next()
+  } catch {
+    const loginUrl = new URL("/login", req.url)
+    loginUrl.searchParams.set("returnTo", pathname)
+    const res = NextResponse.redirect(loginUrl)
+    res.cookies.set(COOKIE_NAME, "", { maxAge: 0, path: "/" })
+    return res
+  }
+}
+
+export const config = {
+  matcher: ["/((?!_next/static|_next/image|favicon.ico|public/).*)"],
+}

package/template/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/template/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/template/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/template/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/template/scripts/build-offline.sh

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+# Build a self-contained offline ZIP for one version of the help center.
+#
+# Usage:
+#   ./scripts/build-offline.sh v2.0
+#   ./scripts/build-offline.sh v1.9
+#
+# Output: offline-builds/gw-helpcenter-<version>-offline.zip
+# Users unzip and run: npx serve out/   (or open index.html directly)
+
+set -euo pipefail
+
+VERSION=${1:-v2.0}
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+OUT_DIR="$ROOT/out"
+BUILDS_DIR="$ROOT/offline-builds"
+ZIP_NAME="camelmind-${VERSION}-offline.zip"
+
+# API routes that require a live server — stash them outside app/ during static export
+SERVER_ROUTES=(
+  "app/api/raw/route.ts"
+  "app/api/download/route.ts"
+  "app/api/search/route.ts"
+  "app/api/auth"
+)
+
+stash_routes() {
+  mkdir -p "$ROOT/.offline-stash"
+  for r in "${SERVER_ROUTES[@]}"; do
+    if [ -e "$ROOT/$r" ]; then
+      # Flatten path for stash filename
+      stash_name="${r//\//__}"
+      mv "$ROOT/$r" "$ROOT/.offline-stash/$stash_name"
+    fi
+  done
+}
+
+restore_routes() {
+  for r in "${SERVER_ROUTES[@]}"; do
+    stash_name="${r//\//__}"
+    if [ -e "$ROOT/.offline-stash/$stash_name" ]; then
+      # Recreate parent dir if needed (e.g. app/api/raw/)
+      mkdir -p "$ROOT/$(dirname "$r")"
+      mv "$ROOT/.offline-stash/$stash_name" "$ROOT/$r"
+    fi
+  done
+  rmdir "$ROOT/.offline-stash" 2>/dev/null || true
+}
+
+# Always restore on exit (even on error)
+trap restore_routes EXIT
+
+echo "▶ Building offline package for version: $VERSION"
+
+# 1. Pre-build the search index (no API server in static export)
+echo "  → Generating search index..."
+cd "$ROOT"
+npx tsx scripts/build-search-index.ts
+
+# 2. Stash server-only routes so next build doesn't complain
+echo "  → Stashing server-only API routes..."
+stash_routes
+
+# 3. Static export
+echo "  → Running next build (OFFLINE_MODE=true, TARGET_VERSION=$VERSION)..."
+OFFLINE_MODE=true TARGET_VERSION="$VERSION" npx next build
+
+# 3. Write launcher scripts and README into the export
+
+cat > "$OUT_DIR/launch.sh" <<'LAUNCHER'
+#!/usr/bin/env bash
+# Game Warden Help Center — offline launcher (Mac / Linux)
+PORT=8765
+URL="http://localhost:$PORT/home/"
+
+# Try Python 3 first (available on most systems without internet)
+if command -v python3 &>/dev/null; then
+  echo "Starting local server on $URL"
+  python3 -m http.server $PORT &
+  SERVER_PID=$!
+  sleep 1
+  # Open browser
+  if command -v open &>/dev/null; then open "$URL"
+  elif command -v xdg-open &>/dev/null; then xdg-open "$URL"
+  fi
+  echo "Press Ctrl+C to stop the server."
+  wait $SERVER_PID
+# Fall back to Python 2
+elif command -v python &>/dev/null; then
+  echo "Starting local server on $URL"
+  python -m SimpleHTTPServer $PORT &
+  SERVER_PID=$!
+  sleep 1
+  if command -v open &>/dev/null; then open "$URL"
+  elif command -v xdg-open &>/dev/null; then xdg-open "$URL"
+  fi
+  echo "Press Ctrl+C to stop the server."
+  wait $SERVER_PID
+# Fall back to Node / npx
+elif command -v npx &>/dev/null; then
+  echo "Starting local server on $URL"
+  if command -v open &>/dev/null; then sleep 2 && open "$URL" &
+  elif command -v xdg-open &>/dev/null; then sleep 2 && xdg-open "$URL" &
+  fi
+  npx serve . -p $PORT
+else
+  echo "ERROR: Python 3, Python 2, or Node.js is required to run this package."
+  echo "Install Python from https://www.python.org or Node.js from https://nodejs.org"
+  exit 1
+fi
+LAUNCHER
+chmod +x "$OUT_DIR/launch.sh"
+
+cat > "$OUT_DIR/launch.bat" <<'LAUNCHER'
+@echo off
+REM Game Warden Help Center — offline launcher (Windows)
+set PORT=8765
+set URL=http://localhost:%PORT%/home/
+
+REM Try Python 3
+python --version >nul 2>&1
+if %errorlevel% == 0 (
+    echo Starting local server on %URL%
+    start "" "%URL%"
+    python -m http.server %PORT%
+    goto :end
+)
+
+REM Try Python via py launcher
+py --version >nul 2>&1
+if %errorlevel% == 0 (
+    echo Starting local server on %URL%
+    start "" "%URL%"
+    py -m http.server %PORT%
+    goto :end
+)
+
+REM Try npx (Node.js)
+npx --version >nul 2>&1
+if %errorlevel% == 0 (
+    echo Starting local server on %URL%
+    start "" "%URL%"
+    npx serve . -p %PORT%
+    goto :end
+)
+
+echo ERROR: Python or Node.js is required to run this package.
+echo Install Python from https://www.python.org or Node.js from https://nodejs.org
+pause
+:end
+LAUNCHER
+
+cat > "$OUT_DIR/README.txt" <<EOF
+Game Warden Help Center — Offline Package ($VERSION)
+====================================================
+
+QUICK START
+-----------
+Mac / Linux:  Double-click launch.sh  (or run: ./launch.sh in Terminal)
+Windows:      Double-click launch.bat
+
+This opens a local web server at http://localhost:8765 and launches your
+browser automatically. Press Ctrl+C (or close Terminal) to stop.
+
+REQUIREMENTS
+------------
+Python 3 is recommended (pre-installed on most Macs and Linux systems).
+Windows users may need to install Python from https://www.python.org
+Node.js (https://nodejs.org) works as a fallback on all platforms.
+
+SEARCH
+------
+Full-text search works offline — no internet connection required.
+
+NOTES
+-----
+- Do not open index.html directly in your browser; navigation will break.
+  Always use the launcher or start a local server first.
+- This package was generated for authenticated Game Warden users.
+  Do not redistribute without authorization.
+EOF
+
+# 4. Zip the output
+echo "  → Packaging..."
+mkdir -p "$BUILDS_DIR"
+cd "$OUT_DIR"
+zip -r "$BUILDS_DIR/$ZIP_NAME" . --quiet
+
+echo "✓ Done: offline-builds/$ZIP_NAME ($(du -sh "$BUILDS_DIR/$ZIP_NAME" | cut -f1))"

package/template/scripts/build-pdf.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Build the master PDF for one version of the Help Center.
+#
+# Usage:
+#   ./scripts/build-pdf.sh v2.0
+#
+# Requires: the Next.js dev server running on port 3000 (npm run dev)
+# Output: offline-builds/Game-Warden-Help-Center-<version>.pdf
+
+set -euo pipefail
+
+VERSION=${1:-v2.0}
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PAGES_DIR="$ROOT/.pdf-pages"
+PORT=3000
+
+cleanup() {
+  rm -rf "$PAGES_DIR"
+}
+trap cleanup EXIT
+
+echo "▶ Building master PDF for version: $VERSION"
+
+# Verify dev server is running
+if ! curl -s -o /dev/null "http://localhost:$PORT/home"; then
+  echo "✗ Dev server not running on port $PORT"
+  echo "  Start it with: npm run dev"
+  exit 1
+fi
+
+# Generate per-page PDFs against the live dev server
+echo "  → Rendering pages via Playwright (port $PORT)..."
+cd "$ROOT"
+npx tsx scripts/generate-pdfs.ts --port="$PORT" --out="$PAGES_DIR"
+
+# Assemble master PDF
+echo "  → Assembling master PDF..."
+npx tsx scripts/generate-master-pdf.ts --version="$VERSION" --pages="$PAGES_DIR" --out="$ROOT/offline-builds"
+
+SIZE=$(du -sh "$ROOT/offline-builds/Game-Warden-Help-Center-${VERSION}.pdf" | cut -f1)
+echo "✓ Done: offline-builds/Game-Warden-Help-Center-${VERSION}.pdf ($SIZE)"