From edb0f0afc6b7c24221b3e57c64cec0c067633e39 Mon Sep 17 00:00:00 2001
From: Benjamin Canac <canacb1@gmail.com>
Date: Wed, 19 Mar 2025 14:54:14 +0100
Subject: [PATCH] docs(app): improve stars lazy loading

---
 docs/app/components/SkyBg.vue    | 36 +++++++------
 docs/app/components/StarsBg.vue  | 90 +++++++++++++++++++-------------
 docs/app/pages/components.vue    |  3 +-
 docs/app/pages/index.vue         | 10 ++--
 docs/app/pages/pro/activate.vue  |  3 +-
 docs/app/pages/pro/index.vue     |  4 +-
 docs/app/pages/pro/pricing.vue   |  4 +-
 docs/app/pages/pro/templates.vue |  3 +-
 8 files changed, 88 insertions(+), 65 deletions(-)

diff --git a/docs/app/components/SkyBg.vue b/docs/app/components/SkyBg.vue
index bee52f53..4d40081c 100644
--- a/docs/app/components/SkyBg.vue
+++ b/docs/app/components/SkyBg.vue
@@ -1,4 +1,6 @@
 <script setup lang="ts">
+import { kebabCase } from 'scule'
+
 interface Star {
   x: number
   y: number
@@ -22,6 +24,8 @@ const props = withDefaults(defineProps<{
   speed: 'normal'
 })
 
+const route = useRoute()
+
 // Generate random stars
 const generateStars = (count: number): Star[] => {
   return Array.from({ length: count }, () => {
@@ -35,7 +39,7 @@ const generateStars = (count: number): Star[] => {
 }
 
 // Generate all stars
-const stars = ref<Star[]>(generateStars(props.starCount))
+const stars = useState<Star[]>(`${kebabCase(route.path)}-sky`, () => generateStars(props.starCount))
 
 // Compute twinkle animation duration based on speed
 const twinkleDuration = computed(() => {
@@ -50,22 +54,20 @@ const twinkleDuration = computed(() => {
 
 <template>
   <div class="absolute pointer-events-none z-[-1] inset-y-0 left-4 right-4 lg:right-[50%] overflow-hidden">
-    <ClientOnly>
-      <div
-        v-for="star in stars"
-        :key="star.id"
-        class="star absolute"
-        :style="{
-          'left': `${star.x}%`,
-          'top': `${star.y}%`,
-          'transform': 'translate(-50%, -50%)',
-          '--star-size': `${star.size}px`,
-          '--star-color': color,
-          '--twinkle-delay': `${star.twinkleDelay}s`,
-          '--twinkle-duration': twinkleDuration
-        }"
-      />
-    </ClientOnly>
+    <div
+      v-for="star in stars"
+      :key="star.id"
+      class="star absolute"
+      :style="{
+        'left': `${star.x}%`,
+        'top': `${star.y}%`,
+        'transform': 'translate(-50%, -50%)',
+        '--star-size': `${star.size}px`,
+        '--star-color': color,
+        '--twinkle-delay': `${star.twinkleDelay}s`,
+        '--twinkle-duration': twinkleDuration
+      }"
+    />
   </div>
 </template>
 
diff --git a/docs/app/components/StarsBg.vue b/docs/app/components/StarsBg.vue
index ba8af2ed..fbd979c4 100644
--- a/docs/app/components/StarsBg.vue
+++ b/docs/app/components/StarsBg.vue
@@ -1,4 +1,12 @@
 <script setup lang="ts">
+import { kebabCase } from 'scule'
+
+interface Star {
+  x: number
+  y: number
+  size: number
+}
+
 const props = withDefaults(defineProps<{
   starCount?: number
   color?: string
@@ -14,8 +22,10 @@ const props = withDefaults(defineProps<{
   })
 })
 
+const route = useRoute()
+
 // Generate random star positions and sizes
-const generateStars = (count: number) => {
+const generateStars = (count: number): Star[] => {
   return Array.from({ length: count }, () => ({
     x: Math.floor(Math.random() * 2000),
     y: Math.floor(Math.random() * 2000),
@@ -25,52 +35,58 @@ const generateStars = (count: number) => {
   }))
 }
 
-// Compute star layers with different speeds and opacities
-const starLayers = computed(() => {
-  const speedMap = {
-    slow: { duration: 200, opacity: 0.5 },
-    normal: { duration: 150, opacity: 0.75 },
-    fast: { duration: 100, opacity: 1 }
-  }
+// Define speed configurations once
+const speedMap = {
+  slow: { duration: 200, opacity: 0.5, ratio: 0.3 },
+  normal: { duration: 150, opacity: 0.75, ratio: 0.3 },
+  fast: { duration: 100, opacity: 1, ratio: 0.4 }
+}
 
-  return [
-    { stars: generateStars(props.starCount), ...speedMap.fast },
-    { stars: generateStars(Math.floor(props.starCount * 0.6)), ...speedMap.normal },
-    { stars: generateStars(Math.floor(props.starCount * 0.3)), ...speedMap.slow }
-  ]
+// Use a more efficient approach to generate and store stars
+const stars = useState<{ slow: Star[], normal: Star[], fast: Star[] }>(`${kebabCase(route.path)}-stars`, () => {
+  return {
+    slow: generateStars(Math.floor(props.starCount * speedMap.slow.ratio)),
+    normal: generateStars(Math.floor(props.starCount * speedMap.normal.ratio)),
+    fast: generateStars(Math.floor(props.starCount * speedMap.fast.ratio))
+  }
 })
+
+// Compute star layers with different speeds and opacities
+const starLayers = computed(() => [
+  { stars: stars.value.fast, ...speedMap.fast },
+  { stars: stars.value.normal, ...speedMap.normal },
+  { stars: stars.value.slow, ...speedMap.slow }
+])
 </script>
 
 <template>
   <div class="absolute pointer-events-none z-[-1] inset-y-0 inset-x-5 sm:inset-x-7 lg:inset-x-9 overflow-hidden">
-    <ClientOnly>
-      <div class="stars size-full absolute inset-x-0 top-0">
+    <div class="stars size-full absolute inset-x-0 top-0">
+      <div
+        v-for="(layer, index) in starLayers"
+        :key="index"
+        class="star-layer"
+        :style="{
+          '--star-duration': `${layer.duration}s`,
+          '--star-opacity': layer.opacity,
+          '--star-color': color
+        }"
+      >
         <div
-          v-for="(layer, index) in starLayers"
-          :key="index"
-          class="star-layer"
+          v-for="(star, starIndex) in layer.stars"
+          :key="starIndex"
+          class="star absolute rounded-full"
           :style="{
-            '--star-duration': `${layer.duration}s`,
-            '--star-opacity': layer.opacity,
-            '--star-color': color
+            left: `${star.x}px`,
+            top: `${star.y}px`,
+            width: `${star.size}px`,
+            height: `${star.size}px`,
+            backgroundColor: 'var(--star-color)',
+            opacity: 'var(--star-opacity)'
           }"
-        >
-          <div
-            v-for="(star, starIndex) in layer.stars"
-            :key="starIndex"
-            class="star absolute rounded-full"
-            :style="{
-              left: `${star.x}px`,
-              top: `${star.y}px`,
-              width: `${star.size}px`,
-              height: `${star.size}px`,
-              backgroundColor: 'var(--star-color)',
-              opacity: 'var(--star-opacity)'
-            }"
-          />
-        </div>
+        />
       </div>
-    </ClientOnly>
+    </div>
   </div>
 </template>
 
diff --git a/docs/app/pages/components.vue b/docs/app/pages/components.vue
index ea002196..8914ad66 100644
--- a/docs/app/pages/components.vue
+++ b/docs/app/pages/components.vue
@@ -119,7 +119,8 @@ onMounted(() => {
         />
       </template>
 
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
+
       <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
     </UPageHero>
 
diff --git a/docs/app/pages/index.vue b/docs/app/pages/index.vue
index 9ae38525..f1409b34 100644
--- a/docs/app/pages/index.vue
+++ b/docs/app/pages/index.vue
@@ -85,7 +85,7 @@ useIntersectionObserver(contributorsRef, ([entry]) => {
         </div>
       </template>
 
-      <SkyBg />
+      <LazySkyBg hydrate-never />
 
       <div class="h-[344px] lg:h-full lg:relative w-full lg:min-h-[calc(100vh-var(--ui-header-height)-1px)] overflow-hidden">
         <UPageMarquee
@@ -93,7 +93,7 @@ useIntersectionObserver(contributorsRef, ([entry]) => {
           :overlay="false"
           :ui="{
             root: '[--gap:--spacing(4)] [--duration:40s] border-(--ui-border) absolute w-full left-0 border-y lg:border-x lg:border-y-0 lg:w-[calc(50%-6px)] 2xl:w-[320px] lg:flex-col',
-            content: 'lg:w-auto lg:h-full lg:flex-col lg:animate-[marquee-vertical_var(--duration)_linear_infinite] lg:rtl:animate-[marquee-vertical-rtl_var(--duration)_linear_infinite] lg:h-[fit-content]'
+            content: 'lg:w-auto lg:flex-col lg:animate-[marquee-vertical_var(--duration)_linear_infinite] lg:rtl:animate-[marquee-vertical-rtl_var(--duration)_linear_infinite] lg:h-[fit-content]'
           }"
         >
           <ULink
@@ -118,7 +118,7 @@ useIntersectionObserver(contributorsRef, ([entry]) => {
           :overlay="false"
           :ui="{
             root: '[--gap:--spacing(4)] [--duration:40s] border-(--ui-border) absolute w-full mt-[180px] left-0 border-y lg:mt-auto lg:left-auto lg:border-y-0 lg:border-x lg:w-[calc(50%-6px)] 2xl:w-[320px] lg:right-0 lg:flex-col',
-            content: 'lg:w-auto lg:h-full lg:flex-col lg:animate-[marquee-vertical_var(--duration)_linear_infinite] lg:rtl:animate-[marquee-vertical-rtl_var(--duration)_linear_infinite] lg:h-[fit-content] lg:[animation-direction:reverse]'
+            content: 'lg:w-auto lg:flex-col lg:animate-[marquee-vertical_var(--duration)_linear_infinite] lg:rtl:animate-[marquee-vertical-rtl_var(--duration)_linear_infinite] lg:h-[fit-content] lg:[animation-direction:reverse]'
           }"
         >
           <ULink
@@ -241,7 +241,7 @@ useIntersectionObserver(contributorsRef, ([entry]) => {
       </template>
 
       <div ref="contributorsRef" class="p-4 sm:px-6 md:px-8 lg:px-12 xl:px-14 overflow-hidden flex relative">
-        <LazyHomeContributors :contributors="module?.contributors" :paused="!isContributorsInView || isContributorsHovered" />
+        <LazyHomeContributors :contributors="module?.contributors" :paused="!isContributorsInView || isContributorsHovered" hydrate-never />
       </div>
     </UPageSection>
 
@@ -261,7 +261,7 @@ useIntersectionObserver(contributorsRef, ([entry]) => {
         </UButton>
       </template>
 
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
 
       <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
       <div class="relative h-[400px] border border-(--ui-border) bg-(--ui-bg-muted) overflow-hidden border-x-0 -mx-4 sm:-mx-6 lg:mx-0 lg:border-x w-screen lg:w-full">
diff --git a/docs/app/pages/pro/activate.vue b/docs/app/pages/pro/activate.vue
index 6d1ab316..2cc9521a 100644
--- a/docs/app/pages/pro/activate.vue
+++ b/docs/app/pages/pro/activate.vue
@@ -71,7 +71,8 @@ onMounted(() => {
 <template>
   <UMain>
     <UPageHero headline="License Activation" :title="title" :description="description" :ui="{ container: 'relative overflow-hidden', wrapper: 'lg:px-12', description: 'text-pretty' }">
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
+
       <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
 
       <div class="px-4 py-10 lg:border border-(--ui-border) bg-(--ui-bg)">
diff --git a/docs/app/pages/pro/index.vue b/docs/app/pages/pro/index.vue
index d3c2eaae..f1426446 100644
--- a/docs/app/pages/pro/index.vue
+++ b/docs/app/pages/pro/index.vue
@@ -32,7 +32,7 @@ useSeoMeta({
         <MDC :value="page.hero.description" tag="span" unwrap="p" cache-key="pro-hero-description" />
       </template>
 
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
 
       <Motion as-child :initial="{ height: 0 }" :animate="{ height: 'auto' }" :transition="{ delay: 0.2, duration: 1 }">
         <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
@@ -196,7 +196,7 @@ useSeoMeta({
       class="overflow-hidden"
       orientation="horizontal"
     >
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
 
       <video
         class="rounded-[var(--ui-radius)] z-10"
diff --git a/docs/app/pages/pro/pricing.vue b/docs/app/pages/pro/pricing.vue
index 62cb1a8a..09299eb7 100644
--- a/docs/app/pages/pro/pricing.vue
+++ b/docs/app/pages/pro/pricing.vue
@@ -27,8 +27,10 @@ useSeoMeta({
         <MDC :value="page.pricing.title" unwrap="p" cache-key="pro-pricing-title" />
       </template>
 
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
+
       <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
+
       <div class="flex flex-col bg-(--ui-bg) gap-8 lg:gap-0">
         <UPricingPlan
           v-bind="page.pricing.freePlan"
diff --git a/docs/app/pages/pro/templates.vue b/docs/app/pages/pro/templates.vue
index 07d7ba29..da4d480d 100644
--- a/docs/app/pages/pro/templates.vue
+++ b/docs/app/pages/pro/templates.vue
@@ -18,7 +18,8 @@ useSeoMeta({
 <template>
   <div class="relative">
     <UPageHero :links="page.links" :ui="{ container: 'relative' }">
-      <StarsBg />
+      <LazyStarsBg hydrate-never />
+
       <div aria-hidden="true" class="hidden lg:block absolute z-[-1] border-x border-(--ui-border) inset-0 mx-4 sm:mx-6 lg:mx-8" />
 
       <template #title>