moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-library-nextra/modules/advanced-deployment-patterns.md

@@ -0,0 +1,182 @@
+---
+name: advanced-deployment-patterns
+parent: moai-library-nextra
+description: Mobile optimization, accessibility, and SEO
+---
+
+# Module 3: Advanced Deployment & Patterns
+
+## Mobile Optimization
+
+### Mobile-First Layout
+
+```tsx
+// components/ui/MobileLayout.tsx
+import { useState } from 'react'
+
+export function MobileLayout({ children }) {
+ const [sidebarOpen, setSidebarOpen] = useState(false)
+
+ return (
+ <div className="min-h-screen bg-background">
+ {/* Mobile Header */}
+ <header className="sticky top-0 z-50 border-b md:hidden">
+ <div className="flex h-14 items-center px-4">
+ <button
+ onClick={() => setSidebarOpen(true)}
+ className="mr-4 p-2 rounded-md hover:bg-accent"
+ >
+ <svg className="h-5 w-5" fill="none" stroke="currentColor">
+ <path strokeLinecap="round" d="M4 6h16M4 12h16M4 18h16" />
+ </svg>
+ </button>
+ <h1 className="text-lg font-semibold">Documentation</h1>
+ </div>
+ </header>
+
+ <main className="flex-1 md:flex">
+ <aside className="hidden md:block w-64 border-r">
+ {/* Sidebar */}
+ </aside>
+ <div className="flex-1 px-4 py-6">
+ {children}
+ </div>
+ </main>
+ </div>
+ )
+}
+```
+
+## Accessibility (WCAG 2.1)
+
+### Semantic HTML Structure
+
+```tsx
+// components/ui/AccessibleContent.tsx
+export function AccessibleContent({ title, children }) {
+ return (
+ <main id="main-content" role="main" aria-labelledby="page-title">
+ <header>
+ <h1 id="page-title" className="sr-only">
+ {title}
+ </h1>
+ </header>
+
+ <div className="prose prose-lg max-w-none">
+ {children}
+ </div>
+
+ <a
+ href="#main-content"
+ className="sr-only focus:not-sr-only focus:absolute focus:top-4"
+ >
+ Skip to main content
+ </a>
+ </main>
+ )
+}
+```
+
+### Keyboard Navigation
+
+```tsx
+// components/ui/KeyboardNavigation.tsx
+import { useEffect } from 'react'
+
+export function KeyboardNavigation() {
+ useEffect(() => {
+ const handleKeyDown = (event: KeyboardEvent) {
+ if (event.key === 'Escape') {
+ const modal = document.querySelector('[role="dialog"]')
+ if (modal) {
+ const closeButton = modal.querySelector('button[aria-label*="Close"]')
+ closeButton?.dispatchEvent(new MouseEvent('click'))
+ }
+ }
+ }
+
+ document.addEventListener('keydown', handleKeyDown)
+ return () => document.removeEventListener('keydown', handleKeyDown)
+ }, [])
+
+ return null
+}
+```
+
+## SEO Optimization
+
+### Dynamic SEO Implementation
+
+```typescript
+// lib/seo.ts
+import type { Metadata } from 'next'
+
+export function generateSEOMetadata({
+ title,
+ description,
+ path = '',
+ image,
+ keywords = []
+}: {
+ title: string
+ description: string
+ path?: string
+ image?: string
+ keywords?: string[]
+}): Metadata {
+ const baseUrl = 'https://docs.example.com'
+ const url = `${baseUrl}${path}`
+
+ return {
+ title,
+ description,
+ keywords: keywords.join(', '),
+ openGraph: {
+ type: 'article',
+ locale: 'en_US',
+ url,
+ title,
+ description,
+ images: image ? [{
+ url: image,
+ width: 1200,
+ height: 630,
+ }] : [],
+ },
+ twitter: {
+ card: 'summary_large_image',
+ title,
+ description,
+ },
+ alternates: {
+ canonical: url,
+ },
+ robots: {
+ index: true,
+ follow: true,
+ },
+ }
+}
+```
+
+## Production Deployment
+
+```bash
+# Build optimization
+npm run build
+
+# Static export
+npm run export
+
+# Deploy to Vercel
+vercel --prod
+
+# Deploy to Netlify
+netlify deploy --prod --dir=out
+```
+
+---
+
+References:
+- [MDN Web Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
+- [Google SEO Guide](https://developers.google.com/search/docs/fundamentals/seo-starter-guide)

moai_adk/templates/.claude/skills/moai-library-nextra/modules/advanced-patterns.md

@@ -0,0 +1,17 @@
+# Advanced Patterns
+
+This file contains advanced patterns and use cases for this skill.
+
+## Content Structure
+
+Move advanced content here:
+- Complex implementation patterns
+- Edge cases and error handling
+- Performance optimization techniques
+- Advanced configuration options
+- Troubleshooting guides
+
+## How to organize
+
+Organize advanced patterns in a way that makes sense for this skill's domain.
+Each subsection should be self-contained and referenceable from SKILL.md.

moai_adk/templates/.claude/skills/moai-library-nextra/modules/configuration.md

@@ -0,0 +1,57 @@
+# Configuration Guide
+
+## Overview
+
+Comprehensive configuration options and best practices.
+
+## Basic Configuration
+
+### YAML Configuration
+
+```yaml
+# config.yaml
+skill:
+ name: "skill-name"
+ version: "1.0.0"
+ options:
+ mode: "production"
+ timeout: 60
+ retries: 3
+```
+
+### Environment Variables
+
+```bash
+export SKILL_MODE=production
+export SKILL_TIMEOUT=60
+export SKILL_RETRIES=3
+```
+
+## Advanced Configuration
+
+### Custom Settings
+
+```python
+from moai_adk import Config
+
+config = Config.from_file("config.yaml")
+config.set("custom_option", "value")
+config.save()
+```
+
+### Profile-Based Configuration
+
+```yaml
+# config.yaml
+profiles:
+ development:
+ mode: "debug"
+ timeout: 300
+ production:
+ mode: "strict"
+ timeout: 30
+```
+
+---
+Last Updated: 2025-11-23
+Status: Production Ready

moai_adk/templates/.claude/skills/moai-library-nextra/modules/content-architecture-optimization.md

@@ -0,0 +1,162 @@
+---
+name: content-architecture-optimization
+parent: moai-library-nextra
+description: Content structure and performance optimization
+---
+
+# Module 2: Content Architecture & Optimization
+
+## Directory Structure Design
+
+### Optimal Nextra Project Structure
+
+```
+docs/
+ pages/ # Route definitions
+ _meta.json # Site metadata
+ api/ # Custom API routes
+ public/ # Static assets
+ images/
+ files/
+ favicon.ico
+ components/ # React components
+ ui/
+ diagrams/
+ interactive/
+ lib/ # Utility functions
+ nextra-config.ts
+ content-utils.ts
+ search-client.ts
+ styles/
+ globals.css
+ components.css
+ content/ # Documentation content
+ index.mdx
+ getting-started/
+ guides/
+ reference/
+ tutorials/
+ scripts/
+ build-search-index.js
+ validate-links.js
+ generate-sitemap.js
+ types/
+ content.d.ts
+ config.d.ts
+```
+
+## Content Type Patterns
+
+### Homepage Pattern
+
+```mdx
+---
+title: Welcome to My Documentation
+description: Comprehensive guide for getting started
+---
+
+import { Callout } from 'nextra-theme-docs'
+import { Tabs, TabItem } from 'nextra-theme-docs'
+
+# Welcome to My Platform
+
+<Callout type="info" emoji="">
+ This documentation will help you get up and running in minutes.
+</Callout>
+
+## Quick Start
+
+<Tabs items={['npm', 'yarn', 'pnpm']}>
+ <TabItem>
+ ```bash
+ npm install my-platform
+ ```
+ </TabItem>
+ <TabItem>
+ ```bash
+ yarn add my-platform
+ ```
+ </TabItem>
+ <TabItem>
+ ```bash
+ pnpm install my-platform
+ ```
+ </TabItem>
+</Tabs>
+```
+
+## Performance Optimization
+
+### Search Optimization
+
+```typescript
+// lib/search-client.ts
+export class SearchClient {
+ private searchIndex: Map<string, PagefindResult> = new Map()
+
+ async initialize() {
+ const response = await fetch('/search-index.json')
+ const index = await response.json()
+
+ this.searchIndex = new Map(
+ index.map((item: PagefindResult) => [item.url, item])
+ )
+ }
+
+ async search(query: string, limit = 10) {
+ const results = Array.from(this.searchIndex.values())
+ .filter(item =>
+ item.title.toLowerCase().includes(query.toLowerCase()) ||
+ item.content.toLowerCase().includes(query.toLowerCase())
+ )
+ .slice(0, limit)
+
+ return {
+ results,
+ total: results.length
+ }
+ }
+}
+```
+
+### Client-Side Optimization
+
+```typescript
+// lib/performance.ts
+export class PerformanceOptimizer {
+ static optimizeImages() {
+ if ('IntersectionObserver' in window) {
+ const imageObserver = new IntersectionObserver((entries) => {
+ entries.forEach(entry => {
+ if (entry.isIntersecting) {
+ const img = entry.target as HTMLImageElement
+ if (img.dataset.src) {
+ img.src = img.dataset.src
+ imageObserver.unobserve(img)
+ }
+ }
+ })
+ })
+
+ document.querySelectorAll('img[data-src]').forEach(img => {
+ imageObserver.observe(img)
+ })
+ }
+ }
+
+ static prefetchCriticalResources() {
+ const criticalPaths = ['/api/content', '/search-index.json']
+
+ criticalPaths.forEach(path => {
+ const link = document.createElement('link')
+ link.rel = 'prefetch'
+ link.href = path
+ document.head.appendChild(link)
+ })
+ }
+}
+```
+
+---
+
+Reference: [Next.js Performance](https://nextjs.org/docs/advanced-features/measuring-performance)

moai_adk/templates/.claude/skills/moai-library-nextra/modules/deployment.md

@@ -0,0 +1,52 @@
+# Deployment Guide
+
+## Overview
+
+Production deployment strategies and best practices.
+
+## Deployment Platforms
+
+### Vercel Deployment
+
+```bash
+# Install Vercel CLI
+npm install -g vercel
+
+# Deploy
+vercel --prod
+```
+
+### Netlify Deployment
+
+```bash
+# Install Netlify CLI
+npm install -g netlify-cli
+
+# Deploy
+netlify deploy --prod
+```
+
+## CI/CD Deployment
+
+### GitHub Actions
+
+```yaml
+name: Deploy
+on:
+ push:
+ branches: [main]
+
+jobs:
+ deploy:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - uses: actions/setup-node@v3
+ - run: npm ci
+ - run: npm run build
+ - run: vercel --prod --token ${{ secrets.VERCEL_TOKEN }}
+```
+
+---
+Last Updated: 2025-11-23
+Status: Production Ready

moai_adk/templates/.claude/skills/moai-library-nextra/modules/framework-core-configuration.md

@@ -0,0 +1,186 @@
+---
+name: framework-core-configuration
+parent: moai-library-nextra
+description: Nextra framework setup and theme configuration
+---
+
+# Module 1: Framework Core & Configuration
+
+## Core Architecture Principles
+
+Nextra is a React-based static site generator built on Next.js that specializes in documentation websites. Key architectural advantages:
+
+- Zero Config MDX: Markdown + JSX without build configuration
+- File-system Routing: Automatic route generation from content structure
+- Performance Optimization: Automatic code splitting and prefetching
+- Theme System: Pluggable architecture with customizable themes
+- i18n Support: Built-in internationalization with automatic locale detection
+
+## Essential Configuration Patterns
+
+### theme.config.tsx (Core Configuration)
+
+```typescript
+import { DocsThemeConfig } from 'nextra-theme-docs'
+
+const config: DocsThemeConfig = {
+ logo: <span>My Documentation</span>,
+ project: {
+ link: 'https://github.com/username/project',
+ },
+ docsRepositoryBase: 'https://github.com/username/project/tree/main',
+ useNextSeoProps: true,
+ head: (
+ <>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta property="og:title" content="My Documentation" />
+ <meta property="og:description" content="Comprehensive documentation" />
+ </>
+ ),
+ footer: {
+ text: 'Built with Nextra and Next.js',
+ },
+ sidebar: {
+ defaultMenuCollapseLevel: 1,
+ toggleButton: true,
+ },
+ toc: {
+ backToTop: true,
+ extraContent: (
+ <div style={{ fontSize: '0.8em', marginTop: '1em' }}>
+ Last updated: {new Date().toLocaleDateString()}
+ </div>
+ ),
+ },
+ editLink: {
+ text: 'Edit this page on GitHub →',
+ },
+ feedback: {
+ content: 'Question? Give us feedback →',
+ labels: 'feedback',
+ },
+ navigation: {
+ prev: true,
+ next: true,
+ },
+ darkMode: true,
+ themeSwitch: {
+ component: <ThemeSwitch />,
+ useOptions() {
+ return {
+ light: 'Light',
+ dark: 'Dark',
+ system: 'System',
+ }
+ },
+ },
+}
+
+export default config
+```
+
+### next.config.js (Build Optimization)
+
+```javascript
+const withNextra = require('nextra')({
+ theme: 'nextra-theme-docs',
+ themeConfig: './theme.config.tsx',
+ // Performance optimizations
+ staticImage: true,
+ flexibleSearch: true,
+ defaultShowCopyCode: true,
+ readingTime: true,
+ // MDX configuration
+ mdxOptions: {
+ remarkPlugins: [
+ require('remark-gfm'),
+ require('remark-footnotes'),
+ ],
+ rehypePlugins: [
+ require('rehype-slug'),
+ require('rehype-autolink-headings'),
+ ],
+ },
+})
+
+module.exports = withNextra({
+ // Next.js optimizations
+ experimental: {
+ appDir: true,
+ serverComponentsExternalPackages: ['nextra'],
+ },
+ images: {
+ domains: ['example.com'],
+ formats: ['image/webp', 'image/avif'],
+ },
+ // Build performance
+ swcMinify: true,
+ compiler: {
+ removeConsole: process.env.NODE_ENV === 'production',
+ },
+ // Static export configuration
+ output: 'export',
+ trailingSlash: true,
+ images: {
+ unoptimized: true,
+ },
+})
+```
+
+## Custom Theme Development
+
+```typescript
+// components/custom-theme.tsx
+import type { DocsThemeConfig } from 'nextra-theme-docs'
+
+export const customTheme: DocsThemeConfig = {
+ // Custom components
+ components: {
+ h1: (props) => <h1 className="custom-heading" {...props} />,
+ pre: (props) => <CodeBlock {...props} />,
+ },
+ 
+ // Custom CSS
+ primaryHue: {
+ dark: 210,
+ light: 210
+ },
+ 
+ // Custom navigation
+ navbar: {
+ extraContent: () => <CustomNavButtons />
+ }
+}
+```
+
+## Build Optimization
+
+```typescript
+// scripts/optimize-build.js
+const { execSync } = require('child_process')
+
+function optimizeBuild() {
+ // Clear Next.js cache
+ execSync('rm -rf .next', { stdio: 'inherit' })
+
+ // Generate search index incrementally
+ execSync('node scripts/build-search-index.js --incremental', {
+ stdio: 'inherit'
+ })
+
+ // Optimize images
+ execSync('node scripts/optimize-images.js', { stdio: 'inherit' })
+}
+
+function optimizeOutput() {
+ // Generate sitemap
+ execSync('node scripts/generate-sitemap.js', { stdio: 'inherit' })
+
+ // Compress static assets
+ execSync('gzip -k -r out/', { stdio: 'inherit' })
+}
+```
+
+---
+
+Reference: [Nextra Official Documentation](https://nextra.site/)

moai_adk/templates/.claude/skills/moai-library-nextra/modules/i18n-setup.md

@@ -0,0 +1,55 @@
+# Internationalization Setup
+
+## Overview
+
+Multi-language documentation setup and management.
+
+## Configuration
+
+### I18n Config
+
+```javascript
+// next.config.js
+module.exports = {
+ i18n: {
+ locales: ['en', 'ko', 'ja', 'zh'],
+ defaultLocale: 'en'
+ }
+}
+```
+
+### Directory Structure
+
+```
+docs/
+ en/
+ index.md
+ guide.md
+ ko/
+ index.md
+ guide.md
+ ja/
+ index.md
+ guide.md
+```
+
+## Translation Workflow
+
+### Translation Files
+
+```json
+{
+ "en": {
+ "welcome": "Welcome",
+ "guide": "Guide"
+ },
+ "ko": {
+ "welcome": "",
+ "guide": ""
+ }
+}
+```
+
+---
+Last Updated: 2025-11-23
+Status: Production Ready