@moontra/moonui-pro 2.18.2 → 2.18.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moontra/moonui-pro",
-  "version": "2.18.2",
+  "version": "2.18.4",
   "description": "Premium React components for MoonUI - Advanced UI library with 50+ pro components including performance, interactive, and gesture components",
   "type": "module",
   "main": "dist/index.mjs",

package/src/components/github-stars/github-api.ts

@@ -3,6 +3,19 @@ import { GitHubRepository, GitHubStats, GitHubActivity, LanguageStats, RateLimit
 // Cache management
 const cache = new Map<string, { data: any; timestamp: number; expiresAt: number }>()
 
+// Docs mode detection
+const isDocsMode = () => {
+  return typeof window !== "undefined" && 
+    (window.location.pathname.includes("/docs/") || 
+     window.location.pathname.includes("/components/"))
+}
+
+// Get cache duration based on mode
+const getCacheDuration = (defaultDuration: number) => {
+  // Docs modunda cache süresini 30 dakikaya çıkar
+  return isDocsMode() ? 1800000 : defaultDuration // 30 dakika : default
+}
+
 // Language colors
 export const LANGUAGE_COLORS: Record<string, string> = {
   JavaScript: "#f7df1e",
@@ -86,7 +99,7 @@ export async function getRateLimitInfo(token?: string): Promise<RateLimitInfo> {
   cache.set(cacheKey, {
     data: rateLimitInfo,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 60000, // Cache for 1 minute
+    expiresAt: Date.now() + getCacheDuration(60000), // Docs modunda daha uzun cache
   })
 
   return rateLimitInfo
@@ -121,7 +134,7 @@ export async function fetchUserRepositories(
   cache.set(cacheKey, {
     data: repos,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 300000, // Cache for 5 minutes
+    expiresAt: Date.now() + getCacheDuration(300000), // Docs modunda 30 dakika
   })
 
   return repos
@@ -146,7 +159,7 @@ export async function fetchRepository(
   cache.set(cacheKey, {
     data: repository,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 300000, // Cache for 5 minutes
+    expiresAt: Date.now() + getCacheDuration(300000), // Docs modunda 30 dakika
   })
 
   return repository
@@ -180,7 +193,7 @@ export async function fetchContributorsCount(
         cache.set(cacheKey, {
           data: count,
           timestamp: Date.now(),
-          expiresAt: Date.now() + 3600000, // Cache for 1 hour
+          expiresAt: Date.now() + getCacheDuration(3600000), // Docs modunda 30 dakika
         })
         return count
       }
@@ -193,7 +206,7 @@ export async function fetchContributorsCount(
     cache.set(cacheKey, {
       data: count,
       timestamp: Date.now(),
-      expiresAt: Date.now() + 3600000, // Cache for 1 hour
+      expiresAt: Date.now() + getCacheDuration(3600000), // Docs modunda 30 dakika
     })
     
     return count
@@ -233,7 +246,7 @@ export async function fetchStarHistory(
     cache.set(cacheKey, {
       data: history,
       timestamp: Date.now(),
-      expiresAt: Date.now() + 3600000, // Cache for 1 hour
+      expiresAt: Date.now() + getCacheDuration(3600000), // Docs modunda 30 dakika
     })
     
     return history

package/src/components/github-stars/hooks.ts

@@ -29,6 +29,9 @@ interface UseGitHubDataOptions {
   onDataUpdate?: (stats: GitHubStats) => void
   onMilestoneReached?: (milestone: Milestone) => void
   milestones?: number[]
+  // Docs mode optimizasyonları için
+  docsMode?: boolean
+  mockDataFallback?: boolean
 }
 
 export function useGitHubData({
@@ -44,7 +47,16 @@ export function useGitHubData({
   onDataUpdate,
   onMilestoneReached,
   milestones = [10, 50, 100, 500, 1000, 5000, 10000],
+  docsMode = false,
+  mockDataFallback = true,
 }: UseGitHubDataOptions) {
+  // Docs mode tespiti
+  const isDocsMode = docsMode || (typeof window !== "undefined" && 
+    (window.location.pathname.includes("/docs/") || 
+     window.location.pathname.includes("/components/")))
+  
+  // Docs modunda autoRefresh'i devre dışı bırak
+  const effectiveAutoRefresh = isDocsMode ? false : autoRefresh
   const [repos, setRepos] = useState<GitHubRepository[]>([])
   const [stats, setStats] = useState<GitHubStats | null>(null)
   const [loading, setLoading] = useState(true)
@@ -55,7 +67,9 @@ export function useGitHubData({
   const refreshTimeoutRef = useRef<NodeJS.Timeout>()
   const previousStarsRef = useRef<Map<string, number>>(new Map())
   const errorCountRef = useRef<number>(0) // Hata sayısını takip et
-  const maxErrorCount = 2 // Maksimum hata sayısı
+  const maxErrorCount = isDocsMode ? 1 : 2 // Docs modunda daha az deneme
+  const hasInitialFetchedRef = useRef(false) // İlk fetch yapıldı mı?
+  const docsDataCacheRef = useRef<GitHubRepository[] | null>(null) // Docs mode cache
 
   // checkMilestones fonksiyonunu ref olarak sakla - bu şekilde her render'da yeniden oluşturulmaz
   const milestonesRef = useRef(milestones)
@@ -93,11 +107,32 @@ export function useGitHubData({
   }, []) // Boş dependency array - fonksiyon asla yeniden oluşturulmaz
 
   const fetchData = useCallback(async () => {
+    // Docs modunda ve daha önce fetch yapıldıysa, cache'den döndür
+    if (isDocsMode && hasInitialFetchedRef.current && docsDataCacheRef.current) {
+      console.log("[Docs Mode] Returning cached data, skipping API request")
+      setRepos(docsDataCacheRef.current)
+      const calculatedStats = calculateStats(docsDataCacheRef.current)
+      setStats(calculatedStats)
+      setLoading(false)
+      return
+    }
+
     // Hata limiti aşıldıysa istek yapma
     if (errorCountRef.current >= maxErrorCount) {
       console.warn("Maximum error count reached. Stopping requests.")
+      
+      // Docs modunda ve mockDataFallback aktifse mock data göster
+      if (isDocsMode && mockDataFallback) {
+        const mockData = getMockGitHubData(username, repository, repositories)
+        setRepos(mockData)
+        const calculatedStats = calculateStats(mockData)
+        setStats(calculatedStats)
+        setError(null)
+      } else {
+        setError("Maximum retry limit exceeded. Please check your configuration.")
+      }
+      
       setLoading(false)
-      setError("Maximum retry limit exceeded. Please check your configuration.")
       return
     }
 
@@ -222,6 +257,12 @@ export function useGitHubData({
       setLastUpdated(new Date())
       // Başarılı olduğunda hata sayacını sıfırla
       errorCountRef.current = 0
+      
+      // Docs modunda başarılı veriyi cache'le
+      if (isDocsMode) {
+        hasInitialFetchedRef.current = true
+        docsDataCacheRef.current = enhancedRepos
+      }
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : "Failed to fetch data"
       setError(errorMessage)
@@ -230,7 +271,17 @@ export function useGitHubData({
       errorCountRef.current += 1
       console.error(`GitHub API error (${errorCountRef.current}/${maxErrorCount}):`, errorMessage)
       
-      if (onError) {
+      // Docs modunda ve mockDataFallback aktifse mock data göster
+      if (isDocsMode && mockDataFallback && !hasInitialFetchedRef.current) {
+        console.warn("[Docs Mode] API failed, using mock data")
+        const mockData = getMockGitHubData(username, repository, repositories)
+        setRepos(mockData)
+        const calculatedStats = calculateStats(mockData)
+        setStats(calculatedStats)
+        setError(null)
+        hasInitialFetchedRef.current = true
+        docsDataCacheRef.current = mockData
+      } else if (onError) {
         onError(err instanceof Error ? err : new Error(errorMessage))
       }
     } finally {
@@ -246,6 +297,8 @@ export function useGitHubData({
     checkMilestones, // Artık stable
     onDataUpdate,
     onError,
+    isDocsMode,
+    mockDataFallback,
   ])
 
   // Initial fetch
@@ -266,7 +319,8 @@ export function useGitHubData({
 
   // Auto-refresh
   useEffect(() => {
-    if (!autoRefresh) return
+    // Docs modunda auto-refresh'i tamamen devre dışı bırak
+    if (!effectiveAutoRefresh) return
 
     const scheduleRefresh = () => {
       refreshTimeoutRef.current = setTimeout(() => {
@@ -282,9 +336,15 @@ export function useGitHubData({
         clearTimeout(refreshTimeoutRef.current)
       }
     }
-  }, [autoRefresh, refreshInterval, fetchData])
+  }, [effectiveAutoRefresh, refreshInterval, fetchData])
 
   const refresh = useCallback(() => {
+    // Docs modunda refresh'i sınırla
+    if (isDocsMode && hasInitialFetchedRef.current) {
+      console.warn("[Docs Mode] Refresh disabled after initial fetch")
+      return Promise.resolve()
+    }
+    
     // Hata limiti aşıldıysa refresh yapma
     if (errorCountRef.current >= maxErrorCount) {
       console.warn("Cannot refresh: maximum error count reached")
@@ -293,7 +353,7 @@ export function useGitHubData({
     
     clearCache()
     return fetchData()
-  }, [fetchData])
+  }, [fetchData, isDocsMode])
 
   return {
     repos,
@@ -372,4 +432,70 @@ export function useGitHubNotifications(enabled: boolean = true) {
   )
 
   return { permission, notify }
+}
+
+// Mock data generator for docs mode
+function getMockGitHubData(
+  username?: string,
+  repository?: string,
+  repositories?: string[]
+): GitHubRepository[] {
+  const defaultRepos: GitHubRepository[] = [
+    {
+      id: 1,
+      name: repository || "awesome-project",
+      full_name: `${username || "moonui"}/${repository || "awesome-project"}`,
+      description: "An amazing open source project with great features",
+      html_url: `https://github.com/${username || "moonui"}/${repository || "awesome-project"}`,
+      homepage: "https://awesome-project.dev",
+      stargazers_count: 12453,
+      watchers_count: 543,
+      forks_count: 2341,
+      language: "TypeScript",
+      topics: ["react", "ui", "components", "typescript"],
+      created_at: "2022-01-15T10:30:00Z",
+      updated_at: new Date().toISOString(),
+      pushed_at: new Date().toISOString(),
+      size: 4567,
+      open_issues_count: 23,
+      license: {
+        key: "mit",
+        name: "MIT License",
+        spdx_id: "MIT",
+        url: "https://api.github.com/licenses/mit",
+      },
+      owner: {
+        login: username || "moonui",
+        avatar_url: `https://github.com/${username || "moonui"}.png`,
+        html_url: `https://github.com/${username || "moonui"}`,
+        type: "Organization",
+      },
+      contributors_count: 89,
+    },
+  ]
+
+  if (repositories && repositories.length > 0) {
+    return repositories.map((repo, index) => {
+      const [owner, name] = repo.includes('/') ? repo.split('/') : [username || "moonui", repo]
+      return {
+        ...defaultRepos[0],
+        id: index + 1,
+        name: name,
+        full_name: `${owner}/${name}`,
+        html_url: `https://github.com/${owner}/${name}`,
+        stargazers_count: Math.floor(Math.random() * 20000) + 1000,
+        forks_count: Math.floor(Math.random() * 3000) + 100,
+        watchers_count: Math.floor(Math.random() * 1000) + 50,
+        language: ["TypeScript", "JavaScript", "Python", "Go", "Rust"][index % 5],
+        owner: {
+          login: owner,
+          avatar_url: `https://github.com/${owner}.png`,
+          html_url: `https://github.com/${owner}`,
+          type: "Organization",
+        },
+      }
+    })
+  }
+
+  return defaultRepos
 }

package/src/components/github-stars/index.tsx

@@ -60,7 +60,16 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
   size = "md",
   customColors,
 }) => {
-  const { notify } = useGitHubNotifications(enableNotifications)
+  // Docs mode tespiti
+  const isDocsMode = typeof window !== "undefined" && 
+    (window.location.pathname.includes("/docs/") || 
+     window.location.pathname.includes("/components/"))
+  
+  // Docs modunda bazı özellikleri override et
+  const effectiveAutoRefresh = isDocsMode ? false : autoRefresh
+  const effectiveNotifications = isDocsMode ? false : enableNotifications
+  const effectiveRefreshInterval = isDocsMode ? 3600000 : refreshInterval // Docs modunda 1 saat
+  const { notify } = useGitHubNotifications(effectiveNotifications)
 
   // onMilestoneReached callback'ini memoize et
   const handleMilestoneReached = React.useCallback((milestone: any) => {
@@ -96,14 +105,16 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
     repository,
     repositories,
     token,
-    autoRefresh,
-    refreshInterval,
+    autoRefresh: effectiveAutoRefresh,
+    refreshInterval: effectiveRefreshInterval,
     sortBy,
     maxItems,
     onError,
     onDataUpdate,
     onMilestoneReached: handleMilestoneReached,
     milestones,
+    docsMode: isDocsMode, // Docs mode flag'ini gönder
+    mockDataFallback: true, // Docs modunda mock data kullan
   })
 
   const handleExport = React.useCallback((format: "json" | "csv") => {
@@ -296,8 +307,8 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
     >
       {renderVariant()}
       
-      {/* Rate limit warning */}
-      {rateLimitInfo && rateLimitInfo.remaining < 10 && (
+      {/* Rate limit warning - Docs modunda gösterme */}
+      {!isDocsMode && rateLimitInfo && rateLimitInfo.remaining < 10 && (
         <div className="mt-4 p-3 bg-yellow-50 dark:bg-yellow-900/20 rounded-md text-sm">
           <p className="text-yellow-800 dark:text-yellow-200">
             ⚠️ Low API rate limit: {rateLimitInfo.remaining} requests remaining.
@@ -305,6 +316,13 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
           </p>
         </div>
       )}
+      
+      {/* Docs mode indicator - sadece development modunda göster */}
+      {isDocsMode && process.env.NODE_ENV === "development" && (
+        <div className="mt-2 text-xs text-muted-foreground text-center">
+          📚 Docs Mode: API istekleri optimize edildi
+        </div>
+      )}
     </motion.div>
   )
 }