feat: math v0.1.5 - set improvements and documentation

- Add clear method to Set type
- Add documentation site structure
- Update Go module version

docs/.gitignore

@@ -0,0 +1,34 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Next.js
+.next/
+out/
+.turbo/
+
+# Build
+dist/
+build/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Fumadocs
+.source/
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts

docs/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,42 @@
+import { source } from "@/lib/source"
+import type { Metadata } from "next"
+import { DocsPage, DocsBody, DocsTitle, DocsDescription } from "fumadocs-ui/page"
+import { notFound } from "next/navigation"
+import defaultMdxComponents from "fumadocs-ui/mdx"
+
+export default async function Page(props: {
+  params: Promise<{ slug?: string[] }>
+}) {
+  const params = await props.params
+  const page = source.getPage(params.slug)
+  if (!page) notFound()
+
+  const MDX = page.data.body
+
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX components={{ ...defaultMdxComponents }} />
+      </DocsBody>
+    </DocsPage>
+  )
+}
+
+export async function generateStaticParams() {
+  return source.generateParams()
+}
+
+export async function generateMetadata(props: {
+  params: Promise<{ slug?: string[] }>
+}): Promise<Metadata> {
+  const params = await props.params
+  const page = source.getPage(params.slug)
+  if (!page) notFound()
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  }
+}

docs/app/docs/layout.tsx

@@ -0,0 +1,11 @@
+import { source } from "@/lib/source"
+import type { ReactNode } from "react"
+import { DocsLayout } from "fumadocs-ui/layouts/docs"
+
+export default async function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout tree={source.pageTree} sidebar={{ defaultOpenLevel: 0 }}>
+      {children}
+    </DocsLayout>
+  )
+}

docs/app/global.css

@@ -0,0 +1,79 @@
+@import "tailwindcss";
+@import "fumadocs-ui/style.css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --breakpoint-3xl: 1600px;
+  --breakpoint-4xl: 2000px;
+  --font-sans: var(--font-geist-sans), system-ui, sans-serif;
+  --font-mono: var(--font-geist-mono), monospace;
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+}
+
+:root {
+  --background: 0 0% 100%;
+  --foreground: 0 0% 3.9%;
+  --card: 0 0% 100%;
+  --card-foreground: 0 0% 3.9%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 0 0% 3.9%;
+  --primary: 0 0% 9%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 0 0% 96.1%;
+  --secondary-foreground: 0 0% 9%;
+  --muted: 0 0% 96.1%;
+  --muted-foreground: 0 0% 45.1%;
+  --accent: 0 0% 96.1%;
+  --accent-foreground: 0 0% 9%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 0 0% 89.8%;
+  --input: 0 0% 89.8%;
+  --ring: 0 0% 3.9%;
+  --radius: 0.5rem;
+}
+
+.dark {
+  --background: 0 0% 3.9%;
+  --foreground: 0 0% 98%;
+  --card: 0 0% 3.9%;
+  --card-foreground: 0 0% 98%;
+  --popover: 0 0% 3.9%;
+  --popover-foreground: 0 0% 98%;
+  --primary: 0 0% 98%;
+  --primary-foreground: 0 0% 9%;
+  --secondary: 0 0% 14.9%;
+  --secondary-foreground: 0 0% 98%;
+  --muted: 0 0% 14.9%;
+  --muted-foreground: 0 0% 63.9%;
+  --accent: 0 0% 14.9%;
+  --accent-foreground: 0 0% 98%;
+  --destructive: 0 62.8% 30.6%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 0 0% 14.9%;
+  --input: 0 0% 14.9%;
+  --ring: 0 0% 83.1%;
+}

docs/app/layout.tsx

@@ -0,0 +1,50 @@
+import "./global.css"
+import { RootProvider } from "fumadocs-ui/provider/next"
+import { Inter } from "next/font/google"
+import type { ReactNode } from "react"
+
+const inter = Inter({
+  subsets: ["latin"],
+  variable: "--font-geist-sans",
+  display: "swap",
+})
+
+const interMono = Inter({
+  subsets: ["latin"],
+  variable: "--font-geist-mono",
+  display: "swap",
+})
+
+export const metadata = {
+  title: {
+    default: "Mathematical Utilities Documentation",
+    template: "%s | Mathematical Utilities",
+  },
+  description: "High-performance math operations for blockchain",
+}
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <html
+      lang="en"
+      className={`${inter.variable} ${interMono.variable}`}
+      suppressHydrationWarning
+    >
+      <body className="min-h-svh bg-background font-sans antialiased">
+        <RootProvider
+          search={{
+            enabled: true,
+          }}
+          theme={{
+            enabled: true,
+            defaultTheme: "dark",
+          }}
+        >
+          <div className="relative flex min-h-svh flex-col bg-background">
+            {children}
+          </div>
+        </RootProvider>
+      </body>
+    </html>
+  )
+}

docs/app/page.tsx

@@ -0,0 +1,26 @@
+import Link from "next/link"
+
+export default function HomePage() {
+  return (
+    <main className="flex flex-1 flex-col items-center justify-center px-4">
+      <div className="container flex flex-col items-center gap-12 py-24 sm:gap-16 sm:py-32">
+        <div className="flex flex-col items-center gap-4 text-center">
+          <h1 className="text-4xl font-bold tracking-tight sm:text-6xl">
+            Documentation
+          </h1>
+          <p className="max-w-2xl text-lg text-muted-foreground">
+            Get started with our comprehensive documentation
+          </p>
+        </div>
+        <div className="flex gap-4">
+          <Link
+            href="/docs"
+            className="inline-flex h-10 items-center justify-center rounded-md bg-primary px-8 text-sm font-medium text-primary-foreground shadow transition-colors hover:bg-primary/90"
+          >
+            Get Started
+          </Link>
+        </div>
+      </div>
+    </main>
+  )
+}

docs/lib/source.ts

@@ -0,0 +1,18 @@
+import { docs } from "@/.source"
+import { loader } from "fumadocs-core/source"
+
+// Create a single source instance that is reused
+// This prevents circular references and stack overflow issues
+let _source: ReturnType<typeof loader> | null = null
+
+export function getSource() {
+  if (!_source) {
+    _source = loader({
+      baseUrl: "/docs",
+      source: docs.toFumadocsSource(),
+    })
+  }
+  return _source
+}
+
+export const source = getSource()

docs/mdx-components.tsx

@@ -0,0 +1,9 @@
+import type { MDXComponents } from "mdx/types"
+import defaultMdxComponents from "fumadocs-ui/mdx"
+
+export function useMDXComponents(components: MDXComponents): MDXComponents {
+  return {
+    ...defaultMdxComponents,
+    ...components,
+  }
+}

docs/next.config.mjs

@@ -0,0 +1,20 @@
+import { createMDX } from "fumadocs-mdx/next"
+
+/** @type {import('next').NextConfig} */
+const config = {
+  output: 'export',
+  reactStrictMode: true,
+  typescript: {
+    ignoreBuildErrors: true,
+  },
+  experimental: {
+    webpackBuildWorker: true,
+  },
+  images: {
+    unoptimized: true,
+  },
+}
+
+const withMDX = createMDX()
+
+export default withMDX(config)

docs/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@luxfi/math-docs",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --port 3001",
+    "build": "fumadocs-mdx && TURBOPACK=0 next build",
+    "export": "TURBOPACK=0 next build",
+    "start": "next start",
+    "lint": "next lint",
+    "postinstall": "fumadocs-mdx"
+  },
+  "dependencies": {
+    "fumadocs-core": "^15.8.5",
+    "fumadocs-mdx": "^12.0.3",
+    "fumadocs-ui": "^15.8.5",
+    "lucide-react": "^0.468.0",
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "tailwindcss": "^4.1.16",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.16",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.49",
+    "rehype-pretty-code": "^0.14.1",
+    "shiki": "^1.27.2",
+    "typescript": "^5.7.2"
+  },
+  "packageManager": "pnpm@10.12.4"
+}

docs/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+    autoprefixer: {},
+  },
+}

docs/source.config.ts

@@ -0,0 +1,27 @@
+import {
+  defineConfig,
+  defineDocs,
+} from "fumadocs-mdx/config"
+import rehypePrettyCode from "rehype-pretty-code"
+
+export default defineConfig({
+  mdxOptions: {
+    rehypePlugins: [
+      [
+        rehypePrettyCode,
+        {
+          theme: {
+            dark: "github-dark-dimmed",
+            light: "github-light",
+          },
+          keepBackground: false,
+          defaultLang: "go",
+        },
+      ],
+    ],
+  },
+})
+
+export const docs = defineDocs({
+  dir: "content/docs",
+})

docs/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

go.mod

@@ -1,6 +1,6 @@
 module github.com/luxfi/math
 
-go 1.25.1
+go 1.24.5
 
 require (
 	github.com/luxfi/geth v1.16.34

set/set.go

@@ -18,7 +18,11 @@ func Of[T comparable](elements ...T) Set[T] {
 }
 
 // Add adds one or more elements to the set
+// If the set is nil, this method will panic. Use NewSet() or Of() to create an initialized set.
 func (s Set[T]) Add(elements ...T) {
+    if s == nil {
+        panic("set: Add called on nil Set - use NewSet() or Of() to create an initialized set")
+    }
     for _, element := range elements {
         s[element] = struct{}{}
     }