moai-adk 0.25.4__py3-none-any.whl → 0.32.8__py3-none-any.whl

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

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

@@ -0,0 +1,52 @@
+# MDX Components
+
+## Overview
+
+Reusable MDX components for enhanced documentation.
+
+## Core Components
+
+### Callout Component
+
+```mdx
+<Callout type="info">
+ Important information here
+</Callout>
+
+<Callout type="warning">
+ Warning message
+</Callout>
+```
+
+### Code Block Component
+
+```mdx
+<CodeBlock language="python" highlight="2,4-6">
+{`
+def example():
+ # Highlighted line
+ result = process()
+ # More highlighted lines
+ return result
+`}
+</CodeBlock>
+```
+
+## Custom Components
+
+### Tabs Component
+
+```mdx
+<Tabs>
+ <Tab label="Python">
+ Python code example
+ </Tab>
+ <Tab label="JavaScript">
+ JavaScript code example
+ </Tab>
+</Tabs>
+```
+
+---
+Last Updated: 2025-11-23
+Status: Production Ready