@moontra/moonui-pro 2.18.3 → 2.18.5

package/dist/index.mjs

@@ -61374,6 +61374,12 @@ var AdvancedForms = ({ className, ...props }) => {
 
 // src/components/github-stars/github-api.ts
 var cache = /* @__PURE__ */ new Map();
+var isDocsMode = () => {
+  return typeof window !== "undefined" && (window.location.pathname.includes("/docs/") || window.location.pathname.includes("/components/"));
+};
+var getCacheDuration = (defaultDuration) => {
+  return isDocsMode() ? 18e5 : defaultDuration;
+};
 var LANGUAGE_COLORS = {
   JavaScript: "#f7df1e",
   TypeScript: "#3178c6",
@@ -61441,8 +61447,8 @@ async function getRateLimitInfo(token) {
   cache.set(cacheKey, {
     data: rateLimitInfo,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 6e4
-    // Cache for 1 minute
+    expiresAt: Date.now() + getCacheDuration(6e4)
+    // Docs modunda daha uzun cache
   });
   return rateLimitInfo;
 }
@@ -61462,8 +61468,8 @@ async function fetchUserRepositories(username, token, options) {
   cache.set(cacheKey, {
     data: repos,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 3e5
-    // Cache for 5 minutes
+    expiresAt: Date.now() + getCacheDuration(3e5)
+    // Docs modunda 30 dakika
   });
   return repos;
 }
@@ -61478,8 +61484,8 @@ async function fetchRepository(owner, repo, token) {
   cache.set(cacheKey, {
     data: repository,
     timestamp: Date.now(),
-    expiresAt: Date.now() + 3e5
-    // Cache for 5 minutes
+    expiresAt: Date.now() + getCacheDuration(3e5)
+    // Docs modunda 30 dakika
   });
   return repository;
 }
@@ -61502,8 +61508,8 @@ async function fetchContributorsCount(owner, repo, token) {
         cache.set(cacheKey, {
           data: count4,
           timestamp: Date.now(),
-          expiresAt: Date.now() + 36e5
-          // Cache for 1 hour
+          expiresAt: Date.now() + getCacheDuration(36e5)
+          // Docs modunda 30 dakika
         });
         return count4;
       }
@@ -61513,8 +61519,8 @@ async function fetchContributorsCount(owner, repo, token) {
     cache.set(cacheKey, {
       data: count3,
       timestamp: Date.now(),
-      expiresAt: Date.now() + 36e5
-      // Cache for 1 hour
+      expiresAt: Date.now() + getCacheDuration(36e5)
+      // Docs modunda 30 dakika
     });
     return count3;
   } catch (error) {
@@ -61676,8 +61682,13 @@ function useGitHubData({
   onError,
   onDataUpdate,
   onMilestoneReached,
-  milestones = [10, 50, 100, 500, 1e3, 5e3, 1e4]
+  milestones = [10, 50, 100, 500, 1e3, 5e3, 1e4],
+  docsMode = false,
+  mockDataFallback = true,
+  forceMockData = false
 }) {
+  const isDocsMode2 = docsMode || typeof window !== "undefined" && (window.location.pathname.includes("/docs/") || window.location.pathname.includes("/components/"));
+  const effectiveAutoRefresh = isDocsMode2 ? false : autoRefresh;
   const [repos, setRepos] = useState([]);
   const [stats, setStats] = useState(null);
   const [loading, setLoading] = useState(true);
@@ -61687,7 +61698,9 @@ function useGitHubData({
   const refreshTimeoutRef = useRef();
   const previousStarsRef = useRef(/* @__PURE__ */ new Map());
   const errorCountRef = useRef(0);
-  const maxErrorCount = 2;
+  const maxErrorCount = isDocsMode2 ? 1 : 2;
+  const hasInitialFetchedRef = useRef(false);
+  const docsDataCacheRef = useRef(null);
   const milestonesRef = useRef(milestones);
   const onMilestoneReachedRef = useRef(onMilestoneReached);
   useEffect(() => {
@@ -61716,10 +61729,36 @@ function useGitHubData({
     });
   }, []);
   const fetchData = useCallback(async () => {
+    if (forceMockData) {
+      console.log("[Mock Mode] Using mock data");
+      const mockData = getMockGitHubData(username, repository, repositories);
+      setRepos(mockData);
+      const calculatedStats = calculateStats(mockData);
+      setStats(calculatedStats);
+      setError(null);
+      setLoading(false);
+      return;
+    }
+    if (isDocsMode2 && 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;
+    }
     if (errorCountRef.current >= maxErrorCount) {
       console.warn("Maximum error count reached. Stopping requests.");
+      if (isDocsMode2 && 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;
     }
     const hasValidInput = username && repository || // Tek repository modu
@@ -61812,12 +61851,25 @@ function useGitHubData({
       }
       setLastUpdated(/* @__PURE__ */ new Date());
       errorCountRef.current = 0;
+      if (isDocsMode2) {
+        hasInitialFetchedRef.current = true;
+        docsDataCacheRef.current = enhancedRepos;
+      }
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : "Failed to fetch data";
       setError(errorMessage);
       errorCountRef.current += 1;
       console.error(`GitHub API error (${errorCountRef.current}/${maxErrorCount}):`, errorMessage);
-      if (onError) {
+      if (isDocsMode2 && 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 {
@@ -61834,7 +61886,10 @@ function useGitHubData({
     checkMilestones,
     // Artık stable
     onDataUpdate,
-    onError
+    onError,
+    isDocsMode2,
+    mockDataFallback,
+    forceMockData
   ]);
   useEffect(() => {
     const hasValidInput = username && repository || username && repositories && repositories.length > 0 || repositories && repositories.length > 0 && repositories.every((r2) => r2.includes("/")) || username;
@@ -61845,7 +61900,7 @@ function useGitHubData({
     }
   }, [fetchData]);
   useEffect(() => {
-    if (!autoRefresh)
+    if (!effectiveAutoRefresh)
       return;
     const scheduleRefresh = () => {
       refreshTimeoutRef.current = setTimeout(() => {
@@ -61859,15 +61914,19 @@ function useGitHubData({
         clearTimeout(refreshTimeoutRef.current);
       }
     };
-  }, [autoRefresh, refreshInterval, fetchData]);
+  }, [effectiveAutoRefresh, refreshInterval, fetchData]);
   const refresh = useCallback(() => {
+    if (isDocsMode2 && hasInitialFetchedRef.current) {
+      console.warn("[Docs Mode] Refresh disabled after initial fetch");
+      return Promise.resolve();
+    }
     if (errorCountRef.current >= maxErrorCount) {
       console.warn("Cannot refresh: maximum error count reached");
       return Promise.resolve();
     }
     clearCache();
     return fetchData();
-  }, [fetchData]);
+  }, [fetchData, isDocsMode2]);
   return {
     repos,
     stats,
@@ -61907,6 +61966,64 @@ function useGitHubNotifications(enabled = true) {
   );
   return { permission, notify };
 }
+function getMockGitHubData(username, repository, repositories) {
+  const defaultRepos = [
+    {
+      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: (/* @__PURE__ */ new Date()).toISOString(),
+      pushed_at: (/* @__PURE__ */ 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, index2) => {
+      const [owner, name] = repo.includes("/") ? repo.split("/") : [username || "moonui", repo];
+      return {
+        ...defaultRepos[0],
+        id: index2 + 1,
+        name,
+        full_name: `${owner}/${name}`,
+        html_url: `https://github.com/${owner}/${name}`,
+        stargazers_count: Math.floor(Math.random() * 2e4) + 1e3,
+        forks_count: Math.floor(Math.random() * 3e3) + 100,
+        watchers_count: Math.floor(Math.random() * 1e3) + 50,
+        language: ["TypeScript", "JavaScript", "Python", "Go", "Rust"][index2 % 5],
+        owner: {
+          login: owner,
+          avatar_url: `https://github.com/${owner}.png`,
+          html_url: `https://github.com/${owner}`,
+          type: "Organization"
+        }
+      };
+    });
+  }
+  return defaultRepos;
+}
 var MinimalVariant = ({ repos, stats, className }) => {
   if (!stats)
     return null;
@@ -62393,6 +62510,7 @@ var GitHubStarsInternal = ({
   repository,
   repositories,
   token,
+  useMockData = false,
   variant = "card",
   layout = "grid",
   showDescription = true,
@@ -62429,7 +62547,15 @@ var GitHubStarsInternal = ({
   size: size4 = "md",
   customColors
 }) => {
-  const { notify } = useGitHubNotifications(enableNotifications);
+  const hasValidProps = useMockData || username || repositories && repositories.length > 0;
+  if (!useMockData && !hasValidProps) {
+    return null;
+  }
+  const isDocsMode2 = typeof window !== "undefined" && (window.location.pathname.includes("/docs/") || window.location.pathname.includes("/components/"));
+  const effectiveAutoRefresh = isDocsMode2 ? false : autoRefresh;
+  const effectiveNotifications = isDocsMode2 ? false : enableNotifications;
+  const effectiveRefreshInterval = isDocsMode2 ? 36e5 : refreshInterval;
+  const { notify } = useGitHubNotifications(effectiveNotifications);
   const handleMilestoneReached = t__default.useCallback((milestone) => {
     if (celebrateAt?.includes(milestone.count)) {
       confetti({
@@ -62457,14 +62583,20 @@ var GitHubStarsInternal = ({
     repository,
     repositories,
     token,
-    autoRefresh,
-    refreshInterval,
+    autoRefresh: effectiveAutoRefresh,
+    refreshInterval: effectiveRefreshInterval,
     sortBy,
     maxItems,
     onError,
     onDataUpdate,
     onMilestoneReached: handleMilestoneReached,
-    milestones
+    milestones,
+    docsMode: isDocsMode2,
+    // Docs mode flag'ini gönder
+    mockDataFallback: true,
+    // Docs modunda mock data kullan
+    forceMockData: useMockData
+    // Force mock data if true
   });
   const handleExport = t__default.useCallback((format7) => {
     if (!enableExport)
@@ -62613,12 +62745,13 @@ var GitHubStarsInternal = ({
       className: cn("w-full", className),
       children: [
         renderVariant(),
-        rateLimitInfo && rateLimitInfo.remaining < 10 && /* @__PURE__ */ jsx("div", { className: "mt-4 p-3 bg-yellow-50 dark:bg-yellow-900/20 rounded-md text-sm", children: /* @__PURE__ */ jsxs("p", { className: "text-yellow-800 dark:text-yellow-200", children: [
+        !isDocsMode2 && rateLimitInfo && rateLimitInfo.remaining < 10 && /* @__PURE__ */ jsx("div", { className: "mt-4 p-3 bg-yellow-50 dark:bg-yellow-900/20 rounded-md text-sm", children: /* @__PURE__ */ jsxs("p", { className: "text-yellow-800 dark:text-yellow-200", children: [
           "\u26A0\uFE0F Low API rate limit: ",
           rateLimitInfo.remaining,
           " requests remaining.",
           token ? "" : " Consider adding a GitHub token for higher limits."
-        ] }) })
+        ] }) }),
+        isDocsMode2 && true && /* @__PURE__ */ jsx("div", { className: "mt-2 text-xs text-muted-foreground text-center", children: "\u{1F4DA} Docs Mode: API istekleri optimize edildi" })
       ]
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moontra/moonui-pro",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "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,10 @@ interface UseGitHubDataOptions {
   onDataUpdate?: (stats: GitHubStats) => void
   onMilestoneReached?: (milestone: Milestone) => void
   milestones?: number[]
+  // Docs mode optimizasyonları için
+  docsMode?: boolean
+  mockDataFallback?: boolean
+  forceMockData?: boolean // Force mock data instead of API
 }
 
 export function useGitHubData({
@@ -44,7 +48,17 @@ export function useGitHubData({
   onDataUpdate,
   onMilestoneReached,
   milestones = [10, 50, 100, 500, 1000, 5000, 10000],
+  docsMode = false,
+  mockDataFallback = true,
+  forceMockData = false,
 }: 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 +69,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 +109,44 @@ export function useGitHubData({
   }, []) // Boş dependency array - fonksiyon asla yeniden oluşturulmaz
 
   const fetchData = useCallback(async () => {
+    // If forceMockData is true, always return mock data
+    if (forceMockData) {
+      console.log("[Mock Mode] Using mock data")
+      const mockData = getMockGitHubData(username, repository, repositories)
+      setRepos(mockData)
+      const calculatedStats = calculateStats(mockData)
+      setStats(calculatedStats)
+      setError(null)
+      setLoading(false)
+      return
+    }
+
+    // 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 +271,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 +285,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 +311,9 @@ export function useGitHubData({
     checkMilestones, // Artık stable
     onDataUpdate,
     onError,
+    isDocsMode,
+    mockDataFallback,
+    forceMockData,
   ])
 
   // Initial fetch
@@ -266,7 +334,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 +351,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 +368,7 @@ export function useGitHubData({
     
     clearCache()
     return fetchData()
-  }, [fetchData])
+  }, [fetchData, isDocsMode])
 
   return {
     repos,
@@ -372,4 +447,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

@@ -24,6 +24,7 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
   repository,
   repositories,
   token,
+  useMockData = false,
   variant = "card",
   layout = "grid",
   showDescription = true,
@@ -60,7 +61,24 @@ const GitHubStarsInternal: React.FC<GitHubStarsProps> = ({
   size = "md",
   customColors,
 }) => {
-  const { notify } = useGitHubNotifications(enableNotifications)
+  // Docs mode tespiti
+  // Check if component has valid props to render
+  const hasValidProps = useMockData || username || (repositories && repositories.length > 0)
+  
+  // If useMockData is false and no valid data props, don't render
+  if (!useMockData && !hasValidProps) {
+    return null
+  }
+
+  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 +114,17 @@ 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
+    forceMockData: useMockData, // Force mock data if true
   })
 
   const handleExport = React.useCallback((format: "json" | "csv") => {
@@ -296,8 +317,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 +326,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>
   )
 }

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

@@ -83,6 +83,7 @@ export interface GitHubStarsProps {
   repository?: string // For single repo mode
   repositories?: string[] // For multiple repos
   token?: string // GitHub token for higher rate limits
+  useMockData?: boolean // Force mock data instead of API requests
   
   // Display options
   variant?: DisplayVariant